Activiti实战. 2.5Activiti Explorer

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。