Activiti 用户指南（Activiti入门）

Activiti入门

从Activiti网站下载Activiti UI WAR文件后，按照以下步骤使用默认设置运行演示设置。你需要有效的Java运行时和Apache Tomcat安装（实际上，任何Web容器都可以使用，因为仅依赖Servlet功能，但是主要在Tomcat上进行测试）。

• 将下载的activiti-app.war复制到Tomcat的webapps目录。
• 通过运行Tomcat的bin文件夹中的startup.bat或startup.sh脚本来启动Tomcat。
• Tomcat启动后，打开浏览器并转到http://localhost:8080/activiti-app，使用admin和密码test登录。

Activiti UI应用程序默认情况下使用内存中的H2数据库。

Activiti设置

要安装Activiti，你需要有效的Java运行时和Apache Tomcat安装，还要确保正确设置了JAVA_HOME系统变量，执行此操作的方法取决于你的操作系统。

要使Activiti UI和REST Web应用程序运行，只需将从Activiti下载页面下载的WAR复制到Tomcat安装目录中的webapps文件夹中，默认情况下，UI应用程序与内存数据库一起运行。

演示用户：

UserId	Password	安全角色
admin	test	admin

现在你可以访问以下Web应用程序：

Webapp名称	URL	描述
Activiti UI	http://localhost:8080/activiti-app	流程引擎用户控制台，使用此工具可以启动新流程、分配任务、查看和声明任务等。

请注意，Activiti UI应用程序演示设置是一种尽可能轻松、快速地显示Activiti功能的方法，但是，这并不意味着它是使用Activiti的唯一方法。由于Activiti只是一个jar，因此可以将其嵌入任何Java环境中：通过swing或在Tomcat、JBoss、WebSphere等上，或者，你也可以选择将Activiti作为典型的独立BPM服务器运行，如果使用Java，则可以使用Activiti！

Activiti数据库设置

正如在演示设置中所说，默认情况下，Activiti UI应用程序运行内存中的H2数据库，要使用独立的H2或其他数据库运行Activiti UI应用程序，应更改Activiti UI Web应用程序的WEB-INF/classes/META-INF/activiti-app中的activiti-app.properties。

包含Activiti jar及其依赖项

为了包含Activiti jar及其依赖库，建议使用Maven（或Ivy），因为它大大简化了依赖关系管理，请按照http://www.activiti.org/community.html#maven.repository中的说明进行操作，以在你的环境中包含必要的jar。

另外，如果你不想使用Maven，则可以自己在项目中包含jar，Activiti下载zip包含一个文件夹libs，其中包含所有Activiti jar（和源jar）。依赖项不是通过这种方式提供的，Activiti引擎所需的依赖项（使用mvn dependency:tree生成）：

org.activiti:activiti-engine:jar:6.x
+- org.activiti:activiti-bpmn-converter:jar:6.x:compile
|  \\- org.activiti:activiti-bpmn-model:jar:6.x:compile
|     +- com.fasterxml.jackson.core:jackson-core:jar:2.2.3:compile
|     \\- com.fasterxml.jackson.core:jackson-databind:jar:2.2.3:compile
|        \\- com.fasterxml.jackson.core:jackson-annotations:jar:2.2.3:compile
+- org.activiti:activiti-process-validation:jar:6.x:compile
+- org.activiti:activiti-image-generator:jar:6.x:compile
+- org.apache.commons:commons-email:jar:1.2:compile
|  +- javax.mail:mail:jar:1.4.1:compile
|  \\- javax.activation:activation:jar:1.1:compile
+- org.apache.commons:commons-lang3:jar:3.3.2:compile
+- org.mybatis:mybatis:jar:3.3.0:compile
+- org.springframework:spring-beans:jar:4.1.6.RELEASE:compile
|  \\- org.springframework:spring-core:jar:4.1.6.RELEASE:compile
+- joda-time:joda-time:jar:2.6:compile
+- org.slf4j:slf4j-api:jar:1.7.6:compile
+- org.slf4j:jcl-over-slf4j:jar:1.7.6:compile

注意：仅在使用邮件服务任务时才需要邮件jar。

在Activiti源码模块上使用mvn dependency:copy-dependencies可以轻松下载所有依赖项。

下一步

使用Activiti UI Web应用程序是熟悉Activiti概念和功能的好方法，但是，Activiti的主要目的当然是在你自己的应用程序中启用强大的BPM和工作流功能，以下各章将帮助你熟悉如何在环境中以编程方式使用Activiti：

• 有关配置的章节将教你如何设置Activiti以及如何获取ProcessEngine类的实例，该类是你对Activiti所有引擎功能的集中访问点。API这一章将指导你了解构成Activiti API的服务，这些服务以便捷而强大的方式提供Activiti引擎功能，并且可以在任何Java环境中使用。有兴趣了解BPMN 2.0，即Activiti引擎的流程的编写格式吗？然后继续进行BPMN 2.0部分。

---