OpenCms621-jBPM312模塊使用手冊-朗華世.doc

JBPM模塊使用手冊北京朗華世紀科技發(fā)展有限公司2006年10月第一章 安裝本章介紹如何將JBPM安裝到OpenCms中，該版本目前測試通過的環(huán)境是Tomcat5.5.x,MySQL4.1.x,OpenCms6.2.x。1. 確認系統(tǒng)已安裝cn.langhua.opencms.jbpm_2.0.x.zip模塊。確認的方法是打開模塊管理，檢查是否有“包名稱”為cn.langhua.opencms.jbpm_2.0.x.zip的模塊。如果有，那么可以進入下一步。如果沒有，請向北京朗華世紀科技發(fā)展有限公司索取該模塊，并安裝到系統(tǒng)中，安裝完畢以后請重啟服務。注意：導入模塊的時候，請在根站點下導入。2. 修改Tomcat配置1. 拷貝與所使用的數據庫相匹配的JDBC驅動至tomcat_homecommonlib目錄下,這里以MySQL4.1.x為例子,需要拷貝mysql-connector-java-3.1.12-bin.jar文件至tomcat_homecommonlib。2. 定義數據源。以下是以MySQL4.1x為例的修改：tomcat_homeconfcontext.xml文件，如沒有該文件請手動創(chuàng)建。文件內容如下： 技巧: 如果使用其它數據源名稱，你還要修改/system/modules/cn.langhua.opencms.jbpm/classes/下的hibernate.cfg.xml中的數據源設置。3 修改WEB-INF目錄下的web.xml文件。文件內容如下： 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. 數據庫3.1 創(chuàng)建數據庫進入數據庫,手動創(chuàng)建名成為”jbpm”的數據庫。3.2 建數據庫表登錄到OpenCms后臺，進入“管理”視圖， 為JBPM的管理按鈕，點擊進入會看到JBPM的管理視圖： 使用“創(chuàng)建數據庫表”按鈕，創(chuàng)建數據庫表。數據庫表創(chuàng)建成功，JBPM安裝完成。3.3 導入流程這里以導入流程定義文件的形式來增加各種不同的流程,流程定義文件的后綴為“*.process”。通過JBPM管理視圖里的來上傳流程定義文件“cess”?！癱ess”這個文件在/system/modules/cn.langhua.opencms.jbpm/docs/目錄下。用“瀏覽”按鈕來找到存放在本地磁盤上的流程定義文件“cess”，點擊確定上傳。上傳成功后，能在“新建工作流”中的“流程名稱”下拉菜單中看到上傳的流程名稱，如圖：第二章 使用本章主要以“websale”來介紹JBPM的使用。1. 操作界面介紹進入JBPM的管理視圖后用戶將看到屬于自己操作范圍的流程，如圖： 終止工作流實例。直接將整個流程停止，請慎用該功能。 顯示流程圖。查看該工作流的流程圖。圖中用紅色線條框起來的為現(xiàn)在流程所處的位置。圖四： 工作流的流程圖點擊流程的流程名稱，能查看流程的詳細信息。點擊流程的步驟名稱進入該步流程操作的操作界面。2. 新建流程進入JBPM的管理視圖選擇按鈕進行新建：在“流程名稱”的下拉菜單中選擇“websale”，點擊確定，流程創(chuàng)建成功。3. 流程說明在JBPM工作流中以單個數據項為資源，可以在不同步驟限制每個數據項資源的可見，可讀，可寫根據用戶進行控制，這樣在工作流的流轉中能很好的控制每個用戶在每一步所需要填寫或者驗證的數據項。以websale流程為例：在流程的第一步create new web sale order中，用戶可以填寫item，quantity和address三個數據項，如圖：當提交到下一步evaluate web order后，用戶將只能看到上一步中填寫的item，quantity和address三個數據項而不能修改，同時又出現(xiàn)了comment數據項讓其填寫，如圖：繼續(xù)本流程直至結束。附件：Websale流程的流程定義文件processdefinition.xml內容： /* * 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/modu