在之前的案例中,鬆哥和大家舉例最多的 Task 主要是 UserTask 和 ServiceTask,ReceiveTask 雖然也和大家提過但是沒有仔細講過,今天我們就來捋一捋 ReceiveTask 在 Flowable 中到底怎麼玩。
1. 使用場景
接受任務(Receive Task),接觸過 Flowable 的小夥伴應該是見過或者聽説過,它的圖標如下圖:
ReceiveTask 可以算是 Flowable 中最簡單的一種任務,當該任務到達的時候,它不做任何邏輯,而是被動地等待用户 Trigger。
ReceiveTask 往往適用於一些不明確的阻塞,例如:一個複雜的計算需要等待很多條件,這些條件是需要人為來判斷是否可以執行,而不是直接執行,這個時候,工作人員如果判斷可以繼續了,那麼就 Trigger 一下使流程繼續向下執行。
基於以上介紹,ReceiveTask 還有一箇中文名字叫做等待任務,也就是説,流程走到 ReceiveTask 這個節點的時候,就卡住了,需要用户手動點一下,流程才會繼續向下走。
2. 實踐
2.1 繪製流程圖
我們繪製一個簡單的流程圖來看下 ReceiveTask 到底是啥樣子,流程圖如下:
ReceiveTask 圖標上有一個信封。
小夥伴們繪製的時候,首先選擇用户任務:
然後點擊設置按鈕,將用户任務切換為 ReceiveTask 即可:
繪製完成後,我們下載這個流程圖對應的 XML 文件。
來看看,帶 ReceiveTask 的流程圖是下面這樣的:
<process id="receiveTask_demo" name="接收任務測試流程" isExecutable="true">
<documentation>接收任務測試流程</documentation>
<startEvent id="startEvent" flowable:formFieldValidation="true"></startEvent>
<sequenceFlow id="sid-9E7B327E-EFC8-4D29-8C6F-157D5E1B7A4E" sourceRef="startEvent" targetRef="todaySales"></sequenceFlow>
<receiveTask id="todaySales" name="統計今日銷售額"></receiveTask>
<receiveTask id="sendMsg" name="發送今日銷售業績給老闆"></receiveTask>
<endEvent id="endEvent"></endEvent>
<sequenceFlow id="s2" sourceRef="todaySales" targetRef="sendMsg"></sequenceFlow>
<sequenceFlow id="s3" sourceRef="sendMsg" targetRef="endEvent"></sequenceFlow>
</process>
2.2 部署
這個鬆哥在之前的文章中已經反覆介紹過多次了,這裏就不再贅述了,大家參考我們之前的文章部署並啓動上面這個流程。
2.3 分析
當流程啓動之後,按照我們前面文章的分析,我們先去數據庫中 ACT_RU_TASK 表進行查看,發現該表空空如也。也就是 ReceiveTask 並不會被記錄在 ACT_RU_TASK 表中,他們只是單純的被記錄在 ACT_RU_EXECUTION 表中,因為在該表中,我們可以查看 ReceiveTask 的記錄。
對於 ReceiveTask 的觸發方式也很簡單,如下:
@Test
void test10() {
List<Execution> list = runtimeService.createExecutionQuery().activityId("todaySales").list();
for (Execution execution : list) {
runtimeService.trigger(execution.getId());
}
}
由於 ReceiveTask 的觸發需要傳入的參數是執行實例 ID 而不是流程實例 ID,所以我們要查詢出來當前待觸發的執行實例 ID。具體的查詢方式就是根據 ReceiveTask 的節點名稱去查詢。
查詢到執行實例 ID 之後,調用 trigger 方法完成觸發,使得流程繼續向下走。
好啦,現在流程進入到發送今日銷售業績給老闆這個環節了,老辦法繼續查詢並執行:
@Test
void test10() {
List<Execution> list = runtimeService.createExecutionQuery().activityId("sendMsg").list();
for (Execution execution : list) {
runtimeService.trigger(execution.getId());
}
}
這個執行完層後,這個流程就結束了。現在我們去查看 ACT_RU_ACTINST 表已經空了,查看 ACT_RU_EXECUTION 表也空了。
好啦,這就是 ReceiveTask 的玩法,沒啥難度,下篇文章繼續~