OpenCms621-jBPM312模塊使用手冊(cè)-朗華世.doc

JBPM模塊使用手冊(cè)北京朗華世紀(jì)科技發(fā)展有限公司2006年10月第一章 安裝本章介紹如何將JBPM安裝到OpenCms中，該版本目前測(cè)試通過(guò)的環(huán)境是Tomcat5.5.x,MySQL4.1.x,OpenCms6.2.x。1. 確認(rèn)系統(tǒng)已安裝cn.langhua.opencms.jbpm_2.0.x.zip模塊。確認(rèn)的方法是打開模塊管理，檢查是否有“包名稱”為cn.langhua.opencms.jbpm_2.0.x.zip的模塊。如果有，那么可以進(jìn)入下一步。如果沒(méi)有，請(qǐng)向北京朗華世紀(jì)科技發(fā)展有限公司索取該模塊，并安裝到系統(tǒng)中，安裝完畢以后請(qǐng)重啟服務(wù)。注意：導(dǎo)入模塊的時(shí)候，請(qǐng)?jiān)诟军c(diǎn)下導(dǎo)入。2. 修改Tomcat配置1. 拷貝與所使用的數(shù)據(jù)庫(kù)相匹配的JDBC驅(qū)動(dòng)至tomcat_homecommonlib目錄下,這里以MySQL4.1.x為例子,需要拷貝mysql-connector-java-3.1.12-bin.jar文件至tomcat_homecommonlib。2. 定義數(shù)據(jù)源。以下是以MySQL4.1x為例的修改：tomcat_homeconfcontext.xml文件，如沒(méi)有該文件請(qǐng)手動(dòng)創(chuàng)建。文件內(nèi)容如下： 技巧: 如果使用其它數(shù)據(jù)源名稱，你還要修改/system/modules/cn.langhua.opencms.jbpm/classes/下的hibernate.cfg.xml中的數(shù)據(jù)源設(shè)置。3 修改WEB-INF目錄下的web.xml文件。文件內(nèi)容如下： OpenCms OpenCms, the Open Source Content Management System. (c) 2005 Alkacon Software GmbH with contributions from the OpenCms community. For more details about OpenCms, please see /. For more details about Alkacon Software GmbH, please see /. !- Changing the servlet name from opencms to something else requires 3 changes in this file. For example, to change the servlet name to mycms you must: 1. Change the called OpenCmsServlet from /opencms/* to /mycms/* 2. Change the for OpenCmsServlet from /opencms/* to /mycms/* 3. Change the setting for the 404 error from /opencms/handle404 to /mycms/handle404 - OpenCmsServlet /cms/* DefaultWebApplication ROOT LogFilter org.jbpm.webapp.filter.LogFilter JbpmContextFilter org.jbpm.web.JbpmContextFilter LogFilter /* JbpmContextFilter /* !- Uncomment this parameter in case you change the web application context using an application server specific deployment descriptor. E.g. in Jboss, you could use the jboss-web.xml file to deploy opencms under the context myopencms but still keep the files in the folder opencms.war WebApplicationContext myopencms - org.opencms.main.OpenCmsListener OpenCmsServlet The main servlet that handles all requests to the OpenCms VFS. org.opencms.main.OpenCmsServlet 1 OpenCmsServletErrorHandler The error handling servlet, also servers as trigger for static export requests. org.opencms.main.OpenCmsServletErrorHandler 0 OpenCmsServlet /cms/* OpenCmsServletErrorHandler /opencms-errorhandler/* JbpmThreadsServlet org.jbpm.web.JbpmThreadsServlet 1 JbpmThreadsServlet /threads ProcessImageServlet org.jbpm.webapp.servlet.ProcessImageServlet ProcessImageServlet /processimage 30 index.jsp index.html index_export.html 404 /opencms-errorhandler/handle404 500 /opencms-errorhandler/system/handler/handle500.html /taglib/cms /WEB-INF/opencms.tld 修改完重啟Tomcat后修改生效。3. 數(shù)據(jù)庫(kù)3.1 創(chuàng)建數(shù)據(jù)庫(kù)進(jìn)入數(shù)據(jù)庫(kù),手動(dòng)創(chuàng)建名成為”jbpm”的數(shù)據(jù)庫(kù)。3.2 建數(shù)據(jù)庫(kù)表登錄到OpenCms后臺(tái)，進(jìn)入“管理”視圖， 為JBPM的管理按鈕，點(diǎn)擊進(jìn)入會(huì)看到JBPM的管理視圖： 使用“創(chuàng)建數(shù)據(jù)庫(kù)表”按鈕，創(chuàng)建數(shù)據(jù)庫(kù)表。數(shù)據(jù)庫(kù)表創(chuàng)建成功，JBPM安裝完成。3.3 導(dǎo)入流程這里以導(dǎo)入流程定義文件的形式來(lái)增加各種不同的流程,流程定義文件的后綴為“*.process”。通過(guò)JBPM管理視圖里的來(lái)上傳流程定義文件“cess”?！癱ess”這個(gè)文件在/system/modules/cn.langhua.opencms.jbpm/docs/目錄下。用“瀏覽”按鈕來(lái)找到存放在本地磁盤上的流程定義文件“cess”，點(diǎn)擊確定上傳。上傳成功后，能在“新建工作流”中的“流程名稱”下拉菜單中看到上傳的流程名稱，如圖：第二章 使用本章主要以“websale”來(lái)介紹JBPM的使用。1. 操作界面介紹進(jìn)入JBPM的管理視圖后用戶將看到屬于自己操作范圍的流程，如圖： 終止工作流實(shí)例。直接將整個(gè)流程停止，請(qǐng)慎用該功能。 顯示流程圖。查看該工作流的流程圖。圖中用紅色線條框起來(lái)的為現(xiàn)在流程所處的位置。圖四： 工作流的流程圖點(diǎn)擊流程的流程名稱，能查看流程的詳細(xì)信息。點(diǎn)擊流程的步驟名稱進(jìn)入該步流程操作的操作界面。2. 新建流程進(jìn)入JBPM的管理視圖選擇按鈕進(jìn)行新建：在“流程名稱”的下拉菜單中選擇“websale”，點(diǎn)擊確定，流程創(chuàng)建成功。3. 流程說(shuō)明在JBPM工作流中以單個(gè)數(shù)據(jù)項(xiàng)為資源，可以在不同步驟限制每個(gè)數(shù)據(jù)項(xiàng)資源的可見，可讀，可寫根據(jù)用戶進(jìn)行控制，這樣在工作流的流轉(zhuǎn)中能很好的控制每個(gè)用戶在每一步所需要填寫或者驗(yàn)證的數(shù)據(jù)項(xiàng)。以websale流程為例：在流程的第一步create new web sale order中，用戶可以填寫item，quantity和address三個(gè)數(shù)據(jù)項(xiàng)，如圖：當(dāng)提交到下一步evaluate web order后，用戶將只能看到上一步中填寫的item，quantity和address三個(gè)數(shù)據(jù)項(xiàng)而不能修改，同時(shí)又出現(xiàn)了comment數(shù)據(jù)項(xiàng)讓其填寫，如圖：繼續(xù)本流程直至結(jié)束。附件：Websale流程的流程定義文件processdefinition.xml內(nèi)容： /* * Convention： * Data format is defined in /system/modules/cn.langhua.opencms.jbpm/schemas/config.xsd * * Note: conmment must be less than 255 charactors. */ token.addComment(rootpath=/sites/default/jbpm/); token.addComment(Websales=schema:/system/modules