jBPM 用户指南(2)

作者：jBPM组

版本：5.0.0

原文版权归作者所有，该翻译稿仅供学习交流使用，引用或转载请保证该部分的完整

 

 

章节2安装

 

 

2.1先决条件

2.2下载安装程序

2.3安装演示

2.4Eclipse工具

2.5使用Web管理控制台

2.6Guvnor库

2.7技术支持

2.8FAQ

 

本指南将演示jBPM项目中各组件的安装过程。如果你有任何意见建议或者碰到任何问题，请按下面小节中提到的方式与jBPM社区联系。

 

2.1先决条件

 

使用jBPM需要先安装Java JDK 1.5+(并且设置JAVA_HOME环境变量)，以及Ant 1.7+。如果还没有的话可以用以下链接下载、安装。

 

Java: http://java.sun.com/javase/downloads/index.jsp

 

Ant: http://ant.apache.org/bindownload.cgi

 

2.2下载安装程序

 

第一步是下载安装程序:jBPM-{version}-install.zip。

快照:

http://hudson.jboss.org/hudson/job/jBPM5/lastSuccessfulBuild/artifact/target/(该链接失效)。

 

2.3安装演示

 

安装该演示最简单的办件是运行安装脚本。在安装目录运行：

 

ant install.demo

 

该脚本包括：

• 下载JBoss AS
• 下载Eclipse
• 将Drools Guvnor安装到JBoss AS
• 将Oryx设计器安装到JBoss AS
• 将jBPM gwt-console安装到JBoss AS
• 安装jBPM Eclipse插件
• 安装Drools Eclipse插件

这里需要花费一些时间(毕竟要下载一个应用服务器以及Eclipse的安装程序)，脚本会显示下载的进度。如果你不想下载某些组件，可以跳过它。

 

完成之后就可以启动了：

 

ant start.demo

 

这个操作将启动以下程序：

• H2数据库
• JBoss AS
• Eclipse
• 人工任务服务(Human Task Service)

万事具备之后，就可以按后面小节中提到的操作Eclipse工具，Guvnor及gwt-console了。

 

2.4 使用Eclipse工具

 

这里的一段屏幕录像显示了如何在Eclipse中运行一个简单的演示流程，包括：

• 如何在工作区中导入一个已经存在的示例项目
  • 一个请求性能评估的BPMN2流程
  • 启动流程的Java类
• 如何运行流程

打开Eclipse，简单的导入(使用"File->Import..."，在General目录中选择"Existing Project into Workspace")已经存在的示例项目(在jbpm-installer/sample/evalution目录中)。添加的项目中包括一个简单的BPMN2流程及一个启动流程的Java文件。双击打开BPMN2流程。要执行流程的话，右击com.sample包中的ProcessTest.java，选择"Run As - Java Application"。启动流程之后会在人工任务服务中"krisv"用户下创建一项新的任务，而流程会停在那里等待调度执行。稍后我们将告诉你如果在诸如jbpm-console之类的客户端中完成该项任务。

 

你也可以用jBPM项目向导创建一个新的流程，该向导将创建一个简单的HelloWorld BPMN2流程及与之相关的用于启动流程的Java类文件。步骤是选择"File-New...-Project"，在jBPM目录中选择"jBPM Project"然后点击"Next"，给项目命名，最后点击"Finish"。新的项目包括一个"sample.bpmn"流程及一个"com.sample.ProcessTest"Java类。双击流程文件可以打开它。要执行流程可以在ProcessTest.java文件上点击右键，选择"Run As - Java Application"。可以在输出控制台中看到"Hello World"字样。

 

2.5使用Web管理控制台

 

 从下面的地址打开流程的管理控制台

 

http://localhost:8080/jbpm-console

 

用krisv/krisv作为用户名及口令登录。下面这段屏幕录像显示了流程实例管理的大致操作：

• 如何启动新流程
• 如何查看正在运行的流程实例的当前状态
• 查找任务
• 完成任务
• 生成流程调度的监控报告

选择"Process"标签,再选择"Process Overview"栏。稍等片刻(首次调度应用程序需要执行会话初始化等操作)，"Process"列表会显示全部的流程定义。演示示例中的jbpm-console会加载"jbpm-installer/sample/evaluation"例子"src/main/resources"目录下的全部流程。选择某一流程，就会显示该流程对应的实例。当前没有任何正在运行的流程实例，所以"Instance"表是空的。

 

点击"Start"按钮可以启动新的流程实例，在随后出现的流程表单中输入必要的信息。此处你需要输入用户名"krisv"，然后完成表单并关闭窗口。在"Instance"表中就会显示这个新建的实例。点击实例可以查看细节信息，选择"Diagram"查看流程图，选择"Instance Data"查看实例数据。该流程实例将停在"自评(self-evaluation)"节点直到该任务完成。

 

选择"Tasks"标签并点击"Personal Tasks"可查看指派给自己的任务(点击刷新按钮可更新任务视图)。在个人任务列表中会显示一项"Performance Evaluation"任务，选中并点击"View"按钮，会打开一个任务表单，输入必要的数据，完成表单关闭窗体。任务完成之后再次点击"Process Overview"查看实例的进度，你会发现现在实例处于等待HR经理及项目经理执行评估的状态。你可以分别用"john/john"，"mary/mary"帐号登录并完成这些任务。

 

在启动并完成若干流程实例之后，可以生成一个报表查看具体情况。在"Reporting"下面选择"Report Templates"。默认情况下，控制台带了两个报表模板，一个用于查看全部流程实例，另一个查看某一流程类型。如果你选了后者，需要输入"com.sample.evaluation"作为流程定义标识查看该评估流程的相关活动(Activity)信息。点击"Create Report"按钮生成一份当前状态的实时报告。初化表报告需要花费一些时间，特别是在应用程序首次运行的情况下。

 

2.6Guvnor库

 

Guvnor库(respository)作为一个业务流程的存储库使用。它提供了Web方式的接口管理流程，还包括一个Web方式的编辑器用于查看、更新流程。

 

从以下地址打开Drools Guvnor:

 

http://localhost:8080/drools-guvnor

 

用空的用户名及口令登录(因为演示的目的未启用认证机制) 。这里的一段屏幕录像显示了如何对库进行管理，包括：

• 如何从Eclipse中导入已经存在的流程(譬如说前面提到的评估流程)到Gunvor中
• 如何在web编辑器中打开流程
• 如何建一个可用来创建会话的包

如果你想了解Guvnor的更多情况，推荐你看一下Drools Gunvor的文档。

 

最后是结束演示

 

ant stop.demo

 

2.7技术支持

 

可以跟jBPM社区联系以获得帮助

 

Email: [e-mail]

 

IRC: #jbpm at irc.codehaus.org

 

jBPM User Forum

 

2.8 FAQ

 

一些常见问题解释如下：

 

Q:安装程序下载不了组件

A:是否已连接到internet，是否启用了防火墙，是否需要代理？也有可能用来下载组件的地址暂时处于离线状态。可以手动从一个替代位置下载组件然后放置到jbpm-installer/lib目录中。

 

Q:安装程序无些解压一些jar/war/zip

A:安装程序正在试着安装下载不完整的文件。从jbpm-installer/lib 目录中删除这些有问题的文件然后重新安装，将再次下载这些文件。

 

Q:如何重新安装

A:使用clean.demo清除所有已安装组件。

 

Q:如何解决在停止或者重启某些服务时碰到的问题

A:看看是否在关闭服务时服务还在继续运行？是否在重启时早上启动的服务没有正常关闭？如果必要的话手动杀死这些服务。

 

Q:如何解决在运行Eclipse时发生的一些问题

A:看看控制台输出的错误日志或者堆栈跟踪。也可以检查Eclipse的错误日志。试着添加审核日志找出在运行时发生了什么，或者调试你的应用程序。

 

Q:如何解决运行像jbpm-console,Gunvor或者设计器之类的web应用程序时发生的问题

A:查看jbpm-installer/jboss-4.2.3.GA/server/default/log目录下的服务日志，查找可能的错误。

 

其他的问题可以在jBPM社区中查找。