Activiti 會簽

Activiti 會簽

在流程業(yè)務管理中，任務是通常都是由一個人去處理的，而多個人同時處理一個任務，這種任務我們稱之為會簽任務。這種業(yè)務需求很常見，如一個請款單，領導審批環(huán)節(jié)中，就需要多個部門領導簽字。在流程業(yè)務中，我們可以把每個領導簽字的環(huán)節(jié)都定義為任務，并且這個會簽的人員是不固定的，若固定的我們可以通過Activiti的并行任務或串行任務來處理。會簽的引入說明，無非就是為了流程流轉至某一環(huán)節(jié)點，其審批的人員是動態(tài)的，并且需要根據(jù)會簽審批的結果實現(xiàn)流程的不同流轉。

利用activiti實現(xiàn)會簽功能

實現(xiàn)步驟：首先在畫流程圖時，userTask 節(jié)點中有 多實例類型(multiinstance_type) 屬性（此屬性有兩個選項（默認空）：parallel（會簽，沒順序）、sequential（串簽，順序執(zhí)行）），選擇parallel以后設置集合（多實例）

image.png

生成的xml文件代碼：

<userTask id="s3" name="會簽">
   <multiInstanceLoopCharacteristics isSequential="false" activiti:collection="${userList}"/>
</userTask>

然后userList設置流程變量，或者監(jiān)聽器設置value

userTask節(jié)點配置核心屬性說明

  1. isSequential指定多實例是按照并行或者串行的方式進行，當isSequential=true時，表示的串行執(zhí)行，即雖然該節(jié)點有多條任務，但只有上一條執(zhí)行完，才可以執(zhí)行下一條。當isSequential=false時，表示的并行執(zhí)行，即該節(jié)點下的多條任務可以同時執(zhí)行，如三個人參與會簽，是三個人同時收到待辦，任務實例是同時產生的。

  2. activiti:collection：用于執(zhí)行該會簽環(huán)節(jié)的參與參與的人，可以用形如實例中的${leaderList}獲取，也可以用戶可以通過定義自身的服務類來獲取

  3. activiti:elementVariable：此處表示的是每一個分支都有一個名叫l(wèi)eader的流程變量和userTask節(jié)點屬性中的activiti:assignee="${leader}"一致

  4. completionCondition：指定會簽環(huán)節(jié)的結束條件，表示是任務往下跳轉的完成條件，返回true是，表示條件成立，流程會跳至下一審批環(huán)節(jié)

會簽的種類：

  • 按數(shù)量通過： 達到一定數(shù)量的通過表決后，會簽通過。

  • 按比例通過： 達到一定比例的通過表決后，會簽通過。

  • 一票否決： 只要有一個表決時否定的，會簽通過。

  • 一票通過： 只要有一個表決通過的，會簽通過。

每個實例有以下變量：

  • nrOfInstances: 實例總數(shù)

  • nrOfActiveInstances: 當前激活的（未完成的）實例總數(shù)。 如果串行執(zhí)行，則改值永遠是1

  • nrOfCompletedInstances: 已完成的實例總數(shù) 條件nrOfInstances == nrOfCompletedInstances表示所有人員審批完成后會簽結束。 條件${ nrOfCompletedInstances == 1 }表示一個人完成審批，該會簽就結束。

其他條件依次類推，同時這里也可以寫自己添加的流程變量。

會簽（多實例節(jié)點）環(huán)節(jié)中涉及的幾個默認的流程變量

  1. nrOfInstances 該會簽環(huán)節(jié)中總共有多少個實例

  2. nrOfActiveInstances 當前活動的實例的數(shù)量，即還沒有 完成的實例數(shù)量。

  3. nrOfCompletedInstances 已經完成的實例的數(shù)量

會簽人員部分示例代碼

  1. 分配會簽人員
Map<String, Object> vars = new HashMap<>();
 List<String> leaderList = new ArrayList<>();
 leaderList.add("zhangsan");
 leaderList.add("lisi");
 leaderList.add("wangwu");

 vars.put("leaderList", leaderList);

 ProcessInstance processInstance = runtimeService.startProcessInstanceById(processDefinition.getId(), vars);
  1. 會簽人員審批
Map<String, Object> leaderOneAudit = new HashMap<>();
 Scanner scanner = new Scanner(System.in);
 System.out.println("請輸入領導審批意見。。。。");
 String auditOne = scanner.nextLine();
 leaderOneAudit.put("audit", auditOne);
 System.out.println("張三的審批意見為：" + (auditOne.equals("yes") ? "同意" : "不同意"));
 task = taskService.createTaskQuery().processInstanceId(processInstance.getId()).taskAssignee("zhangsan").singleResult();
 taskService.complete(task.getId(), leaderOneAudit);
  1. 示例代碼控制臺結果輸出
填寫申請|assignee:worker
請輸入領導審批意見。。。。
yes
張三的審批意見為：同意
流程實例總數(shù)：3
當前活動的流程實例總數(shù)：3
已經完成實例的數(shù)目：0
leader：zhangsan
---------------------------------------分隔線----------------------------------------------------
taskName2:領導審批|assignee:zhangsan
--------------------------------------------
請輸入領導審批意見。。。。
yes
李四的審批意見為：同意
流程實例總數(shù)：3
當前活動的流程實例總數(shù)：2
已經完成實例的數(shù)目：1
leader：lisi
---------------------------------------分隔線----------------------------------------------------
taskName3:領導審批|assignee:lisi
--------------------------------------------
請輸入領導審批意見。。。。
yes
李四的審批意見為：同意
流程實例總數(shù)：3
當前活動的流程實例總數(shù)：1
已經完成實例的數(shù)目：2
leader：wangwu
---------------------------------------分隔線----------------------------------------------------
taskName4:領導審批|assignee:wangwu
taskName5:人事歸檔|assignee:hr
----------------------------------流程實例流轉-----------------------
任務ID:75014
流程實例ID:75005
任務名稱：填寫申請
辦理人：worker
開始時間：Tue Jul 31 10:12:39 CST 2018
結束時間：Tue Jul 31 10:12:39 CST 2018
=================================
任務ID:75028
流程實例ID:75005
任務名稱：領導審批
辦理人：zhangsan
開始時間：Tue Jul 31 10:12:39 CST 2018
結束時間：Tue Jul 31 10:12:43 CST 2018
=================================
任務ID:75031
流程實例ID:75005
任務名稱：領導審批
辦理人：lisi
開始時間：Tue Jul 31 10:12:39 CST 2018
結束時間：Tue Jul 31 10:12:49 CST 2018
=================================
任務ID:75034
流程實例ID:75005
任務名稱：領導審批
辦理人：wangwu
開始時間：Tue Jul 31 10:12:39 CST 2018
結束時間：Tue Jul 31 10:12:56 CST 2018
=================================
任務ID:75038
流程實例ID:75005
任務名稱：人事歸檔
辦理人：hr
開始時間：Tue Jul 31 10:12:56 CST 2018
結束時間：Tue Jul 31 10:12:56 CST 2018
=================================

如何通過代碼設置多實例屬性

本例中的流程圖都是通過ide的插件畫出來，而在web開發(fā)中，如何通過代碼把會簽的多實例的屬性給實現(xiàn)出來,可能不同人有不同的實現(xiàn)方式。我這邊提供一種實現(xiàn)，廢話有點多，直接上代碼

  1. 設置會簽節(jié)點屬性
public static void setMultiInstance(String modelId, String nodelId) throws Exception {
 // 獲取模型
 byte[] mes = repositoryService.getModelEditorSource(modelId);
 // 轉換成JsonNode
 JsonNode jsonNode = objectMapper.readTree(mes);
 // 轉換成BpmnModel
 BpmnJsonConverter bpmnJsonConverter = new BpmnJsonConverter();
 BpmnModel bpmnModel = bpmnJsonConverter.convertToBpmnModel(jsonNode);
 // 獲取物理形態(tài)的流程
 Process process = bpmnModel.getProcesses().get(0);
 // 獲取節(jié)點信息
 FlowElement flowElement = process.getFlowElement(nodelId);
 // 只有人工任務才可以設置會簽節(jié)點
 UserTask userTask = (UserTask) flowElement;
 // 設置受理人，這里應該和ElementVariable的值是相同的
 userTask.setAssignee("${" + Constant.ACT_MUIT_VAR_NAME + "}");
 // userTask.setOwner("${user}");

 // 獲取多實例配置
 MultiInstanceLoopCharacteristics characteristics = new MultiInstanceLoopCharacteristics();
 // 設置集合變量，統(tǒng)一設置成users
 characteristics.setInputDataItem(Constant.ACT_MUIT_LIST_NAME);
 // 設置變量
 characteristics.setElementVariable(Constant.ACT_MUIT_VAR_NAME);
 // 設置為同時接收（false 表示不按順序執(zhí)行）
 characteristics.setSequential(false);
 // 設置條件（暫時處理成，全部會簽完轉下步）
 characteristics.setCompletionCondition("${nrOfCompletedInstances==nrOfInstances}");

 userTask.setLoopCharacteristics(characteristics);
 // 保存
 ObjectNode objectNode = new BpmnJsonConverter().convertToJson(bpmnModel);
 repositoryService.addModelEditorSource(modelId, objectNode.toString().getBytes("utf-8"));
 }
  1. 清空會簽屬性
public static void clearMultiInstance(String modelId, String nodelId) throws Exception {
 // 獲取模型
 byte[] mes = repositoryService.getModelEditorSource(modelId);
 // 轉換成JsonNode
 JsonNode jsonNode = new ObjectMapper().readTree(mes);
 // 轉換成BpmnModel
 BpmnJsonConverter bpmnJsonConverter = new BpmnJsonConverter();
 BpmnModel bpmnModel = bpmnJsonConverter.convertToBpmnModel(jsonNode);
 // 獲取物理形態(tài)的流程
 Process process = bpmnModel.getProcesses().get(0);
 // 獲取節(jié)點信息
 FlowElement flowElement = process.getFlowElement(nodelId);
 // 只有人工任務才可以設置會簽節(jié)點
 UserTask userTask = (UserTask) flowElement;
 // 清空受理人
 userTask.setAssignee("");
 // 獲取多實例配置
 MultiInstanceLoopCharacteristics characteristics = userTask.getLoopCharacteristics();
 if (characteristics != null) {
 // 清空集合
 characteristics.setInputDataItem("");
 // 清空變量
 characteristics.setElementVariable("");
 // 設置為順序接收（true 表示不按順序執(zhí)行）
 characteristics.setSequential(true);
 // 清空條件
 characteristics.setCompletionCondition("");
 }

 // 保存
 ObjectNode objectNode = new BpmnJsonConverter().convertToJson(bpmnModel);
 repositoryService.addModelEditorSource(modelId, objectNode.toString().getBytes("utf-8"));
 }

http://www.itdecent.cn/p/bcfd2a31abb4

?著作權歸作者所有,轉載或內容合作請聯(lián)系作者
【社區(qū)內容提示】社區(qū)部分內容疑似由AI輔助生成，瀏覽時請結合常識與多方信息審慎甄別。
平臺聲明：文章內容（如有圖片或視頻亦包括在內）由作者上傳并發(fā)布，文章內容僅代表作者本人觀點，簡書系信息發(fā)布平臺，僅提供信息存儲服務。

相關閱讀更多精彩內容

友情鏈接更多精彩內容