大家好! 这是关于jBPM Console NG的另一篇文章。 经过6个月的辛苦工作,我很高兴为开发者社区撰写这篇文章,以进行尝试。 在这篇文章中,我将解释如何从源代码构建应用程序。 这背后的主要思想是知道如何在测试过程中设置环境并修改应用程序。 您将基本学习为该项目做出贡献所需的全部知识。
介绍
jBPM Console NG旨在提供任务和流程
管理协作环境,以促进公司采用BPM套件。 下载源代码并编译该应用程序将使您可以尝试对该应用程序进行修改,以防您要扩展它或修复错误。 该应用程序受Apache License V2许可,因此可以根据此许可证使用和修改。
使用源代码
为了使一切正常运行的第一步是使用GIT获取源代码。 这是您需要在计算机上安装的东西才能继续:
- JDK 6
- Maven的3.x
- 吉特
- 安装了maven插件的任何IDE(Eclipse,IntelliJ,Netbeans)
- JBoss应用服务器7.1.1(可选)
一旦安装了所有这些工具,我们就可以继续从github存储库获取源代码: https : //github.com/droolsjbpm/jbpm-console-ng/为了获得存储库的“克隆”,您可以使用必须从终端:
git clone https://github.com/droolsjbpm/jbpm-console-ng.git
完成后,您可以编译源代码,这里有两种选择:
- 为了开发目的,使用以下命令编译项目:
mvn clean install
- 编译项目以生成JBoss和Tomcat的发行战+文档
mvn clean install -PfullProfile
高枕无忧! 第一次执行此步骤时,Maven需要下载大量的库,因此您需要等待。
在托管模式下运行应用程序
编译完项目后,可以在GWT所谓的“托管模式”(也称为开发人员模式)中执行jbpm-console-ng-showcase。要在托管模式下启动应用程序,您应该执行以下操作:
- jBPM Console NG Showcase包含最终的应用程序分发代码:
cd jbpm-console-ng-showcase/
- 使用GWT Maven插件以托管模式运行
mvn gwt:run
这将启动Jetty + GWT开发模式屏幕,该屏幕将允许您复制托管应用程序的URL,以供您尝试:
GWT托管模式将URL( http://127.0.0.1:8888/org.jbpm.console.ng.jBPMShowcase/jBPM.html?gwt.codesvr=127.0.0.1:9997 )复制到浏览器中(对于托管模式,您需要要在浏览器中安装GWT插件,请放心,如果您没有安装GWT插件,它将自动安装)将打开该应用程序。 我强烈建议将Firefox用于开发模式或Chrome(通常速度较慢),因为在开发过程中,我们将编译范围限定在FF和Chrome(壁虎浏览器)上。
在JBoss AS 7中运行应用程序
现在,如果要在JBoss上部署应用程序,则需要转到第二个编译选项(-PfullProfile),这将花费一些额外的时间来为所有浏览器和所有语言(英语,西班牙语等)编译应用程序。 。 为了将应用程序作为7实例部署到jboss,您将需要移动在jbpm-console-ng / jbpm-console-ng-distribution-wars / target / jbpm-console-ng-jboss-as7内部生成的war文件将.war放入<jboss-as> / standalone / deployments目录,然后将war文件重命名为jbpm-console-ng.war。 应用程序的名称将用作应用程序的根上下文。 对于JBoss,您还需要为用户和角色进行一些配置。 在jBPM Console NG中,您将需要设置可用于安装的用户。 这些由JBoss安全域处理。 为了设置安全域,您需要执行以下操作:
- 编辑<jboss_as> /configuration/standalone.xml并添加一个新的安全域:<security-domain name =“ jbpm-console-ng” cache-type =“ default”> <authentication> <login-module code =“ UsersRoles ” flag =“” required”> <模块选项名称=” usersProperties” value =”” $ {jboss.server.config.dir} /users.properties” /> <模块选项名称=” rolesProperties” value =“” $ { jboss.server.config.dir} /roles.properties” /> </ login-module> </ authentication> </ security-domain>
- 添加users.properties和role.properties文件
user.properties文件的内容:
maciek=Merck salaboy=salaboy katy=katy john=john
role.properties文件的内容:
maciek=jbpm-console-user,kie-user,analyst,HR,PM,Reviewer salaboy=jbpm-console-user,user,analyst,PM,IT,Reviewer katy=jbpm-console-user,HR john=jbpm-console-user,Accounting
角色文件的唯一要求是为所有用户包括jbpm-console-user角色。 请注意,这是配置安全域的最简单方法,但是您可以使用更多高级选项,例如将安全域配置为使用LDAP服务器或数据库来验证用户和角色。 (https://docs.jboss.org/author/display/AS7/Security+subsystem+configuration)
然后就可以开始了,可以通过以下方法启动jboss:
- 进入bin目录:
cd <jboss-as>/bin/
- 启动应用程序服务器:
./standalone.sh
在Openshift上
为了将应用程序部署到openshift中,您显然需要拥有一个openshift帐户。 设置帐户后,您将需要执行与JBoss应用程序中几乎相同的配置。 在您克隆的openshift git存储库中,您将具有一个特定目录来应用此配置:
.openshift/config
在这里,您可以找到standalone.xml文件,并且可以放置users.properties和Roles.properties文件。
因此,在standalone.xml文件中,您将需要像之前一样配置安全域,并添加users.property和Roles.properties文件。 除了此配置之外,您还需要设置一个系统属性来存储知识存储库:
<system-properties>
<property name="org.kie.nio.git.dir" value="~/jbossas-7/tmp/data"/>
</system-properties>
应用程序
现在,您可以使用该应用程序了,因此,如果您将浏览器指向托管模式提供的URL或指向
http:// localhost:8080 / jbpm-console-ng /您将能够访问登录表单。 如您所见,在进入应用程序之前,您需要提供凭据。 进入应用程序后,分为:
在“创作”部分中,您将可以访问流程设计器以对业务流程进行建模。 流程管理部分将允许您列出可用的业务流程并启动新实例,并监视这些实例。 工作部分将使您能够访问任务列表(日历和网格视图)以处理分配给您的任务。 为了使用BAM部分,您将需要部署BAM仪表板应用程序,但我将在以后的文章中对此进行描述。 如果发现问题,请随时尝试并写回评论。
会费
您的反馈意见很重要,但是如果您想贡献一点,可以在github中派生jbpm-console-ng存储库: https : //github.com/droolsjbpm/jbpm-console-ng/如果您可以测试“任务列表”和“流程管理”屏幕,并在本文中写下反馈,以便我可以迭代地改进我们所拥有的。 我将写另一篇文章来描述屏幕,并列出一组您可以贡献的小任务。
翻译自: https://www.javacodegeeks.com/2013/05/try-the-jbpm-console-ng-beta.html