Activiti个人总结

1,工作流(Workflow)，就是“业务过程的部分或整体在计算机应用环境下的自动化”，它主要解决的是“使在多个参与者之间按照某种预定义的规则传递文档、信息或任务的过程自动进行，从而实现某个预期的业务目标，或者促使此目标的实现”。
工作流管理系统(Workflow Management System, WfMS)是一个软件系统，它完成工作量的定义和管理，并按照在系统中预先定义好的工作流规则进行工作流实例的执行。工作流管理系统不是企业的业务系统，而是为企业的业务系统的运行提供了一个软件的支撑环境。
工作流管理联盟(WfMC，Workflow Management Coalition)给出的关于工作流管理系统的定义是：工作流管理系统是一个软件系统，它通过执行经过计算的流程定义去支持一批专门设定的业务流程。工作流管理系统被用来定义、管理、和执行工作流程。
工作流管理系统的目标：管理工作的流程以确保工作在正确的时间被期望的人员所执行——在自动化进行的业务过程中插入人工的执行和干预。
2.Activiti介绍
Activiti5是由Alfresco软件在2010年5月17日发布的业务流程管理（BPM）框架，它是覆盖了业务流程管理、工作流、服务协作等领域的一个开源的、灵活的、易扩展的可执行流程语言框架。Activiti基于Apache许可的开源BPM平台，创始人Tom Baeyens是JBoss jBPM的项目架构师，它特色是提供了eclipse插件，开发人员可以通过插件直接绘画出业务
2.1：工作流引擎
ProcessEngine对象，这是Activiti工作的核心。负责生成流程运行时的各种实例及数据、监控和管理流程的运行。
3.2：BPMN
业务流程建模与标注（Business Process Model and Notation，BPMN) ，描述流程的基本符号，包括这些图元如何组合成一个业务流程图（Business Process Diagram）

2.2：数据库（先了解后看）
Activiti数据库支持：
Activiti的后台是有数据库的支持，所有的表都以ACT_开头。 第二部分是表示表的用途的两个字母标识。 用途也和服务的API对应。
ACT_RE_: ‘RE’表示repository。 这个前缀的表包含了流程定义和流程静态资源 （图片，规则，等等）。
ACT_RU_: ‘RU’表示runtime。 这些运行时的表，包含流程实例，任务，变量，异步任务，等运行中的数据。 Activiti只在流程实例执行过程中保存这些数据， 在流程结束时就会删除这些记录。 这样运行时表可以一直很小速度很快。
ACT_ID_: ‘ID’表示identity。 这些表包含身份信息，比如用户，组等等。
ACT_HI_: ‘HI’表示history。 这些表包含历史数据，比如历史流程实例， 变量，任务等等。
ACT_GE_*: 通用数据， 用于不同场景下，如存放资源文件。

表结构操作：
2.3.1：资源库流程规则表

1. act_re_deployment 部署信息表

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

3. act_re_procdef 流程定义数据表
   2.3.2：运行时数据库表

4. act_ru_execution 运行时流程执行实例表

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

6. act_ru_task 运行时任务节点表

7. act_ru_variable 运行时流程变量数据表
   2.3.3：历史数据库表

8. act_hi_actinst 历史节点表

9. act_hi_attachment 历史附件表

10. act_ih_comment 历史意见表

11. act_hi_identitylink 历史流程人员表

12. act_hi_detail 历史详情表，提供历史变量的查询

13. act_hi_procinst 历史流程实例表

14. act_hi_taskinst 历史任务实例表

15. act_hi_varinst 历史变量表
    2.3.4：组织机构表

16. act_id_group 用户组信息表

17. act_id_info 用户扩展信息表

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

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

20. act_ge_bytearray 二进制数据表

21. act_ge_property 属性数据表存储整个流程引擎级别的数据,初始化表结构时，会默认插入三条记录，
    2.4：activiti.cfg.xml（activiti的配置文件）
    Activiti核心配置文件，配置流程引擎创建工具的基本参数和数据库连接池参数。
    定义数据库配置参数：
     jdbcUrl: 数据库的JDBC URL。
     jdbcDriver: 对应不同数据库类型的驱动。
     jdbcUsername: 连接数据库的用户名。
     jdbcPassword: 连接数据库的密码。
    基于JDBC参数配置的数据库连接 会使用默认的MyBatis连接池。 下面的参数可以用来配置连接池（来自MyBatis参数）：
     jdbcMaxActiveConnections: 连接池中处于被使用状态的连接的最大值。默认为10。
     jdbcMaxIdleConnections: 连接池中处于空闲状态的连接的最大值。
     jdbcMaxCheckoutTime: 连接被取出使用的最长时间，超过时间会被强制回收。 默认为20000（20秒）。
     jdbcMaxWaitTime: 这是一个底层配置，让连接池可以在长时间无法获得连接时， 打印一条日志，并重新尝试获取一个连接。
    3:运行环境
    3.1)JDK1.6或者更高版本

22. 支持的数据库有：h2, mysql, oracle, postgres, mssql, db2等。

23. 支持activiti5运行的jar包
    4：相关资源下载
    4.1)Activiti插件安装请参考这篇博客 https://blog.csdn.net/lovemenghaibin/article/details/50568858
    4.2：准备Activiti5开发环境
    4.2.1：添加Activiti5的jar包
    在activiti-5.13->wars目录下是一些示例项目，解压activiti-rest项目，导入activiti-rest目录中WEB-INF\lib下所有包。添加到classpath中。
    由于我们使用的是Mysql数据库，Mysql数据库的链接驱动Activiti官方包中并没有提供，需要我们自己导入。手动导入mysql-connector-java.jar，添加到classpath下。
    准备流程图
    
    4.2.2:初始化数据库
    (1):不利用配置文件创建Activiti所有的表
    @Test
    public void createTable() {
    //创建activiti配置对象的实例
    ProcessEngineConfiguration configuration=ProcessEngineConfiguration.createStandaloneProcessEngineConfiguration();
    //设置数据库信息
    configuration.setJdbcUrl(“jdbc:mysql://localhost:3306/activiti”);//对应自己的数据库
    //设置数据库驱动
    configuration.setJdbcDriver(“com.mysql.jdbc.Driver”);
    //设置用户名
    configuration.setJdbcUsername(“username”);//数据库连接用户名
    configuration.setJdbcPassword(“password”);//数据库连接密码
    //*
    * 设置数据库建表策略
    //
    configuration.setDatabaseSchemaUpdate(ProcessEngineConfiguration.DB_SCHEMA_UPDATE_TRUE);
    //使用配置对象创建流程实例
    ProcessEngine processEngine = configuration.buildProcessEngine();
    System.out.println(processEngine);
    }
    (2):利用配置文件初始化数据库
    
    @Test
    public void createTableConfig() {
    ProcessEngine processEngine = ProcessEngineConfiguration.createProcessEngineConfigurationFromResource(“activiti-context.xml”)
    .buildProcessEngine();
    }
    (3)流程定义 操作的是 re开头的表,还有两张进制表
    @Test
    public void deploy() {
    ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
    //RepositoryService 部署实例
    Deployment deploy = processEngine.getRepositoryService().createDeployment()
    .addClasspathResource(“qjlc.bpmn”)
    .addClasspathResource(“qjlc.png”).name(“请假申请”)
    .deploy();
    System.out.println(“流程部署id:”+deploy.getId()+“流程部署名称:”+deploy.getName());
    }
    (4) 启动流程实例 runtimeService 操作ru表
    @Test
    public void startProcess() {
    //String processDefinitionKey=“不想上班”;
    ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
    //得到runtimeService 运行实例
    //启动流程实例,根据流程定义的key启动流程实例,默认会安按照最最新版本部署
    ProcessInstance pi = processEngine.getRuntimeService().startProcessInstanceByKey(“myProcess”);
    System.out.println(“流程实例id”+pi.getId()+“流程实例名称:”+pi.getActivityId()+“进程id”+pi.getProcessInstanceId());
    }
    (5) 查看个人任务
    @Test
    public void queryMyTask() {
    //获取流程引擎对象
    ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
    List list = processEngine.getTaskService().createTaskQuery()
    //.taskAssignee(assignee)//指定任务人
    .list();
    for(Task task:list) {
    System.out.println(“任务id:”+task.getId()+“任务名称”+task.getName()+“任务办理人:”+task.getAssignee());
    }
    }
    (6)办理个人任务 操作ru_task表
    @Test
    public void completeTask() {
    ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
    List list = processEngine.getTaskService().createTaskQuery()
    //.taskAssignee(assignee)//指定任务人
    .list();
    for(Task task:list) {
    processEngine.getTaskService().complete(task.getId());
    }
    System.out.println(“任务办理完成”);
    }
    （7）查看流程实例
    @Test
    public void showDefine() {
    ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
    List list = processEngine.getRepositoryService().createProcessDefinitionQuery()
    .orderByProcessDefinitionVersion().asc()//查看流程版本号
    .list();
    for(ProcessDefinition pd:list) {
    System.out.println(“id:”+pd.getId());
    System.out.println(“id:”+pd.getDeploymentId());

     	System.out.println("name:"+pd.getName());
     	System.out.println("key:"+pd.getKey());
     	System.out.println("version:"+pd.getVersion());
     	System.out.println("resourceName:"+pd.getResourceName());
     	System.out.println("..............");
     }
    

    }
    （8）删除流程定义
    @Test
    public void deleteDeloyment() {
    ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
    RepositoryService repositoryService = processEngine.getRepositoryService();
    //两个参数,一个是部署流程id,一个是删除策略
    repositoryService.deleteDeployment(“101”,true);
    }
    （9）查看流程图片
    @Test
    public void showImage() throws IOException {
    //获取流程id
    String deloymentId=“601”;
    //得到核心驱动
    ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
    //通过流程id得到name值
    List resourceNames = processEngine.getRepositoryService()
    .getDeploymentResourceNames(deloymentId);
    String imageName=null;
    for(String name:resourceNames) {
    System.out.println(“name:”+name);
    //获取文件名
    if(name.indexOf(".png")>=0) {
    imageName=name;
    }
    }
    System.out.println(“imageName:”+imageName);
    if(imageName!=null) {
    //创建文件保存路径
    File file=new File(“e:/”+imageName);
    InputStream in = processEngine.getRepositoryService().getResourceAsStream(deloymentId,imageName);
    //将文件保存到创建的文件路径
    FileUtils.copyInputStreamToFile(in,file);
    }
    }
    (10)流程变量在整个工作流中扮演很重要的作用。例如：请假流程中有请假天数、请假原因等一些参数都为流程变量的范 围。流程变量的作用域范围是只对应一个流程实例。也就是说各个流程实例的流程变量是不相互影响的。流程实例结束完成以后流程变量还保存在数据库中。
    
    (11)设置流程变量
    @Test
    public void setVariables() {
    ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
    TaskService taskService = processEngine.getTaskService();
    //任务设置流程变量
    List list = processEngine.getTaskService().createTaskQuery().list();
    for(Task task:list) {
    taskService.setVariable(task.getId(),“请假人”,task.getAssignee());
    taskService.setVariableLocal(task.getId(),“请假天数”,6);
    taskService.setVariable(task.getId(),“请假日期”,new Date());
    }
    }
    （12）获取流程变量
    @Test
    public void getVariables() {
    ProcessEngine processEngine = ProcessEngines.getDefaultProcessEngine();
    TaskService taskService = processEngine.getTaskService();
    String assignee=“张三”;
    String prId=“1801”;
    Task task = taskService.createTaskQuery().taskAssignee(assignee)
    .processDefinitionId(prId)
    .singleResult();
    //String valueName = (String) taskService.getVariable(task.getId(),“请假人”);
    Integer valueName = (Integer) taskService.getVariableLocal(task.getId(),“请假天数”);
    System.out.println(valueName);
    }