Activiti User Guide -- Activit 用户指南 Part01

    终于告一个段落了，前一段时间忙着开发一个流转引擎，所以这一段时间也没有跟踪Activiti的进展，直到前几天才开始重新研究，觉得先把用户指南好好看看，顺便也进行了翻译，不敢独享，所以发表出来和大家一起分享。

    还是采用以前的方式同时把中英文发布出来，由于本人英语不是很好，所以翻译过程中肯定有很多值得商榷的地方，请大家多多包涵。

    后面我会逐渐把整个用户指南发布，现在还没有全部翻译完，所以只能一部分一部分的发布出来，希望大家了解。

 

 

Chapter 1. Introduction

第一章 简介

Table of Contents

License

Download

Sources

Required software

Reporting problems

License

许可

Activiti is distributed under the Apache V2 license.

Activiti是依据the Apache V2 license进行发布的。

Download

下载

http://activiti.org/download.html

Sources

源码

The distribution contains most of the sources as jar files. To find and build the full source codebase, please read the 'Building the distribution' wiki page

Activiti的发布包中以jar的方式包含了大部分的源码。在 'Building the distribution' wiki page 找到全部代码和如何进行编译。

Required software

运行环境

• JVM 5+
• Ant 1.7.1+

Reporting problems

报告问题

Every self respecting developer should have read How to ask questions the smart way

每一个开发人员都应该阅读How to ask questions the smart way

After you've done that you can post questions and comments on the Users forum and create issues in our JIRA issue tracker

当你阅读后你就可以在 the Users forum中发布你的问题和意见，同时可以在our JIRA issue tracker中创建相应的报告。

Chapter 2. Getting Started

第二章 启航

Table of Contents

Demo setup

Examples

Library dependencies

Eclipse setup

Checking the database

Demo setup

安装示例

Setup is an ant script located in directory setup that helps you get up and running with Activiti quickly.

Activiti的安装是一个ant脚本，存放在setup目录下，它可以帮助你快速将Activiti运行起来。

 

To run the script, you'll need a working Java runtime and Ant installation. Also make sure that the JAVA_HOME and ANT_HOME system variables are correctly set. The way to do this depends on your operating system, but the manual of ant gives a description on how to do this. The demo setup script is tested with Ant 1.7.1.

为了运行该脚本，你必须正确安装了Java和Ant运行环境。同时你也必须确认JAVA_HOME和ANT_HOME系统变量设置正确。具体如何进行设置依赖于你的操作系统，具体可以参考manual of ant 。本示例脚本在Ant1.7.1下测试通过。

 

To configure setup for your environment, update property files build.properties and build.{your-database}.properties . Check those files for more information on configurable properties and potential values.

然后修改 build.properties 和 build.{your-database}.properties 属性文件。检查这些属性配置文件的属性项及相应的配置的值。

 

The easiest target to get started is demo.setup. That target will

启动Activiti的最简单的target是demo.setup。该target将

 

• Fetch the library dependencies for the examples
• 获取示例所依赖的包
• Install the H2 in ${activiti.home}/apps/h2
• 安装H2到${activiti.home}/apps/h2目录
• Start the H2 database
• 启动H2数据库
• Create the Activiti tables in the database
• 在数据库中创建Activiti的表
• Download Tomcat if not available in the ${downloads.dir}
• 如果在${downloads.dir}目录不存在Tomcat安装文件，则进行下载
• Install Tomcat in ${activiti.home}/apps/apache-tomcat-${tomcat.version}
• 安装Tomcat到${activiti.home}/apps/apache-tomcat-${tomcat.version}目录
• Create an Activiti configuration jar
• 创建Activiti配置jar
• Install Activiti Engine into Tomcat, which includes libraries and configurations
• 安装Activiti引擎到Tomcat，包含了相应的包机配置信息
• Insert the demo users and groups in the Activiti identity tables (see below)
• 在Activiti identity表中插入示例用户和岗位(参考下面)
• Deploy the example processes to the Activiti Engine DB
• 部署示例流程到Activiti 引擎数据库
• Deploy the REST interface webapp into tomcat
• 部署REST应用接口到tomcat中
• Download the Activiti Modeler webapp to ${activiti.home}/webapps
• 下载Activiti建模工具到${activiti.home}/webapps中
• Deploy the Probe, Explorer and Modeler webapps into tomcat.
• 部署Probe、Explorer和Modeler应用到tomcat中
• Start tomcat
• 启动tomcat

After running this target H2 and Tomcat will be running in the background. To stop those processes run ant demo.teardown. Note that if you start Tomcat manually with the startup and shutdown scripts in tomcats bin directory, on some platforms Activiti Cycle will currently store configuration files in the working directory (which is the directory you start the script in).

当运行该target后，H2和Tomcat将会在后台运行。你可以通过运行ant demo.teardown来停止。注意，如果你是通过手工启动tomcat bin目录下的startup和shutdown时，在某些平台中Activiti Cycle将会把配置文件存放在相应的工作目录下（也就是你启动脚本的那个目录）。

 

The other targets in that build script can also be called individually and they will take the configurable properties into account. Run ant -pfor more details.

构建脚本中的其它target可以单独的调用，它们将获取相应的配置文件信息。运行ant –p 来查看详细的信息。

 

These are the demo users:

示例用户如下：

Table 2.1. The demo users

UserId	Password	Security roles
kermit	Kermit	admin
gonzo	Gonzo	manager
fozzie	Fozzie	user

 

Now you can access following web applications:

现在你可以通过下面的链接来访问应用了：

Table 2.2. The webapp tools

Webapp Name	URL	Description
Activiti Probe	http://localhost:8080/activiti-probe	The admin management console. Use this tool to see if the configured process engine is correctly initialized, DB tables contents. 管理控制台。通过该工具可以查看流程引擎配置是否正确被安装，数据库中表的内容。
Activiti Explorer	http://localhost:8080/activiti-explorer	The process engine user console. Use this tool to view your personal and candidate task lists and to complete tasks. 用户控制台。使用该工具可以查看个人任务、待确定任务列表，也可以完成任务。
Activiti Cycle	http://localhost:8080/activiti-cycle	The process cycle layer. Use this to browse repositories, execute transformations between model formats. 流程循环层。使用该工具可以查看流程定义？？
Activiti Modeler powered by Signavio	http://localhost:8080/activiti-modeler	The web based process designer tool. Use this tool to graphically author BPMN 2.0 compliant process definitions files. 基于Web的流程定义工具。使用该工具可以生成符合BPMN2.0的流程定义文件。

 

Examples

示例

The distribution contains example source code that show different types of usages of Activiti and their library dependencies. The examples are grouped according to their dependencies.

发行包中所包含的示例源文件展示了Activiti的不同应用方式以及这些应用方式的依赖包。示例已经对它们依赖的包进行了有效的分组。

 

The distribution doesn't contain the library dependencies out-of-the-box, but the next section shows how the setup script can automatically download and organize the library dependencies. The examples directory in the root of the distribution contains these types of examples:

发行包中不包含额外的依赖包，在下一节中将展示安装脚本如何自动的下载和组织所依赖的包。发行包的examples目录下包含了以下示例：

 

• activiti-engine: This set of examples show the most common usage of Activiti: BPMN process definitions and process executions are stored in a DB and the examples make use of the persistent API.
• activiti-engine: 该系列的示例展示了Activiti:BPMN的常规用法，流程定义和流程实例都将存储在数据库中。示例还使用了持久化API。
• activiti-spring: These examples show how you can use the Activiti Engine in a Spring environment.
• activiti-spring: 该示例展示了如何在Spring环境中使用Activiti引擎。
• activiti-pvm These examples show the bare bones Process Virtual Machine. No persistence, no process language. This is the basis for building your own process language and engine.
• activiti-pvm : 该示例展示了最核心的流程虚拟机。没有持久化，没有流程语言。使用该基础你可以构建自己的流程语言和引擎。

Library dependencies

依赖包

Activiti takes great care in minimizing library dependencies. The 3rd party library dependencies are not included in the Activiti download to reduce the download size, but the setup script can download and organize the library dependencies for those examples that you want to explore.

Activiti尽量缩小对其它的依赖。为了减少下载的大小Activiti发行包中不包含第三方依赖包，但是在示例安装脚本中可以自动下载和组织相应的依赖包。

 

Fetching the library dependencies is included in the demo.setup

依赖包的获取已经包含在demo.setup target中。

 

To download the library dependencies, use one of these targets in the ant setup/build.xml file:

你可以通过setup/build.xml以下target获取相应的依赖包：

• examples.get.libs.all
• examples.get.libs.engine
• examples.get.libs.spring
• exam