2.5Activiti Explorer
前面提到了Activiti Explorer是Activiti为了让开发人员快速入门所设计的一个示例程序,本节将介绍如何运行Activiti Explorer以及如何部署和处理任务。
2.5.1配置并运行Activiti Explorer
如果读者下载的是最新版本,那么直接把activiti-5.1x(5.11及之后的版本)的wars/activiti-explorer.war复制到一个干净的Tomcat的webapps目录后运行Tomcat即可。如果需要运行5.10及之前的版本,需要根据下面的步骤依次操作。不管运行哪个版本,最后启动应用的访问路径看到如图2-8所示的界面。
现在我们重新回到Activiti解压缩的目录,进入setup目录,例如笔者的Activiti解压目录是:/home/henryyan/work/sources/activiti/activiti-5.10/setup。此目录中有几个子目录和配置文件,下面依次介绍。
files:此目录中包含运行Activiti Explorer所需要的一些配置文件及Web应用,例如,Tomcat配置、数据库(H2)初始化数据、所需的jar包等。
build.db.properties:用来配置数据库信息,通过配置db属性可以使用其他的数据库,例如,MySQL、Oracle、SQL Server等。此文件中还有jdbc的配置信息,可以通过更改这几项配置来使用本地数据库。
build.properties:用过Ant的读者对此肯定很熟悉了,需要把Ant运行时的配置信息单独配置到一个文件。此文件中配置了运行时使用的Tomcat版本及自动文件存放位置。
build.xml:配置了运行、停止、清理等目标。
运行Activiti Exporer比较简单,只要使用Ant执行事先定义好的目标即可。现在通过命令进入安装目录(activiti-5.x/setup),执行命令ant demo.start即可自动构建、运行目标,并且在完成之后自动打开浏览器,访问地址为:http://localhost:8080/activiti-explorer,打开的页面如图2-8所示。
图2-8Activiti Explorer登录页面截图
2.5.2使用Activiti Explorer
1. 登录系统
在通过Ant脚本启动Activiti Explorer的过程中已经自动初始化了用户和组数据,这些数据文件位于activiti-5.x/setup/files/demo/h2.data.sql;对于5.11及之后的版本在启动Activiti Explorer的时候系统会自动执行数据初始化工具类插入初始化数据。
以拥有管理员角色的用户kermit登录系统,默认密码与用户名kermit相同。登录之后的页面如图2-9所示。
2. 部署流程
单击“Manage”栏目,然后单击“Deployments”菜单选择“Upload new”,弹出的对话框如图2-10所示。
图2-9登录Activiti Explorer之后的页面截图
图2-10在Activiti Explorer中部署流程
前面设计的流程SayHelloToLeave需要在启动流程时设置变量,而在Activiti Explorer中为了简单演示笔者采用表单(form)形式单独设计了流程定义SayHelloToLeaveForActivitiExplorer。单击“Choose a file”,然后在文件选择对话框中选择bpmn20-example/src/main/resources/me/kafeitu/activiti/helloworld/SayHelloToLeaveForActivitiExplorer.bpmn20.xml,这样Activiti Explorer会自动部署流程并跳转到流程资源查看页面。
部署流程之后单击“Process”栏目,在左侧单击“SayHelloToLeaveForActivitiExplorer”可以查看流程的图片形式,此图片由引擎自动根据xml的配置信息生成。但是很不幸我们又遇到了让人郁闷的乱码问题,如图2-11所示。
具体解决办法会在5.3.4节中详细介绍。现在可以再次部署,但是这次选择SayHelloToLeaveForActivitiExplorer.zip压缩包,这个压缩包中有两个文件:SayHelloToLeaveForActivitiExplorer.bpmn20.xml和SayHelloToLeaveForActivitiExplorer.png。
图2-11在Activiti Explorer中部署流程后的中文乱码
重新部署之后可以正常显示中文,如图2-12所示。注意划线处的Version 2,它表示同一个流程定义部署了两次,版本号自动累加。
图2-12部署SayHelloToLeaveForActivitiExplorer.zip之后中文正常显示
3. 启动流程
在“Process”栏目中单击左侧的“SayHelloToLeaveForActivitiExplore”,然后单击页面右上角的“Start process”,跳转到启动流程表单页面,如图2-13所示。
图2-13启动SayHelloToLeaveForActivitiExplorer流程页面
填写Apply User和days之后单击“Start process”按钮即可启动流程。
4. 签收与办理任务
在此流程中,节点“领导审批”被设置为Management组。当前登录用户Kermit拥有此组,所以在启动此组之后单击“Task”栏目可以看到“Queued”后面显示数字1,表示当前有需要处理的任务,如图2-14所示。
单击“Management(1)”之后显示任务办理页面,其中包含任务的名称、任务所属人及表单信息,如图2-15所示。
图2-15任务办理对话框
我们已经了解了签收与办理的过程了,现在单击“Claim”按钮之后任务归kermit所属,之后就可以审批请假请求了。在“Approval”下拉框中选择一项审批结果,如图2-16所示。
选择审批结果后单击“Complete task”即完成了任务的办理。此流程比较简单,仅一个要点是学会使用Activiti Explorer。