OBE用户指南（中文版）

OBE用户指南（中文版）

宏云翻译,Cygnet开源工作流组

2005-3-29

1 简介

OBE是Open Business Engine的简称，它是一个支持WfMC工作流规范的开源Java工作流引擎，包括接口1（XPDL），接口2/3（WAPI）以及接口5（审查）。接口4在开发中，将包含在最终的版本中。

OBE提供一个在可控、集成的环境中执行各种活动的环境。OBE支持工作流的同步和异步执行。最初的OBE实现基于J2EE，设计在J2EE容器中，如JBoss或者Weblogic中。OBE使用了EJB Session Bean和EJB Entity Bean和消息驱动Bean，是一个强大的工作流引擎。

2 开始

要开始使用OBE，首先你需要在J2EE容器中安装一个obeserver.ear文件。如果你不熟悉J2EE容器，那么我们建议你访问jboss.org并下载JBoss server。要在JBoss 3.0.4中安装OBE，拷贝obeserver.ear文件和obe-jbossmq-destinations-service.xml文件到server/default/deploy目录。

    你也要使用obe/lib目录下面castor.jar的补丁版本替换位于server/default/lib目录下面的当前castor.jar文件。拷贝castor- 0.9.4.3-patched-xml.jar文件到server/default/lib目录，并且删除当前的castor.jar文件。接下来，执行bin目录下的run脚本文件启动Jboss。

如果你是第一次运行OBE，你需要安装你的数据库表。如果你正在使用Jboss附带的Hypersonic数据库，那么你或者拷贝hsqldb-ddl.sql中的文本，把它附加到server/default/db/hypersonic/default.script中，或者你执行dbsetup命令。请注意default.script文件的确切位置决定于你正在使用的Jboss的版本。上述路径只在Jboss 3.0.4 N.B.中是正确的。在最新Jboss版本中，这表现为classloader问题，这一版本不允许进行上述配置。

一旦OBE安装到一个J2EE服务器中，你需要使用OBEWorklist工具与服务器进程进行通讯。可以使用命令java -jar obeworklist.jar来启动OBE命令行Worklist工具。一旦命令行工具运行起来，你需要把协议转变为rmi，并且输入主机名、用户名和密码。如果你在同一台机器上使用JBoss，主机名可以为localhost，用户名和密码为sa.

提示：如果你想列出进程定义或者进程实例，并希望及时收到工作流错误信息，那么你要确认已经按照上述步骤配置你的应用服务器。你的数据库没有由default.script文件创建的表，这种可能性是存在的。

一旦连接上服务器，你需要输入XPDL格式的工作流定义。OBE发布版本中包括几个工作流定义的例子，你可以从它们开始做起，这些例子可以在examples目录中找到。

在输入一个或者多个工作流定义之后，你需要创建一个或者多个工作流进程实例，并利用命令行工具来启动这些进程。接下来你可以使用命令行工具来查看每一个进程，活动和工作项。

2.1 XPDL

OBE工作流的定义使用XPDL文档。XPDL代表eXtensible Process Definition Language，它的实现是一个XML文档。XPDL在WfMC接口1规范中定义。现在你需要使用一个文本编辑器或者一些其他的第三方工具来创建XPDL文档。一个图形设计器正在开发