魔筆平臺提供了強大的用戶流程集成功能,增大了流程的靈活性和適應性,從而更好地處理復雜的業務場景。本文檔將指導您如何使用用戶流程集成。
什么是用戶流程操作
魔筆是一款強大的低代碼開發平臺,可以幫助企業快速創建內部工具和應用。在這些工具和應用的創建過程中,經常涉及各種集成流。而用戶任務便是這些流中的一個關鍵組成部分。在集成流中,用戶任務節點代表了一個需要人工干預或決策的步驟。它通常指的是需要某個用戶完成某些操作,比如審核、批準或填寫數據。
用戶流程操作包括了用戶任務以及與這些任務相關的集成流的集成操作。
功能介紹
魔筆平臺的用戶流程集成功能支持以下特點:
自定義觸發方式:集成操作可以設置為手動觸發或自動運行,滿足不同的業務場景需求。
回調和數據轉換:支持在查詢成功或失敗時執行特定的集成操作事件,以及對返回的數據進行自定義處理。
事件相關內容可參考:集成操作事件
使用用戶流程集成
步驟1: 在應用內部創建集成操作
打開“代碼”面板,點擊對應作用域的“+”后選中“用戶流程”。
選擇操作類型,并根據需求選擇集成操作的觸發方式和更加細節的配置內容。
點擊“運行”預覽查詢效果。
配置面板詳解
操作類型
獲取集成流實例
獲取集成流實例列表
取消集成流實例
獲取用戶任務
獲取用戶任務列表
完成用戶任務
重新指定用戶任務審批人
取消用戶任務
集成配置
下面列出了幾種操作的配置面板參數:
獲取集成流實例列表
集成流:定義了預期獲取的集成流。
集成流執行狀態:定義了預期獲取集成流的狀態,包括
已完成
、已取消
、運行失敗
、運行中
。開始時間:定義了預期獲取集成流的開始執行時間。
結束時間: 定義了預期獲取集成流的結束時間。
完成用戶任務
taskId:定義了預期完成的用戶任務實例 ID。
執行結果輸出:定義了預期完成的用戶任務的執行結果輸出。
獲取用戶任務列表
篩選方式:定義了預期獲取用戶任務的篩選方式,包括
集成流
、集成流實例 ID
。集成流:若篩選方式為
集成流
,定義了預期獲取流中的用戶任務的集成流。用戶任務:若篩選方式為
集成流
,定義了預期獲取的用戶任務。flowInstanceId:若篩選方式為
集成流實例 ID
,定義了預期獲取用戶任務的集成流實例 ID。用戶任務執行狀態:定義了預期獲取用戶任務的狀態,包括
待處理
、已完成
、已過期
、已取消
。創建時間起始、創建時間結束:定義了預期獲取用戶任務的創建時間區間。
提交時間起始、提交時間結束:定義了預期獲取用戶任務的提交時間區間。
pageNumber:定義了當前請求的是第幾頁的數據,從1開始計數。
pageSize:定義了每頁包含多少條數據。
重新指定用戶任務審批人
taskId:定義了預期重新指定審批人的用戶任務 ID。
審批人:定義了用戶任務新的審批人。
集成流權限
只有集成流的發起者可以查看此集成流。
用戶任務權限
只有用戶任務的發起者和審批人可以查看此任務。
只有用戶任務的審批人可以執行“完成用戶任務”、“重新指定用戶任務審批人”、“取消用戶任務”操作。
通用配置
參數:定義了完成操作所需的參數,包括類型、默認值和描述。在輸入框中,可通過
{{ varName }}
的方式引用參數。描述:為集成操作提供詳細描述。
回調配置
數據轉換:對接口返回的數據進行處理,默認為
return data
,即不進行處理。成功回調:配置接口調用成功時觸發的事件。
失敗回調:配置接口調用失敗時觸發的事件。
手動觸發集成
事件觸發
在需要觸發集成操作的組件中,配置事件處理器。
將動作類型設置為集成操作,并選擇相應的集成。
以對象形式填寫已配置的參數。
API 觸發
若此集成操作的名稱為action1
,則在任何可以執行腳本的地方,可以使用action1.trigger()
方法觸發集成操作,若集成操作配置了參數,則需要以對象形式填寫已配置的參數。