jbpmAPI-3

第三章。jBPM安装程序

3.1 .先决条件
这个脚本假设您具备Java JDK 1.6 +(设置JAVA_HOME),和Ant 1.7 +安装。如果你没有,请使用以下链接下载并安装:
Java:http://java.sun.com/javase/downloads/index.jsp
ant:http://ant.apache.org/bindownload.cgi

3.2。下载安装程序
首先,你需要下载安装程序并将其解压缩到您的本地文件系统。有两个版本
完整的安装程序——这已经包含很多依赖项在安装是必要的
最小安装程序——只包含安装程序,下载所有依赖项
一般来说,最好下载完整安装程序:jBPM - { version } -installer-full.zip
你也可以在这里找到最新的快照版本(只有最小的安装程序):
https://hudson.jboss.org/jenkins/job/jBPM/lastSuccessfulBuild/artifact/jbpm-distribution/target/

3.3。演示设置
开始的最简单方法是直接运行安装脚本安装演示设置。演示安装设置所有web工具(WildFly之上)和Eclipse工具在一个预先配置的设置。进入jbpm-installer文件夹解压缩安装和运行(从一个命令提示符):
蚂蚁install.demo
这将:
下载WildFly应用服务器
配置和部署web工具
下载Eclipse
安装Drools和jBPM Eclipse插件
安装Eclipse BPMN 2.0 Modeler
运行这个命令可能需要一段时间(真的,不是在开玩笑,我们是例如下载Eclipse安装,即使你下载完整的安装程序,专门为您的操作系统)。

一旦演示安装完成后,您就可以开始使用的各种组件开始演示设置:

ant start.demo
3.4。10分钟教程使用工作台:http://people.redhat.com/kverlaen/jbpm6F-installer-console.swf

工作台支持整个生命周期的业务流程:编写、部署、流程管理、任务和指示板。
项目编写的角度让你看看现有的存储库,在每一个项目可以包含业务流程(业务规则、数据模型、表格,等等)。默认情况下,工作台将下载两个示例操场存储库,包含的例子来看看。
在这个视频,评价项目在jbpm-playground库使用。
project explorer中显示所有可用的文物:
评价:业务流程描述评价过程的任务序列
evaluation-taskform:过程形式开始评估过程
PerformanceEvaluation-taskform:任务执行评估任务
可执行流程,首先你需要成功地构建和部署。为此,打开项目编辑器(从“工具”菜单),然后单击构建和部署。
管理您的流程定义和实例,点击顶部的“流程管理”菜单选项菜单栏的选择一个可用的选项取决于你的兴趣:
过程定义,列出了所有可用的流程定义
流程实例,列出所有活动流程实例(允许显示完成,流产也通过改变过滤标准)
过程定义面板允许您启动一个新的流程实例通过单击“播放”按钮。流程表单中定义的(项目)将显示,你需要填写必要的信息开始这个过程。在这种情况下,您需要填写用户你想开始一个评估(在本例中使用“krisv”)和一个原因请求,之后您可以完成表单。一些细节刚刚开始的流程实例将显示在流程实例详细信息面板。从那里你可以访问更多细节:
流程模型,可视化过程的当前状态
流程变量——看到流程变量的当前值
流程实例,你刚刚开始首先是要求用户的自我评价,等到用户已经完成这一任务。
看到已经分配给你的任务,选择顶部菜单栏上的“任务”菜单选项,选择“任务列表”(您可能需要点击刷新更新你的任务视图)。个人任务表应该显示一个“绩效评估”任务留给你。启动任务后,可以完成任务,这将打开任务形式与此相关的任务。您可以填写必要的数据,然后完成表格并关闭窗口。完成任务后,你可以查看流程实例”再一次检查您的流程实例的进展。您应该能够看到流程现在也等待你的人事经理和项目经理进行评估。你可以登录“john”/“john”和“mary”/mar”来完成这些任务。

后开始和/或完成一些过程实例和人工任务,您可以生成一个报告到目前为止,发生了什么事。“仪表板”下,选择“流程&任务指示板”。这是一组预定义的图表看到,允许用户发现系统中是怎么回事。图表可以完全定制,作为业务活动监视一章解释。

3.5. 10-Minute Tutorial using Eclipse http://people.redhat.com/kverlaen/jbpm6F-installer-eclipse.swf.

你可以导入评估项目——一个示例包括在jbpm-installer -通过选择“文件- >导入……”,选择“现有项目到工作空间”,浏览jbpm-installer /样本/评价文件夹并单击“完成”。你可以打开评估过程和ProcessTest类。执行类,右键单击它并选择“运行…——Java应用程序”。控制台应该展示过程开始和不同的演员如何在这个过程中完成分配给他们的任务,完成流程实例。
你也可以使用jBPM项目向导创建一个新项目。示例项目包含一个过程和一个相关的Java文件启动过程。选择“文件-新…-项目…下”和“jBPM”类别,选择“jBPM项目”并单击“下一步”。为项目指定一个名称,然后单击“下一步”。你可以选择从一个简单的HelloWorld示例或更先进的例子使用持久性和人工任务。如果你选择后者,并单击Finish,您应该看到一个新项目,其中包含一个“样本。bpmn”过程和“com.sample。ProcessTest”JUnit测试类。你可以通过双击打开BPMN2的过程。执行过程中,右键单击ProcessTest。java和选择“运行java应用程序”。

3.6 .配置

3.6.1操场。
工作台在默认情况下将两个示例操场存储库(通过克隆jbpm-playground存储库在GitHub上)。在这种情况下,这不是想要访问互联网可能不可用,或者可能有一个需要开始与一个完全干净的安装工作台)这种默认行为可以被关闭。为此,在开始改变下面的系统属性。jboss目标build . xml的错误:

-Dorg.kie.demo=false

请注意,这将创建一个完全的空版本工作台。能够开始建模过程中,首先需要创建以下元素:
组织单元
库(新的或现有克隆)
项目

3.6.2。工作台的身份验证

The workbench web application is using the "default" security domain for authenticating and authorizing users (as specified in the WEB-INF/jboss-web.xml inside the WARs).

The application server is configured by default to use properties files for specifying users. Note that this is for demo purposes only (as passwords and roles are stored in simple property files). The security domain is configured in the standalone.xml configuration file as follows:

<security-domain name="other" cache-type="default">
  <authentication>
    <login-module code="UsersRoles" flag="required">
      <module-option name="usersProperties" value="${jboss.server.config.dir}/users.properties"/>
      <module-option name="rolesProperties" value="${jboss.server.config.dir}/roles.properties"/>
    </login-module>
  </authentication>
</security-domain>
默认情况下,这些配置文件包含以下用户:

Name	Password	Workbench roles	Task roles
admin	admin	admin,analyst
krisv	krisv	admin,analyst
john	john	analyst	Accounting,PM
mary	mary	analyst	HR
sales-rep	sales-rep	analyst	sales
jack	jack	analyst	IT
katy	katy	analyst	HR
salaboy	salaboy	admin,analyst	IT,HR,Accounting

身份验证可以通过编辑自定义身份验证和配置文件在jbpm-installer / auth文件夹和/或通过改变独立- *。jbpm-installer xml文件的文件夹。注意,您需要重新运行安装程序以确保修改后的文件复制和正确选择。

3.6.3。使用jBPM安装程序使用您自己的数据库
3.6.3.1。介绍
jBPM使用Java Persistence API规范(v2)允许用户配置任何他们想使用数据源持续运行时数据。因此,下面的说明描述应该如何配置一个数据源JBoss应用服务器上使用JPA时(例如AS7,EAP6或Wildfly8)使用持久性。xmlfile数据源和司机在你的应用程序和配置服务器的独立。xml,类似于你如何配置其他应用程序使用JPA JBoss应用服务器上。安装程序自动化部分(如正确的文件复制到正确的位置安装后)。
默认情况下,jbpm-installer使用H2数据库持久化运行时数据。在本节中,我们将:
修改的持久性设置运行时流程实例状态的持久性
测试启动我们的新设置!
你需要一个本地数据库的实例,在这种情况下,我们将使用MySQL。
3.6.3.2。数据库设置
本快速入门中使用MySQL数据库,创建一个单一的用户:
用户/模式“jbpm”和密码“jbpm”(将用于保存所有实体)
如果你最终用户/模式使用不同的名称,请注意,我们在配置文件中插入“jbpm”。
如果你想试试这个快速入门与另一个数据库、一段结束时本快速入门描述你可能需要修改。
3.6.3.3配置。
以下文件定义的持久性设置jbpm-installer演示:
jbpm-installer / db / jbpm-persistence-JPA2.xml
应用服务器配置
独立- * . xml
禁用H2默认数据库和启用MySQL数据库在build . properties

# default is H2
# H2.version=1.3.168
# db.name=h2
# db.driver.jar.name=${db.name}.jar
# db.driver.download.url=http://repo1.maven.org/maven2/com/h2database/h2/${H2.version}/h2-${H2.version}.jar
#mysql
db.name=mysql
db.driver.module.prefix=com/mysql
db.driver.jar.name=mysql-connector-java-5.1.18.jar
db.driver.download.url=https://repository.jboss.org/nexus/service/local/repositories/central/content/mysql/mysql-connector-java/5.1.18/mysql-connector-java-5.1.18.jar

您可能想要更新数据库驱动程序jar名称和url下载到任何版本的jar匹配您的安装。
db / jbpm-persistence-JPA2.xml:
这是定义JPA持久性文件使用的持久性设置jBPM流程引擎的信息,日志/ BAM信息和任务服务。
在这个文件中,您将不得不改变hibernate方言用于您的数据库的名称。
最初的线路是:

<property name="hibernate.dialect" value="org.hibernate.dialect.H2Dialect"/>
在MySQL数据库的情况下,你需要改变:

<property name="hibernate.dialect" value="org.hibernate.dialect.MySQLDialect"/>
对于你们中那些决定使用另一个数据库,列出可用的hibernate方言类可以在这里找到。http://docs.jboss.org/hibernate/core/3.3/reference/en-US/html/session-configuration.html#configuration-optional-dialects
standalone-full-wildfly-8.1.0.Final.xml:
Standalone.xml standalone-full。xml是独立的JBoss应用服务器的配置。当安装程序安装演示时,它将这些文件复制到单独的/配置目录在JBoss服务器目录。自安装使用默认Wildfly8作为应用程序服务器,您可能需要更改standalone-full-wildfly-8.1.0.Final.xml。
我们需要改变在standalone-full数据源配置。xml,以便jBPM流程引擎可以使用我们的MySQL数据库。原始文件包含(非常类似于)以下行:

<datasource jta="true" jndi-name="java:jboss/datasources/jbpmDS" pool-name="H2DS" enabled="true" use-java-context="true" use-ccm="true">
    <connection-url>jdbc:h2:tcp://localhost/~/jbpm-db;MVCC=TRUE</connection-url>
    <driver>h2</driver>
    <security>
       <user-name>sa</user-name>
    </security>
</datasource>
<drivers>
    <driver name="h2" module="com.h2database.h2">
        <xa-datasource-class>org.h2.jdbcx.JdbcDataSource</xa-datasource-class>
    </driver>
</drivers>
改为：

<datasource jta="true" jndi-name="java:jboss/datasources/jbpmDS" pool-name="MySQLDS" enabled="true" use-java-context="true" use-ccm="true">
    <connection-url>jdbc:mysql://localhost:3306/jbpm</connection-url>
    <driver>mysql</driver>
    <security>
       <user-name>jbpm</user-name>
       <password>jbpm</password>
    </security>
</datasource>

<driver name="mysql" module="com.mysql">
    <xa-datasource-class>com.mysql.jdbc.jdbc2.optional.MysqlXADataSource</xa-datasource-class>
</driver>
在JBoss应用服务器安装驱动程序jar(Wildfly8,EAP6等等),建议安装驱动程序jar作为一个模块。安装程序已经负责这个主要是:它将复制驱动程序jar(指定在build . properties)到正确的文件夹里面的模块目录服务器,把一个匹配模块。xml旁边。对于MySQL,这文件db / mysql_module.xml。打开这个文件,并确保驱动程序jar文件名称的列有相同的驱动程序jar thebuild中指定的名称。属性(包括版本)。注意,即使你只是注释默认MySQL配置,您仍然需要添加正确的版本。