jBPM4.4安装部署及常见问题解决.doc

jBPM4.4安装部署文档

1. 安装JDK
2. 安装MySQL数据库
3. 安装部署ANT
a) 解压apache-ant-1.8.2-bin.zip
b) 配置环境变量：ANT_HOME、Path
4. 安装部署jBPM
a) 解压jbpm-4.4.zip
b) 将eclipse-java-helios-SR2-win32.zip、jboss-5.1.0.GA.zip拷贝到${JBPM_HOME}\install\downloads目录
c) 编辑${JBPM_HOME}\installbuild.xml
<property name="jboss.version" value="5.1.0.GA" />
<condition property="eclipse.filename"
value="eclipse-java-helios-SR2-win32.zip">
<os family="windows" />
</condition>
d) 命令行进入${JBPM_HOME}\install目录
D:\jbpm-4.4\install>ant demo.setup.jboss
5. 部署jbpm4.4的表到MySQL数据库
a) 在MySQL库中建立数据库,如:jbpmdb
b) 配置连接数据库文件
A. 确认${JBPM_HOME}\lib目录下有mysql-connector-java.jar
B. 修改${JBPM_HOME}\install\jdbc目录下的mysql.properties文件
C. 修改${JBPM_HOME}\install\build.xml文件
<property name=”database” value=”mysql” />
c) CMD命令进入${JBPM_HOME}\install目录,运行ant create.jbpm.schema,该步骤将创建数据库脚本并在指定的数据库中创建表
6. 在eclipse中安装GPD插件
a) 帮助-->安装新软件...
b) 点击 添加...
c) 在 添加站点 对话框中，单击 压缩包...
d) 找到${JBPM_HOME}/install/src/gpd/jbpm-gpd-site.zip 并点击 '打开'
e) 点击 确定 在 添加站点 对话框中，会返回到 '安装'对话框
f) 选择出现的 jPDL 4 GPD 更新站点
g) 点击 下一步.. 然后点击 完成
h) 接受协议，当它询问的时候重启eclipse
7. 配置jBPM运行时
a) 点击 Window --> Preferences
b) 选择 JBoss jBPM --> jBPM 4 --> Runtime Locations
c) 点击 Add...
d) 在 Add Location 对话框中，输入一个名字，比如 jbpm-4.4 然后点击 Search...
e) 在 Browse For Folder 对话框中，选择你的jBPM根目录，然后点击 OK
f) 点击 OK 在 Add Location 对话框中
8. 定义jBPM用户库
a) 点击窗口 --> 属性（Windows --> Preferences）
b) 选择 Java --> 创建路径 --> 用户类库（Java --> Build Path --> User Libraries）
c) 点击新建（New）
d) 类型名字jBPM Libraries
e) 点击添加JARs（Add JARs...）
f) 找到jBPM安装程序下的lib目录 选择 lib下的所有jar文件并点击打开（Open）
g) 选择 jBPM Libraries作为入口
h) 重新点击添加JARs（Add JARs）
i) 在jBPM 的安装程序的根目录下选择jbpm.jar文件
j) 点击打开（Open）
k) 在jbpm.jar下选择源码附件（Source attachment）作为入口
l) 点击编辑（Edit）
m) 在源码附件的配置（Source Attachment Configuration）对话框中，点击目录（External Folder...）
n) 找到jBPM安装程序下的src 目录
o) 点击选择（Choose）
p) 点击两次'确定'（Ok）会关闭所有对话框
9. 在目录中添加jPDL4模式
a) 点击窗口 --> 属性（Windows --> Preferences）
b) 选择 XML --> 目录（XML --> CataLog）
c) 点击添加（Add）
d) 添加 XML 目录（Add XML Catalog Entry）的窗口打开
e) 点击map-icon的图标下面的按钮并选择文件系统（File System）
f) 在打开的对话框中， 选择jBPM 安装目录下src 文件夹中jpdl.xsd文件
g) 点击打开（Open）并且关闭所有的对话框
10. 常见问题解决方案
a) MySQL数据库方言使用MySQL5InnoDBDialect
<property name="hibernate.dialect">org.hibernate.dialect.MySQL5InnoDBDialect</property>
b) jBPM流程图中文乱码
elipse中 在eclipse.ini 中加入-Dfile.encoding=UTF-8
myelipse 中 在myeclipse.ini中加入-Dfile.encoding=UTF-8
c) Tomcat6 JBPM4 jar包冲突问题
因为jBPM中的juel.jar相关三个包与tomcat/lib下的el-api.jar会有冲突，
删除项目的juel.jar ,juel-engine.jar,juel-impl.jar三个 jar文件或者用juel.jar ,juel-engine.jar,juel-impl.jar文件替换tomcat/lib下的el-api.jar包。
d) mysql数据库中文乱码
jdbc:mysql://192.168.2.13:3306/xxx?useUnicode=true&amp;characterEncoding=UTF-8
e) JBPM4执行taskSpleteTask(taskId,map)或taskSpleteTask(taskId) 操作时，出现如下异常：No unnamed transitions were found for the task 'XXXX'
解决方案：
i、只拥有一个外向转移时：（可以直接将箭头的名字删除或用如下方式）
Map map = new HashMap();
map.put("",……）//各种参数
taskService.setVariables(taskId,map);
taskSpleteTask(taskId);
ii、拥有多个外向转移时:
Map map = new HashMap();
map.put("",……）//各种参数
taskService.setVariables(taskId,map);
//如想转移至有名称的外向转移：
taskSpleteTask(taskId,"外向转移名称");
//如想转移至无名称的外向转移：
taskSpleteTask(taskId);
f)