Activiti 會簽
在流程業(yè)務(wù)管理中嚎莉，任務(wù)是通常都是由一個人去處理的腿椎，而多個人同時處理一個任務(wù)桌硫，這種任務(wù)我們稱之為會簽任務(wù)。這種業(yè)務(wù)需求很常見啃炸，如一個請款單铆隘，領(lǐng)導(dǎo)審批環(huán)節(jié)中，就需要多個部門領(lǐng)導(dǎo)簽字南用。在流程業(yè)務(wù)中膀钠，我們可以把每個領(lǐng)導(dǎo)簽字的環(huán)節(jié)都定義為任務(wù)，并且這個會簽的人員是不固定的裹虫，若固定的我們可以通過Activiti的并行任務(wù)或串行任務(wù)來處理肿嘲。會簽的引入說明，無非就是為了流程流轉(zhuǎn)至某一環(huán)節(jié)點(diǎn)筑公，其審批的人員是動態(tài)的雳窟，并且需要根據(jù)會簽審批的結(jié)果實(shí)現(xiàn)流程的不同流轉(zhuǎn)。
利用activiti實(shí)現(xiàn)會簽功能
實(shí)現(xiàn)步驟：首先在畫流程圖時匣屡，userTask 節(jié)點(diǎn)中有
多實(shí)例類型(multiinstance_type)屬性（此屬性有兩個選項(xiàng)（默認(rèn)空）：parallel（會簽封救，沒順序）、sequential（串簽捣作，順序執(zhí)行））誉结，選擇parallel以后設(shè)置集合（多實(shí)例）
生成的xml文件代碼：
<userTask id="s3" name="會簽">
<multiInstanceLoopCharacteristics isSequential="false" activiti:collection="${userList}"/>
</userTask>
然后userList設(shè)置流程變量，或者監(jiān)聽器設(shè)置value
userTask節(jié)點(diǎn)配置核心屬性說明
isSequential指定多實(shí)例是按照并行或者串行的方式進(jìn)行虾宇，當(dāng)isSequential=true時搓彻，表示的串行執(zhí)行如绸，即雖然該節(jié)點(diǎn)有多條任務(wù)嘱朽，但只有上一條執(zhí)行完旭贬，才可以執(zhí)行下一條。當(dāng)isSequential=false時搪泳，表示的并行執(zhí)行稀轨，即該節(jié)點(diǎn)下的多條任務(wù)可以同時執(zhí)行，如三個人參與會簽岸军，是三個人同時收到待辦奋刽，任務(wù)實(shí)例是同時產(chǎn)生的。
activiti:collection：用于執(zhí)行該會簽環(huán)節(jié)的參與參與的人艰赞，可以用形如實(shí)例中的${leaderList}獲取佣谐，也可以用戶可以通過定義自身的服務(wù)類來獲取
activiti:elementVariable：此處表示的是每一個分支都有一個名叫l(wèi)eader的流程變量和userTask節(jié)點(diǎn)屬性中的activiti:assignee="${leader}"一致
completionCondition：指定會簽環(huán)節(jié)的結(jié)束條件，表示是任務(wù)往下跳轉(zhuǎn)的完成條件方妖，返回true是狭魂，表示條件成立，流程會跳至下一審批環(huán)節(jié)
會簽的種類：
按數(shù)量通過： 達(dá)到一定數(shù)量的通過表決后党觅，會簽通過雌澄。
按比例通過： 達(dá)到一定比例的通過表決后，會簽通過杯瞻。
一票否決： 只要有一個表決時否定的镐牺，會簽通過。
一票通過： 只要有一個表決通過的魁莉，會簽通過睬涧。
每個實(shí)例有以下變量：
nrOfInstances: 實(shí)例總數(shù)
nrOfActiveInstances: 當(dāng)前激活的（未完成的）實(shí)例總數(shù)。 如果串行執(zhí)行旗唁，則改值永遠(yuǎn)是1
nrOfCompletedInstances: 已完成的實(shí)例總數(shù) 條件nrOfInstances == nrOfCompletedInstances表示所有人員審批完成后會簽結(jié)束宙地。 條件${ nrOfCompletedInstances == 1 }表示一個人完成審批，該會簽就結(jié)束逆皮。
其他條件依次類推宅粥，同時這里也可以寫自己添加的流程變量。
會簽（多實(shí)例節(jié)點(diǎn)）環(huán)節(jié)中涉及的幾個默認(rèn)的流程變量
nrOfInstances 該會簽環(huán)節(jié)中總共有多少個實(shí)例
nrOfActiveInstances 當(dāng)前活動的實(shí)例的數(shù)量电谣，即還沒有 完成的實(shí)例數(shù)量秽梅。
nrOfCompletedInstances 已經(jīng)完成的實(shí)例的數(shù)量
會簽人員部分示例代碼
- 分配會簽人員
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);
- 會簽人員審批
Map<String, Object> leaderOneAudit = new HashMap<>();
Scanner scanner = new Scanner(System.in);
System.out.println("請輸入領(lǐng)導(dǎo)審批意見。剿牺。企垦。。");
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);
- 示例代碼控制臺結(jié)果輸出
填寫申請|assignee:worker
請輸入領(lǐng)導(dǎo)審批意見晒来。钞诡。。。
yes
張三的審批意見為：同意
流程實(shí)例總數(shù)：3
當(dāng)前活動的流程實(shí)例總數(shù)：3
已經(jīng)完成實(shí)例的數(shù)目：0
leader：zhangsan
---------------------------------------分隔線----------------------------------------------------
taskName2:領(lǐng)導(dǎo)審批|assignee:zhangsan
--------------------------------------------
請輸入領(lǐng)導(dǎo)審批意見荧降。接箫。。朵诫。
yes
李四的審批意見為：同意
流程實(shí)例總數(shù)：3
當(dāng)前活動的流程實(shí)例總數(shù)：2
已經(jīng)完成實(shí)例的數(shù)目：1
leader：lisi
---------------------------------------分隔線----------------------------------------------------
taskName3:領(lǐng)導(dǎo)審批|assignee:lisi
--------------------------------------------
請輸入領(lǐng)導(dǎo)審批意見辛友。。剪返。废累。
yes
李四的審批意見為：同意
流程實(shí)例總數(shù)：3
當(dāng)前活動的流程實(shí)例總數(shù)：1
已經(jīng)完成實(shí)例的數(shù)目：2
leader：wangwu
---------------------------------------分隔線----------------------------------------------------
taskName4:領(lǐng)導(dǎo)審批|assignee:wangwu
taskName5:人事歸檔|assignee:hr
----------------------------------流程實(shí)例流轉(zhuǎn)-----------------------
任務(wù)ID:75014
流程實(shí)例ID:75005
任務(wù)名稱：填寫申請
辦理人：worker
開始時間：Tue Jul 31 10:12:39 CST 2018
結(jié)束時間：Tue Jul 31 10:12:39 CST 2018
=================================
任務(wù)ID:75028
流程實(shí)例ID:75005
任務(wù)名稱：領(lǐng)導(dǎo)審批
辦理人：zhangsan
開始時間：Tue Jul 31 10:12:39 CST 2018
結(jié)束時間：Tue Jul 31 10:12:43 CST 2018
=================================
任務(wù)ID:75031
流程實(shí)例ID:75005
任務(wù)名稱：領(lǐng)導(dǎo)審批
辦理人：lisi
開始時間：Tue Jul 31 10:12:39 CST 2018
結(jié)束時間：Tue Jul 31 10:12:49 CST 2018
=================================
任務(wù)ID:75034
流程實(shí)例ID:75005
任務(wù)名稱：領(lǐng)導(dǎo)審批
辦理人：wangwu
開始時間：Tue Jul 31 10:12:39 CST 2018
結(jié)束時間：Tue Jul 31 10:12:56 CST 2018
=================================
任務(wù)ID:75038
流程實(shí)例ID:75005
任務(wù)名稱：人事歸檔
辦理人：hr
開始時間：Tue Jul 31 10:12:56 CST 2018
結(jié)束時間：Tue Jul 31 10:12:56 CST 2018
=================================
如何通過代碼設(shè)置多實(shí)例屬性
本例中的流程圖都是通過ide的插件畫出來，而在web開發(fā)中脱盲，如何通過代碼把會簽的多實(shí)例的屬性給實(shí)現(xiàn)出來,可能不同人有不同的實(shí)現(xiàn)方式邑滨。我這邊提供一種實(shí)現(xiàn)，廢話有點(diǎn)多钱反，直接上代碼
- 設(shè)置會簽節(jié)點(diǎn)屬性
public static void setMultiInstance(String modelId, String nodelId) throws Exception {
// 獲取模型
byte[] mes = repositoryService.getModelEditorSource(modelId);
// 轉(zhuǎn)換成JsonNode
JsonNode jsonNode = objectMapper.readTree(mes);
// 轉(zhuǎn)換成BpmnModel
BpmnJsonConverter bpmnJsonConverter = new BpmnJsonConverter();
BpmnModel bpmnModel = bpmnJsonConverter.convertToBpmnModel(jsonNode);
// 獲取物理形態(tài)的流程
Process process = bpmnModel.getProcesses().get(0);
// 獲取節(jié)點(diǎn)信息
FlowElement flowElement = process.getFlowElement(nodelId);
// 只有人工任務(wù)才可以設(shè)置會簽節(jié)點(diǎn)
UserTask userTask = (UserTask) flowElement;
// 設(shè)置受理人掖看，這里應(yīng)該和ElementVariable的值是相同的
userTask.setAssignee("${" + Constant.ACT_MUIT_VAR_NAME + "}");
// userTask.setOwner("${user}");
// 獲取多實(shí)例配置
MultiInstanceLoopCharacteristics characteristics = new MultiInstanceLoopCharacteristics();
// 設(shè)置集合變量，統(tǒng)一設(shè)置成users
characteristics.setInputDataItem(Constant.ACT_MUIT_LIST_NAME);
// 設(shè)置變量
characteristics.setElementVariable(Constant.ACT_MUIT_VAR_NAME);
// 設(shè)置為同時接收（false 表示不按順序執(zhí)行）
characteristics.setSequential(false);
// 設(shè)置條件（暫時處理成诈铛，全部會簽完轉(zhuǎn)下步）
characteristics.setCompletionCondition("${nrOfCompletedInstances==nrOfInstances}");
userTask.setLoopCharacteristics(characteristics);
// 保存
ObjectNode objectNode = new BpmnJsonConverter().convertToJson(bpmnModel);
repositoryService.addModelEditorSource(modelId, objectNode.toString().getBytes("utf-8"));
}
- 清空會簽屬性
public static void clearMultiInstance(String modelId, String nodelId) throws Exception {
// 獲取模型
byte[] mes = repositoryService.getModelEditorSource(modelId);
// 轉(zhuǎn)換成JsonNode
JsonNode jsonNode = new ObjectMapper().readTree(mes);
// 轉(zhuǎn)換成BpmnModel
BpmnJsonConverter bpmnJsonConverter = new BpmnJsonConverter();
BpmnModel bpmnModel = bpmnJsonConverter.convertToBpmnModel(jsonNode);
// 獲取物理形態(tài)的流程
Process process = bpmnModel.getProcesses().get(0);
// 獲取節(jié)點(diǎn)信息
FlowElement flowElement = process.getFlowElement(nodelId);
// 只有人工任務(wù)才可以設(shè)置會簽節(jié)點(diǎn)
UserTask userTask = (UserTask) flowElement;
// 清空受理人
userTask.setAssignee("");
// 獲取多實(shí)例配置
MultiInstanceLoopCharacteristics characteristics = userTask.getLoopCharacteristics();
if (characteristics != null) {
// 清空集合
characteristics.setInputDataItem("");
// 清空變量
characteristics.setElementVariable("");
// 設(shè)置為順序接收（true 表示不按順序執(zhí)行）
characteristics.setSequential(true);
// 清空條件
characteristics.setCompletionCondition("");
}
// 保存
ObjectNode objectNode = new BpmnJsonConverter().convertToJson(bpmnModel);
repositoryService.addModelEditorSource(modelId, objectNode.toString().getBytes("utf-8"));
}
