activity工作流学习

<?xml version='1.0' encoding='UTF-8'?>
<definitions xmlns="http://www.omg.org/spec/BPMN/20100524/MODEL" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:activiti="http://activiti.org/bpmn" xmlns:bpmndi="http://www.omg.org/spec/BPMN/20100524/DI" xmlns:omgdc="http://www.omg.org/spec/DD/20100524/DC" xmlns:omgdi="http://www.omg.org/spec/DD/20100524/DI" typeLanguage="http://www.w3.org/2001/XMLSchema" expressionLanguage="http://www.w3.org/1999/XPath" targetNamespace="demo">
  <process id="contractChangeRecordClerkApproval" name="合同变更备案会审" isExecutable="true">
    <startEvent id="sid-hVaMBiCR-Y7XR-4BLN-8Ete-Gv89wktAWF" name="开始" activiti:initiator="initiator" activiti:formKey="/change/change_edit.html">
      <extensionElements>
        <activiti:formProperty id="contractId" name="合同ID" type="string"/>
        <activiti:formProperty id="docType" name="单据类型" type="string"/>
      </extensionElements>
    </startEvent>
    <userTask id="ContractChangeRecordId" name="备案员" activiti:formKey="/change/change_edit.html">
      <extensionElements>
        <activiti:formProperty id="APPROVAL_STRATEGY" name="SINGLE_APPROVAL" type="string"/>
        <activiti:formProperty id="APPROVAL_CANDIDATE_RULE" type="enum">
          <activiti:value id="Record_Clerk" name="{&quot;parameter&quot;:[],&quot;businessRules&quot;:[]}"/>
        </activiti:formProperty>
        <activiti:taskListener event="complete" class="com.hand.ocbm.activity.components.ContractApprovalListener"/>
      </extensionElements>
    </userTask>
    <endEvent id="sid-zhx9QmNs-LlAc-4Us3-84tV-GiaWYigpiAns" name="结束">
      <extensionElements>
        <activiti:executionListener event="end" class="com.hand.ocbm.activity.components.ApprovalResultHandle"/>
      </extensionElements>
    </endEvent>
    <sequenceFlow id="sid-EF515887-C4AA-49B5-9C62-90F23AF950DC" sourceRef="sid-hVaMBiCR-Y7XR-4BLN-8Ete-Gv89wktAWF" targetRef="ContractChangeRecordId"/>
    <sequenceFlow id="sid-1D37BD6C-FF07-4890-9CF5-7ABB376DC7BB" sourceRef="ContractChangeRecordId" targetRef="sid-zhx9QmNs-LlAc-4Us3-84tV-GiaWYigpiAns"/>
  </process>
  <bpmndi:BPMNDiagram id="BPMNDiagram_contractChangeRecordClerkApproval">
    <bpmndi:BPMNPlane bpmnElement="contractChangeRecordClerkApproval" id="BPMNPlane_contractChangeRecordClerkApproval">
      <bpmndi:BPMNShape bpmnElement="sid-hVaMBiCR-Y7XR-4BLN-8Ete-Gv89wktAWF" id="BPMNShape_sid-hVaMBiCR-Y7XR-4BLN-8Ete-Gv89wktAWF">
        <omgdc:Bounds height="30.0" width="30.0" x="224.015625" y="363.0"/>
      </bpmndi:BPMNShape>
      <bpmndi:BPMNShape bpmnElement="ContractChangeRecordId" id="BPMNShape_ContractChangeRecordId">
        <omgdc:Bounds height="80.0" width="100.0" x="405.0" y="338.0"/>
      </bpmndi:BPMNShape>
      <bpmndi:BPMNShape bpmnElement="sid-zhx9QmNs-LlAc-4Us3-84tV-GiaWYigpiAns" id="BPMNShape_sid-zhx9QmNs-LlAc-4Us3-84tV-GiaWYigpiAns">
        <omgdc:Bounds height="28.0" width="28.0" x="645.0" y="364.0"/>
      </bpmndi:BPMNShape>
      <bpmndi:BPMNEdge bpmnElement="sid-EF515887-C4AA-49B5-9C62-90F23AF950DC" id="BPMNEdge_sid-EF515887-C4AA-49B5-9C62-90F23AF950DC">
        <omgdi:waypoint x="254.015625" y="378.0"/>
        <omgdi:waypoint x="405.0" y="378.0"/>
      </bpmndi:BPMNEdge>
      <bpmndi:BPMNEdge bpmnElement="sid-1D37BD6C-FF07-4890-9CF5-7ABB376DC7BB" id="BPMNEdge_sid-1D37BD6C-FF07-4890-9CF5-7ABB376DC7BB">
        <omgdi:waypoint x="505.0" y="378.0"/>
        <omgdi:waypoint x="645.0" y="378.0"/>
      </bpmndi:BPMNEdge>
    </bpmndi:BPMNPlane>
  </bpmndi:BPMNDiagram>
</definitions>

个人理解：
1，<process id="contractChangeRecordClerkApproval" name="合同变更备案会审" isExecutable="true">
contractChangeRecordClerkApproval：流程实例唯一标志

2，
    <startEvent id="sid-hVaMBiCR-Y7XR-4BLN-8Ete-Gv89wktAWF" name="开始" activiti:initiator="initiator" activiti:formKey="/change/change_edit.html">
      <extensionElements>
        <activiti:formProperty id="contractId" name="合同ID" type="string"/>
        <activiti:formProperty id="docType" name="单据类型" type="string"/>
      </extensionElements>
    </startEvent>
	流程启动后这两个属性都会保存到表单作用域--   DelegateTask接口中有对表单操作的属性方法

3，<activiti:formProperty id="contractId" name="合同ID" type="string"/>
        <activiti:formProperty id="docType" name="单据类型" type="string"/>
		启动流程时所需的参数，参数缺失，流程会启动失败！
		
4， <userTask id="ContractChangeRecordId" name="备案员" activiti:formKey="/change/change_edit.html">
      <extensionElements>
        <activiti:formProperty id="APPROVAL_STRATEGY" name="SINGLE_APPROVAL" type="string"/>
        <activiti:formProperty id="APPROVAL_CANDIDATE_RULE" type="enum">
          <activiti:value id="Record_Clerk" name="{&quot;parameter&quot;:[],&quot;businessRules&quot;:[]}"/>
        </activiti:formProperty>
        <activiti:taskListener event="complete" class="com.hand.ocbm.activity.components.ContractApprovalListener"/>
      </extensionElements>
    </userTask>		
	
执行任务时的节点，以及节点监听器	ContractApprovalListener继承TaskListener（节点监听器） event="complete"该节点审批完成后触发  还需要实现notify方法（监听器默认调用该方法进醒逻辑处理）

5，    <endEvent id="sid-zhx9QmNs-LlAc-4Us3-84tV-GiaWYigpiAns" name="结束">
      <extensionElements>
        <activiti:executionListener event="end" class="com.hand.ocbm.activity.components.ApprovalResultHandle"/>
      </extensionElements>
    </endEvent>
	
结束时的全局监听器	

event="end"  代表整个流程结束之后触发 ApprovalResultHandle继承 ExecutionListener（全局监听器） 还需要实现notify方法（监听器默认调用该方法进行逻辑处理）

6，整个配置文件可以将它当做是一个表单

1.一体式：把整个流程涉及到的表单放在一个文件然后根据处理的任务名称匹配显示，kft-activiti-demo的普通表单模式就是一体式的做法，把表单内容封装在一个div里面，
div的ID以节点的名称命名，点击“办理”按钮时用对话框的方式把div的内容显示给用户。

2.分离式：对于非Ajax应用来说比较常用，每个任务对应一个页面文件，点击办理的时候根据任务的ID动态指定表单页面。 （合同系统）

https://blog.csdn.net/qq_30739519/article/details/51258447（监听器的使用）

GitHub:https://github.com/Activiti/Activiti

常见操作：

1，任务转交：
						taskService.setAssignee(tasks.get(0).getId(),审批人id);

2，查询已创建的流程：List<HistoricProcessInstance> instances = processEngine.getHistoryService().createHistoricProcessInstanceQuery().processInstanceBusinessKey(key)
                           .orderByProcessInstanceStartTime().desc().list();
3，查询任务：
							List<Task> tasks = taskService.createTaskQuery().processInstanceId(instances.get(0).getId()).orderByTaskId().desc().list();
4，创建流程：processEngine.getRuntimeService().startProcessInstanceById(标志)