jbpmAPI-2

2.1. Downloads

所有的版本都可以从SourceForge下载。选择您想要下载的版本,然后选择你想要工件: https://sourceforge.net/projects/jbpm/files/

本:所有jBPM的二进制文件(jar)和他们的依赖关系
src:核心组件的来源
文档:文档
例子:jBPM的一些例子,可以导入Eclipse
安装程序:jbpm-installer,下载并安装一个演示jBPM的设置
installer-full:jbpm-installer,下载并安装一个演示jBPM的设置,已经包含许多依赖预先包装(所以他们不需要单独下载)

2.2。开始

如果你喜欢快速教程,将指导您完成大部分的组件使用一个简单的例子,看看安装程序一章。这将教会你如何下载和使用安装程序来创建一个演示设置,包括大部分的组件。它使用一个简单的例子来指导您完成最重要的特性。演示可以帮助你。
首先如果你想了解更多信息,接下来的章节首先专注于核心引擎(API,BPMN 2.0等)。进一步的章节将描述等其他组件和其他更复杂的主题领域特定的流程,灵活的过程,等。在阅读的核心章节,您应该能够跳转到其他章节,你可能会觉得有趣。
你也可以开始使用一些例子中提供一个单独的下载。看看章看到的例子如何开始玩这些。
阅读这些章节之后,您应该可以开始创建自己的流程和与应用程序集成引擎。这些过程可以从安装程序或从头开始。

2.3社区。

这里有很多的有用链接jBPM社区的一部分:
一个提要jBPM相关的博客条目
# jbossjbpm Twitter帐户。
用户论坛提问,给答案
一个bug,JIRA bug跟踪系统特性请求和路线图
持续构建服务器获取最新的快照
请加入我们在chat.freenode.net jbpm IRC频道。这就是大部分的实时讨论项目发生和你在哪里可以找到大多数开发人员的大部分时间。没有一个IRC客户端安装吗?简单地访问http://webchat.freenode.net/,输入你想要的昵称,并指定# jbpm。然后单击登录加入乐趣。

2.4 .来源
2.4.1许可证。
jBPM的代码使用Apache许可v2.0本身。
一些其他组件集成有自己的许可证:
新的Eclipse BPMN2插件的Eclipse Public License(EPL)v1.0。
基于web的设计师是基于大羚羊/ Wapama,麻省理工学院的许可
Drools v2.0项目Apache许可证。
2.4.2。源代码
jBPM现在使用git源代码版本控制系统。jBPM项目可以在这里找到的来源(包括所有版本从5.0 jBPM开始cr1):
https://github.com/droolsjbpm/jbpm
一些其他组件的来源我们集成可以在这里找到:
jBPM和Drools项目相关的其他组件可以在这里找到。
新的Eclipse BPMN2插件可以在这里找到。
web设计人员可以在这里找到
kie工作台可以在这里找到注意这是一个聚合的其他项目(drools-wb jbpm-console-ng)

2.4.3。从源代码构建

如果你感兴趣构建源代码,贡献,释放等确保阅读README。https://github.com/droolsjbpm/droolsjbpm-build-bootstrap/blob/master/README.md

2.5。参与

我们经常问“我怎么参与”。幸运的是答案很简单,只是编写一些代码,提交:)没有篮球你必须跳过或者秘密握手。我们有一个非常小的“开销”,我们请求允许可伸缩的项目开发。下面我们提供概述我们请求的工具和“工作流”,连同一些一般性的建议。
如果你贡献一些好工作,别忘了博客:)

2.5.1。注册jboss.org
签约jboss.org会给你访问JBoss wiki,论坛和JIRA。访问http://www.jboss.org/并单击“注册”。

2.5.2。签署的贡献者协议

唯一你需要签署协议是贡献者,这是通过网络完全自动化。正如下图表示“这建立贡献的条款和条件并确保源代码可以适当授权”
https://cla.jboss.org/

2.5.3。通过JIRA提交问题

核心开发团队能够与您将需要使用JIRA,问题跟踪程序。这将确保所有请求都记录和分配给发布时间表,讨论了在一个地方。Bug报告,提交Bug修复、功能要求和特性都应该去这里。一般应该在进行邮件列表的问题。
小的代码提交,比如格式或文件补丁不需要创建一个关联的JIRA问题。
https://issues.jboss.org/browse/JBRULES(Drools)
https://issues.jboss.org/browse/JBPM
https://issues.jboss.org/browse/GUVNOR

2.5.4。GitHub

贡献者签署的协议,你的要求提交给JIRA你现在应该准备好代码:)创建一个GitHub帐户和叉任何Drools,jBPM或雇主存储库。叉子将创建一个拷贝在自己的GitHub工作空间,您可以在自己的步伐。如果你犯了错,别担心把它吹走,又叉。注意每一个GitHub库为您提供克隆(结帐)的URL,GitHub将提供你特定URL叉。
https://github.com/droolsjbpm

2.5.5。编写测试

在编写测试时,试着让他们最小的和自我控制。我们宁愿保持DRL碎片在测试,因为它使得更快的审核。如果他们是大量的规则,那么使用一个字符串是不切实际的,然后就把它们在单独DRL文件而不是从类路径加载。如果您的测试需要使用一个模型,请尝试使用那些已经存在的其他单元测试,如人、奶酪或秩序。如果不存在类,你需要有足够的场地,试着更新现有类的字段前添加一个新的类。
有大量的测试来查看一个想法,MiscTest是一个很好的起点。
https://github.com/droolsjbpm/drools/blob/master/drools-compiler/src/test/java/org/drools/integrationtests/MiscTest.java

2.5.6。用正确的约定提交
当你提交时,确保您使用正确的约定。提交必须开始JIRA问题id,如jbrules - 220。这样可以确保提交通过JIRA交叉引用,所以我们可以看到所有提交对于一个给定的问题在同一个地方。在id的标题应该下一个问题。然后使用换行符,缩进,提供与此相关的额外信息提交。使用一个额外的新行和破折号为每个单独的点你想。你可以添加额外的JIRA交叉引用相同的承诺,如果是合适的。一般尽量避免结合在同一个提交无关的问题。
别忘了变基你当地的叉从原来的主人,然后推动提交回你的叉子。

2.5.7。提交的请求
与原来的主人和代码更改推到你的个人GitHub区域,您现在可以提交你的工作作为一个请求。如果你看看页面的顶部在GitHub的工作区域将是一个“请求”按钮。选择这将提供一个gui自动化提交你的请求。
拉请求队列然后走进每个人看到和评论。下面你将看到一个典型的请求。拉请求允许讨论,它显示了所有相关的提交和每个提交的差别。的讨论通常涉及代码评审为改进提供有益的建议,并允许我们离开内联注释代码的特定部分。不要灰心的如果我们不马上合并,这往往需要几个修改之前我们接受拉请求。幸运的是GitHub很琐碎的回到您的代码,做些提交,然后更新最新最好的请求被拉。
我们可以花时间抽出时间来响应请求,所以请耐心等待。提交测试,修复通常会很快被应用,只是测试经常会直到我们修复时间也提交。别忘了时不时变基并重新提交您的请求,否则随着时间的推移,它会合并冲突,核心开发人员会忽略这些。

2.6。该做什么,如果我遇到问题或有问题吗?
你可以联系jBPM社区寻求帮助。
IRC:# jbpm chat.freenode.net
jBPM用户论坛http://community.jboss.org/en/jbpm?view=discussions