OpenCms621-jBPM312模块使用手册-朗华世

JBPM模块使用手册北京朗华世纪科技发展有限公司www.langhua.cn2006年10月第1章安装本章介绍如何将JBPM安装到OpenCms中，该版本目前测试通过的环境是Tomcat5.5.x,MySQL4.1.x,OpenCms6.2.x。1.确认系统已安装cn.langhua.opencms.jbpm_2.0.x.zip模块。确认的方法是打开模块管理，检查是否有“包名称”为cn.langhua.opencms.jbpm_2.0.x.zip的模块。如果有，那么可以进入下一步。如果没有，请向北京朗华世纪科技发展有限公司索取该模块，并安装到系统中，安装完毕以后请重启服务。注意：导入模块的时候，请在根站点下导入。2.修改Tomcat配置1.拷贝与所使用的数据库相匹配的JDBC驱动至{tomcat_home}\common\lib\目录下,这里以MySQL4.1.x为例子,需要拷贝mysql-connector-java-3.1.12-bin.jar文件至{tomcat_home}\common\lib。2.定义数据源。以下是以MySQL4.1x为例的修改：{tomcat_home}\conf\context.xml文件，如没有该文件请手动创建。文件 内容 财务内部控制制度的内容财务内部控制制度的内容人员招聘与配置的内容项目成本控制的内容消防安全演练内容 如下： <Context><Resourcename="JbpmDS"auth="Container"type="javax.sql.DataSource"maxActive="5"maxIdle="3"maxWait="2000"username="***"password="***"driverClassName="com.mysql.jdbc.Driver"url="jdbc:mysql://localhost:3306/Jbpm?autoReconnect=true"/></Context>技巧:如果使用其它数据源名称，你还要修改/system/modules/cn.langhua.opencms.jbpm/classes/下的hibernate.cfg.xml中的数据源设置。3．修改WEB-INF目录下的web.xml文件。文件内容如下： <?xmlversion="1.0"encoding="ISO-8859-1"?><!DOCTYPEweb-appPUBLIC"-//SunMicrosystems,Inc.//DTDWebApplication2.3//EN""http://java.sun.com/dtd/web-app_2_3.dtd"><web-app><display-name>OpenCms</display-name><description>OpenCms,theOpenSourceContentManagementSystem.(c)2005AlkaconSoftwareGmbHwithcontributionsfromtheOpenCmscommunity.FormoredetailsaboutOpenCms,pleaseseehttp://www.opencms.org/.FormoredetailsaboutAlkaconSoftwareGmbH,pleaseseehttp://www.alkacon.com/.</description><!--Changingtheservletnamefrom"opencms"tosomethingelserequires3changesinthisfile.Forexample,tochangetheservletnameto"mycms"youmust:1.Changethe<context-param>called"OpenCmsServlet"from"/opencms/*"to"/mycms/*"2.Changethe<servlet-mapping>for"OpenCmsServlet"from"/opencms/*"to"/mycms/*"3.Changethe<error-page>settingforthe404errorfrom"/opencms/handle404"to"/mycms/handle404"--><context-param><param-name>OpenCmsServlet</param-name><param-value>/cms/*</param-value></context-param><context-param><param-name>DefaultWebApplication</param-name><param-value>ROOT</param-value></context-param><filter><filter-name>LogFilter</filter-name><filter-class>org.jbpm.webapp.filter.LogFilter</filter-class></filter><filter><filter-name>JbpmContextFilter</filter-name><filter-class>org.jbpm.web.JbpmContextFilter</filter-class></filter><filter-mapping><filter-name>LogFilter</filter-name><url-pattern>/*</url-pattern></filter-mapping><filter-mapping><filter-name>JbpmContextFilter</filter-name><url-pattern>/*</url-pattern></filter-mapping><!--Uncommentthisparameterincaseyouchangethewebapplicationcontextusinganapplicationserverspecificdeploymentdescriptor.E.g.inJboss,youcouldusethejboss-web.xmlfiletodeployopencmsunderthecontext'myopencms'butstillkeepthefilesinthefolder'opencms.war'<context-param><param-name>WebApplicationContext</param-name><param-value>myopencms</param-value></context-param>--><listener><listener-class>org.opencms.main.OpenCmsListener</listener-class></listener><servlet><servlet-name>OpenCmsServlet</servlet-name><description>ThemainservletthathandlesallrequeststotheOpenCmsVFS.</description><servlet-class>org.opencms.main.OpenCmsServlet</servlet-class><load-on-startup>1</load-on-startup></servlet><servlet><servlet-name>OpenCmsServletErrorHandler</servlet-name><description>Theerrorhandlingservlet,alsoserversastriggerforstaticexportrequests.</description><servlet-class>org.opencms.main.OpenCmsServletErrorHandler</servlet-class><load-on-startup>0</load-on-startup></servlet><servlet-mapping><servlet-name>OpenCmsServlet</servlet-name><url-pattern>/cms/*</url-pattern></servlet-mapping><servlet-mapping><servlet-name>OpenCmsServletErrorHandler</servlet-name><url-pattern>/opencms-errorhandler/*</url-pattern></servlet-mapping><!--JbpmThreadsServlet--><servlet><servlet-name>JbpmThreadsServlet</servlet-name><servlet-class>org.jbpm.web.JbpmThreadsServlet</servlet-class><load-on-startup>1</load-on-startup></servlet><servlet-mapping><servlet-name>JbpmThreadsServlet</servlet-name><url-pattern>/threads</url-pattern></servlet-mapping><!--jBPMFileServlet--><servlet><servlet-name>ProcessImageServlet</servlet-name><servlet-class>org.jbpm.webapp.servlet.ProcessImageServlet</servlet-class></servlet><servlet-mapping><servlet-name>ProcessImageServlet</servlet-name><url-pattern>/processimage</url-pattern></servlet-mapping><session-config><session-timeout>30</session-timeout></session-config><welcome-file-list><welcome-file>index.jsp</welcome-file><welcome-file>index.html</welcome-file><welcome-file>index_export.html</welcome-file></welcome-file-list><error-page><error-code>404</error-code><location>/opencms-errorhandler/handle404</location></error-page><error-page><error-code>500</error-code><location>/opencms-errorhandler/system/handler/handle500.html</location></error-page><taglib><taglib-uri>http://www.opencms.org/taglib/cms</taglib-uri><taglib-location>/WEB-INF/opencms.tld</taglib-location></taglib></web-app>修改完重启Tomcat后修改生效。3.数据库3.1创建数据库进入数据库,手动创建名成为”jbpm”的数据库。3.2建数据库表登录到OpenCms后台，进入“管理”视图，为JBPM的管理按钮，点击进入会看到JBPM的管理视图：使用“创建数据库表”按钮，创建数据库表。数据库表创建成功，JBPM安装完成。3.3导入流程这里以导入流程定义文件的形式来增加各种不同的流程,流程定义文件的后缀为“*.process”。通过JBPM管理视图里的来上传流程定义文件“websale.process”。“websale.process”这个文件在/system/modules/cn.langhua.opencms.jbpm/docs/目录下。用“浏览”按钮来找到存放在本地磁盘上的流程定义文件“websale.process”，点击确定上传。上传成功后，能在“新建工作流”中的“流程名称”下拉菜单中看到上传的流程名称，如图：第2章使用本章主要以“websale”来介绍JBPM的使用。1.操作界面介绍进入JBPM的管理视图后用户将看到属于自己操作范围的流程，如图：·终止工作流实例。直接将整个流程停止，请慎用该功能。·显示流程图。查看该工作流的流程图。图中用红色线条框起来的为现在流程所处的位置。图四：工作流的流程图点击流程的流程名称，能查看流程的详细信息。点击流程的步骤名称进入该步流程操作的操作界面。2.新建流程进入JBPM的管理视图选择按钮进行新建：在“流程名称”的下拉菜单中选择“websale”，点击确定，流程创建成功。3.流程说明在JBPM工作流中以单个数据项为资源，可以在不同步骤限制每个数据项资源的可见，可读，可写根据用户进行控制，这样在工作流的流转中能很好的控制每个用户在每一步所需要填写或者验证的数据项。以websale流程为例：在流程的第一步createnewwebsaleorder中，用户可以填写item，quantity和address三个数据项，如图：当提交到下一步evaluateweborder后，用户将只能看到上一步中填写的item，quantity和address三个数据项而不能修改，同时又出现了comment数据项让其填写，如图：继续本流程直至结束。附件：Websale流程的流程定义文件processdefinition.xml内容： <?xmlversion="1.0"?><process-definitionname="websale"xmlns="urn:jbpm.org:jpdl-3.1"><!--SWIMLANES(=processroles)--><swimlanename="buyer"/><swimlanename="salesman"><assignmentexpression="user(ernie)"/></swimlane><swimlanename="accountant"><assignmentexpression="user(bert)"/></swimlane><swimlanename="shipper"><assignmentexpression="user(grover)"/></swimlane><!--NODES--><start-statename="createnewwebsaleorder"><taskswimlane="buyer"><controller><variablename="//Websales/Websale/item"/><variablename="//Websales/Websale/quantity"/><variablename="//Websales/Websale/address"/></controller></task><eventtype="task-create"><script><expression>/***Convention：*Dataformatisdefinedin/system/modules/cn.langhua.opencms.jbpm/schemas/config.xsd**Note:conmmentmustbelessthan255charactors.*/token.addComment("rootpath=/sites/default/jbpm/");token.addComment("Websales=schema:/system/modules/cn.langhua.opencms.jbpm/schemas/websale.xsd|folder:websale/|fileprefix:websale-");</expression></script></event><transitionto="evaluateweborder"/></start-state><task-nodename="evaluateweborder"><taskswimlane="salesman"><timerduedate="20seconds"repeat="10seconds"><actionclass="org.jbpm.websale.RemindActor"><swimlaneName>salesman</swimlaneName></action></timer><controller><variablename="//Websales/Websale/item"access="read"/><variablename="//Websales/Websale/quantity"access="read"/><variablename="//Websales/Websale/address"access="read"/><variablename="//Websales/Websale/comment"/></controller></task><transitionname="ok"to="salefork"/><transitionname="moreinfoneeded"to="fixweborderdata"/></task-node><task-nodename="fixweborderdata"><taskswimlane="buyer"><controller><variablename="//Websales/Websale/comment"access="read"/><variablename="//Websales/Websale/item"/><variablename="//Websales/Websale/quantity"/><variablename="//Websales/Websale/address"/></controller></task><transitionto="evaluateweborder"/></task-node><forkname="salefork"><transitionname="//Websales/Websale/payment"to="waitformoney"/><transitionname="//Websales/Websale/shipping"to="shipitem"/></fork><task-nodename="waitformoney"><taskswimlane="accountant"><controller><variablename="//Websales/Websale/item"access="read"/><variablename="//Websales/Websale/quantity"access="read"/><variablename="//Websales/Websale/address"access="read"/><variablename="//Websales/Websale/moneyreceived"/></controller></task><transitionto="updatebooks"/></task-node><nodename="updatebooks"><actionclass="org.jbpm.websale.UpdateBooks"><msg>accountancyapplicationisnowinformedofthepayment</msg></action><transitionto="salejoin"/></node><nodename="shipitem"><actionclass="org.jbpm.websale.ShipItem"><swimlaneName>shipper</swimlaneName><msg>${shipper}nowships${item}to${address}</msg></action><transitionto="salejoin"/></node><joinname="salejoin"><transitionto="end"/></join><end-statename="end"/></process-definition>