1、对流程设计器的使用说明

打开菜单Windows->Preferences->Activiti->Save下流程流程图片的生成方式:

虽然流程引擎在单独部署bpmn文件时会自动生成图片，但在实际开发过程中，自动生成的图片会导致和BPMN中的坐标有出入，在实际项目中展示流程当前位置图会有问题。

所在完成以上配置后，会由我们自己来管理流程图片。在发布流程时把流程规则文件和流程图片一起上传就行了。

2、数据库

Activiti的后台是有数据库的支持，所有的表都以ACT_开头。 第二部分是表示表的用途的两个字母标识。 用途也和服务的API对应。

1)        ACT_RE_*: 'RE'表示repository。 这个前缀的表包含了流程定义和流程静态资源 （图片，规则，等等）。

2)        ACT_RU_*: 'RU'表示runtime。 这些运行时的表，包含流程实例，任务，变量，异步任务，等运行中的数据。 Activiti只在流程实例执行过程中保存这些数据， 在流程结束时就会删除这些记录。 这样运行时表可以一直很小速度很快。

3)        ACT_ID_*: 'ID'表示identity。 这些表包含身份信息，比如用户，组等等。

4)        ACT_HI_*: 'HI'表示history。 这些表包含历史数据，比如历史流程实例， 变量，任务等等。

5)        ACT_GE_*: 通用数据， 用于不同场景下。

3、  资源库流程规则表

1)           act_re_deployment      部署信息表

2)         act_re_model          流程设计模型部署表

3)         act_re_procdef       流程定义数据表

4、运行时数据库表

1)         act_ru_execution     运行时流程执行实例表

2)         act_ru_identitylink   运行时流程人员表，主要存储任务节点与参与者的相关信息

3)         act_ru_task                运行时任务节点表

4)         act_ru_variable         运行时流程变量数据表

5、历史数据库表

1)         act_hi_actinst           历史节点表

2)         act_hi_attachment             历史附件表

3)         act_hi_comment                历史意见表

4)         act_hi_identitylink             历史流程人员表

5)         act_hi_detail                       历史详情表，提供历史变量的查询

6)         act_hi_procinst                   历史流程实例表

7)         act_hi_taskinst           历史任务实例表

8)         act_hi_varinst            历史变量表

6、组织机构表

1. act_id_group             用户组信息表

2. act_id_info                 用户扩展信息表

3. act_id_membership 用户与用户组对应信息表

4. act_id_user                用户信息表

这四张表很常见，基本的组织机构管理，关于用户认证方面建议还是自己开发一套，组件自带的功能太简单，使用中有很多需求难以满足

7、通用数据表

1. act_ge_bytearray               二进制数据表

2. act_ge_property                属性数据表存储整个流程引擎级别的数据,初始化表结构时，会默认插入三条记录，

8、activiti.cfg.xml

Activiti核心配置文件，配置流程引擎创建工具的基本参数和数据库连接池参数。

定义数据库配置参数：

l  jdbcUrl: 数据库的JDBC URL。

l  jdbcDriver: 对应不同数据库类型的驱动。

l  jdbcUsername: 连接数据库的用户名。

l  jdbcPassword: 连接数据库的密码。

基于JDBC参数配置的数据库连接 会使用默认的MyBatis连接池。 下面的参数可以用来配置连接池（来自MyBatis参数）：

l  jdbcMaxActiveConnections: 连接池中处于被使用状态的连接的最大值。默认为10。

l  jdbcMaxIdleConnections: 连接池中处于空闲状态的连接的最大值。

l  jdbcMaxCheckoutTime: 连接被取出使用的最长时间，超过时间会被强制回收。 默认为20000（20秒）。

l  jdbcMaxWaitTime: 这是一个底层配置，让连接池可以在长时间无法获得连接时， 打印一条日志，并重新尝试获取一个连接。（避免因为错误配置导致沉默的操作失败）。 默认为20000（20秒）。

9、  在spring、mybatis集成activiti时，注意mybatis与activiti版本冲突问题，如后台报”order by order by”错误时，原因就是由于mybatis和spring版本的冲突问题。如下图

### The error may exist in org/activiti/db/mapping/entity/ProcessDefinition.xml
### The error may involve org.activiti.engine.impl.persistence.entity.ProcessDefinitionEntity.selectProcessDefinitionsByQueryCriteria_mysql
### The error occurred while executing a query
### SQL: select distinct RES.*              from ACT_RE_PROCDEF RES            WHERE  RES.VERSION_ = (select max(VERSION_) from ACT_RE_PROCDEF where KEY_ = RES.KEY_                                              )           order by  order by RES.DEPLOYMENT_ID_ desc       LIMIT ? OFFSET ?
### Cause: java.sql.SQLException: sql injection violation, syntax error: syntax error, error in :'rder by RES.DEPLOYMENT_ID_ desc  
 ',expect BY, actual BY by : select distinct RES.* 
           from ACT_RE_PROCDEF RES
          WHERE  RES.VERSION_ = (select max(VERSION_) from ACT_RE_PROCDEF where KEY_ = RES.KEY_ 
                ) 
        order by  order by RES.DEPLOYMENT_ID_ desc  
    LIMIT ? OFFSET ?

10、 引擎api

processEngine processEngine = ProcessEngines.getDefaultProcessEngine();
RuntimeService runtimeService = processEngine.getRuntimeService();
RepositoryService repositoryService = processEngine.getRepositoryService();
TaskService taskService = processEngine.getTaskService();
ManagementService managementService = processEngine.getManagementService();
IdentityService identityService = processEngine.getIdentityService();
HistoryService historyService = processEngine.getHistoryService();
FormService formService = processEngine.getFormService()；

processEngines.getDefaultProcessEngine()会在第一次被调用时初始并构建 process engine， 接下来对该方法的调用返回的都是同一个流程引擎。 利用 ProcessEngines.init()、 ProcessEngines.destroy()可以正确创建、关闭流程引擎。ProcessEngines 会浏览所有 activiti.cfg.xml 和 activiti-context.xml 文件。对于那些 activiti.cfg.xml 文件， 将以 Activiti 特有的方式来构建流程引擎：

ProcessEngineConfiguration.createProcessEngineConfigurationFromInputStream(inputStream).buildProcessEngine()。 对于那些activiti-context.xml 文件， 将以 Spring 的方式来构建流程引擎：首先，创建 spring 应用上下文；然后，从该上下文中获取
流程引擎。

11、 spring集成activiti：

12、  

<!-- 加载activiti引擎 -->
<bean id="processEngine" class="org.activiti.spring.ProcessEngineFactoryBean">
   <property name="processEngineConfiguration" ref="processEngineConfiguration" />
</bean>
<bean id="processEngineConfiguration"
     class="org.activiti.spring.SpringProcessEngineConfiguration">
   <property name="dataSource" ref="druidDataSource" />
   <property name="transactionManager" ref="transactionManager" />
   <property name="databaseSchemaUpdate" value="true" />
   <property name="jobExecutorActivate" value="false" />
</bean>
<!-- activiti的各种服务接口 -->
<bean id="repositoryService" factory-bean="processEngine" factory-method="getRepositoryService" />
<bean id="runtimeService" factory-bean="processEngine" factory-method="getRuntimeService" />
<bean id="taskService" factory-bean="processEngine" factory-method="getTaskService" />
<bean id="historyService" factory-bean="processEngine" factory-method="getHistoryService" />
<bean id="managementService" factory-bean="processEngine" factory-method="getManagementService" />
<!-- Druid连接池-->
<bean id="druidDataSource" class="com.alibaba.druid.pool.DruidDataSource" init-method="init" destroy-method="close">
    <!-- 基本属性 url、user、password -->
    <property name="url" value="${url}" />
    <property name="username" value="${username}" />
    <property name="password" value="${password}" />
    <!-- 配置初始化大小、最小、最大 -->
    <property name="initialSize" value="1" />
    <property name="minIdle" value="1" />
    <property name="maxActive" value="20" />
    <!-- 配置获取连接等待超时的时间 -->
    <property name="maxWait" value="60000" />
    <!-- 配置间隔多久才进行一次检测，检测需要关闭的空闲连接，单位是毫秒 -->
    <property name="timeBetweenEvictionRunsMillis" value="60000" />
    <!-- 配置一个连接在池中最小生存的时间，单位是毫秒 -->
    <property name="minEvictableIdleTimeMillis" value="300000" />
    <property name="validationQuery" value="SELECT 1" />
    <property name="testWhileIdle" value="true" />
    <property name="testOnBorrow" value="false" />
    <property name="testOnReturn" value="false" />
    <!-- 打开PSCache，并且指定每个连接上PSCache的大小 -->
    <property name="poolPreparedStatements" value="false" />
    <property name="maxPoolPreparedStatementPerConnectionSize" value="20" />
    <!-- 配置监控统计拦截的filters，默认stat，可选mergeStat/wall/log4j -->
    <property name="filters" value="stat,wall,log4j" />
    <property name="proxyFilters">
        <list>
            <ref bean="mergeStat_filter" />
            <ref bean="log4j-filter" />
        </list>
    </property>
</bean>
<!--事务管理-->
<bean id="transactionManager"
      class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
    <property name="dataSource" ref="druidDataSource" />
</bean>

13、 流程变量：在流程实例中，可以将PO对象作为流程变量与流程实例进行关联，不过一定要实现Serializable接口。也可以将po主键作为业务key，在启动流程实例的时候与流程实例建立双向关联：PrcoessInstance processInstance = runtimeService.startProcessInstanceByKey(processDefinitionKey, businessKey, variables);