表單規則
功能路徑
微程式後臺管理-應用管理-業務模型-資料模型-表單規則
1.2 表單規則使用說明
1.2.1 系統預設提供表單規則
新增
觸發：向模型中新增表單資料時會被觸發執行；
節點：可以新增所有表單規則節點；
更新
觸發：更新編輯模型的表單資料時會被觸發執行；
節點：可以新增所有表單規則節點；
查詢
觸發：查詢模型的單條表單資料時會被觸發；
節點：只能新增表單方法節點和訊息通知節點；
刪除
觸發：刪除模型的表單資料時會被觸發；
節點：可以新增所有表單規則節點；
獲得列表
觸發：獲得模型的列表資料時會被觸發；
節點：不可以新增表單規則節點；
流程生效
觸發：流程生效後會被觸發；
節點：可以新增所有表單規則節點；
流程作廢
觸發：流程作廢後會被觸發；
節點：可以新增所有表單規則節點；
1.2.2 自定義表單規則
資料操作規則
- 定義：對目標模型的資料進行操作的規則；
- 節點：可以在自定義的資料操作規則中新增資料新增、資料更新、資料刪除、邏輯校對、訊息通知及表單方法節點；
- 使用：自定義的資料操作規則可以在流程事件中被引用；
定時作業規則
- 定義：在一段時間內週期性執行任務；
- 節點：可以在自定義的資料操作規則中新增資料新增、資料更新、資料刪除、邏輯校對、訊息通知及表單方法節點；
- 使用：系統自動按週期執行；
- 實例：
* 需求：銷售出庫單審批通過後，倉庫並不會立刻發貨，會在銷售出庫單中要求的出庫日期完成發貨，因此需要在每天給倉庫提醒第二天需要發貨的銷售出庫單；
* 設定：在銷售出庫單模型的表單規則中新增一個定時作業，在定時作業中新增一個“訊息通知”節點；如下圖：
* ①設定定時設定：
+ 執行時間：定時任務執行的時間段；
+ 執行方式：週期小於1天使用輪詢執行方式，週期大於1天，按週期執行；
+ 輪詢間隔：定時任務兩種執行之間的時間間隔；
+ 資料來源：getlist，使用目前模型下的資料作爲資料來源；表單服務，通過業務整合獲得外部系統的資料作爲資料來源；
- 運行結果：
1.2.3 表單規則節點使用說明
資料新增
- 適用場景：
新增表單後需要向其他模型中新增表單資料； - 實例： * 需求：銷售出庫流程走完以後，需要產生銷售出庫單中的商品的出庫記錄； * 設定：打開銷售出庫模型下的表單規則，編輯流程生效表單規則，在流程生效表單規則中新增一個“資料新增”節點；如下圖：
①設定觸發對象-銷售出庫單的主表（當商品及銷售數量是在表單的子表中時，這裏選擇子表）
②設定資料條件-可以不設定資料條件；即是銷售出庫單中的資料需要滿足指定條件才向出庫記錄模型中條件記錄，不設定時則銷售出庫單的全部資料都向出庫記錄模型中新增資料；
③目標模型-出庫記錄，被新增資料的業務模型；
④目標對象-出庫記錄主表，被新增資料的業務模型中的主表或子表
⑤過濾條件，查找出目標模型中已經存在的指定資料，當目標模型中的資料已經存在時不再新增；可以不設定，不設定時目前模型中每條表單資料在生效時（或其他時候被調用時）都會向目標模型中新增一條資料；
+ 當出庫記錄中已經存在目前銷售出庫單中商品的出庫記錄時，不向出庫記錄中新增資料
⑥新增資料動作，設定向目標模型中新增表單時資料項的值；
+ 設定新增的出庫記錄中的商品名稱等於銷售出庫單中的商品名稱；
+ 設定新增的出庫記錄中的出庫日期等於銷售出庫單中的出庫日期；
+ 設定新增的出庫記錄中的出庫數量等於銷售出庫單中的出庫數量；
+ 設定新增的出庫記錄中的銷售單號等於銷售出庫單中的單據號；
- 運行結果：
銷售出庫單流程完成後（生效後），出庫記錄模型中會新增銷售出庫單中商品對應的出庫記錄；
資料更新
- 適用場景：
新增表單資料前後需要更新其他模型中的資料； - 實例： * 需求：銷售出庫後，需要凍結庫存管理中對應商品的部分數量，可用庫存需要減少對應的數量； * 設定：打開銷售出庫模型下的表單規則，編輯新增表單規則，在預設的新增資料節點後新增一個“資料更新”節點；如下圖：
①設定觸發對象-銷售出庫單的主表（當商品及銷售數量是在表單的子表中時，這裏選擇子表）
②設定資料條件，可以不設定資料條件；即是銷售出庫單中的資料需要滿足指定條件才更新庫存管理模型的資料時可以設定指定的資料條件，不設定時則銷售出庫單的全部資料都會更新庫存管理模型的資料；
③目標模型-庫存管理，被更新的業務模型；
④目標對象-庫存管理主表，被更新的業務模型中的主表或子表；
⑤查找資料範圍，設定查找目標模型中需要被更新資料的條件；支持設定多個條件；
+ 設定庫存管理中的商品編碼等於銷售出庫單中的商品編碼；
⑥更新資料動作，設定目標模型中需要被更新的資料項和更新的資料值；
+ 設定庫存管理中的庫用庫存減少，減少數量爲銷售出庫單週的銷售數量；
+ 設定庫存管理中的庫用庫存增加，增加數量爲銷售出庫單週的銷售數量；
- 運行結果：
新增銷售出庫單完成後，庫存管理模型中指定的商品的可用庫存數量減少，凍結庫存數量增加，可用庫存數量的減少數與凍結庫存數量的增加數剛好等於銷售出庫單中對應商品的銷售數量；
資料刪除
- 適用場景：刪除/作廢表單資料後需要刪除其他模型中關聯的表單資料；
* 實例：
+ 需求：銷售出單生效後發現單據出錯了，需要作廢銷售出庫單，對應的需要刪除銷售出庫單中商品的出庫記錄；
+ 設定：打開銷售出庫模型下的表單規則，編輯流程作廢表單規則，在流程作廢表單規則中新增一個“資料刪除”節點；如下圖：
①設定觸發對象-銷售出庫單的主表（當商品及銷售數量是在表單的子表中時，這裏選擇子表）
②設定資料條件，可以不設定資料條件；即是銷售出庫單中的資料需要滿足指定條件才刪除出庫記錄中的資料，不設定時則銷售出庫單的全部資料都會觸發刪除出庫記錄模型的資料；
③設定目標模型-出庫記錄，被刪除資料的業務模型；
④設定目標對象-出庫記錄主表，被刪除資料的業務模型中的主表或子表；
⑤設定刪除資料範圍，設定查找出目標模型（出庫記錄）中需要被刪除的資料的條件；
- 設定需要刪除的出庫記錄中的商品名稱等於銷售出庫單中的商品名稱；
- 設定需要刪除的出庫記錄中的銷售單號等於銷售出庫單中的單據號；
- 運行結果：
銷售出庫單被作廢後，出庫記錄中記錄的銷售出庫單中商品的出庫記錄被刪除；
邏輯校對
- 適用場景：新增/編輯表單資料前需要判斷目前表單中的某一個或多個欄位值與其他模型的欄位值進行對比並滿足條件後才能新增/編輯表單資料；
* 實例：
+ 需求：銷售出庫時，需要判斷商品庫存是否充足，充足的情況下才可以進行銷售；
+ 設定：打開銷售出庫模型下的表單規則，編輯新增表單規則，在預設的新增資料節點前新增一個“邏輯校對”節點；如下圖：
①設定驗證模型爲目前模型-銷售出庫單的主表（當需要對子表欄位進行校對時，設定目前模型的子表爲驗證模型即可）
②設定目標模型爲庫存管理模型（商品庫存保存的模型，只支持主表）
③設定判斷條件查找出目標模型中的商品
- 支持設定多個條件去查找目標模型中的商品
- 設定多個條件時，支持設定查找滿足所有條件的資料還是隻有滿足其中一個條件的資料即可以查找到；
④設定驗證條件：設定目前模型中的資料項與查找出的目標模型的資料中的資料項比較方式；
- 支持設定多組資料項進行比較
- 設定多組資料項進行比較時，需要每一對資料項的比較都是通過的纔會通過邏輯校對節點；
- 運行結果：
新增銷售出庫單時，系統會比較銷售出庫單中商品的銷售數量與庫存中對應商品的可用庫存數量，當銷售數量大於可用庫存數量時，不能新增銷售出庫單並且portal端會返回在驗證條件中設定的校對失敗提示語；
訊息通知
- 適用場景：
需要向指定人員發送針對目前表單資料的訊息通知； * 實例： + 需求：銷售出庫單生效後需要發送通知告知銷售人員； + 設定：打開銷售出庫模型下的表單規則，編輯流程生效表單規則，在流程生效表單規則中新增一個“訊息通知”節點；如下圖：
①接收人，訊息通知的接收人，可以按部門、用戶、角色及模型中的資料項設定接收人；
②標題，訊息通知的標題，可以設定常量加模型中的資料項來產生通知標題；
③內容，訊息通知的內容，可以設定常量加模型中的資料項來產生通知內容；
④連結類型，訊息通知中攜帶的連結類型，支持目前模型的表單連結、微程式系統內部其他連結和微程式系統外部連結。設定目前模型的表單連結或微程式系統內部連結時，在釘釘打開訊息後可以直接登入到微程式系統中；
⑤模型中有多個表單時，可以指定釘釘中點擊訊息後打開的表單；
- 運行結果：
* 銷售出庫單生效後（流程走完），銷售出庫單的銷售人員會收到一條訊息通知；
行動端釘釘訊息通知展示樣式
表單方法
- 適用場景：
系統需要與第三方系統進行資料通訊的場景； * 實例： + 需求：銷售出庫單審批通過後需要安排物流配送，物流配送在物流系統中，這是就需要微程式系統與物流系統進行通訊的能力了； + 設定：打開銷售出庫模型下的表單規則，編輯流程生效表單規則，在流程生效表單規則中新增一個“表單方法”節點；如下圖：
①設定執行條件，設定了條件之後，滿足條件的資料纔會執行表單方法中綁定的表單服務；不設定執行條件則所有資料都會執行表單方法中綁定的表單服務；
②綁定表單服務，從業務整合中選擇表單服務和表單方法進行設定；
運行結果：銷售出庫單審批通過後，物流系統中新增一條送貨物流訊息；
資料校對
- 適用場景：當模型滿足各種條件時，執行相應的操作；
實例：
* 需求：銷售訂單的單據狀態顯示爲已完成時，需要修改庫存單模型中的商品凍結數量和已出庫數量。
* 設定：打開銷售訂單模型下的表單規則，編輯流程生效表單規則，在流程生效表單規則中新增一個“資料校對”、“”資料節點；如下圖：
* ①設定驗證模型爲目前模型-銷售訂單的主表（不支持子表）②設定驗證條件
+ 一個資料校對節點只支持一個校對
* ③設定”資料更新“節點內容
- 運行結果：
銷售訂單單據生效後，庫存單中記錄的模型中的商品凍結數量減少和增加已出庫數量；
資料變數
- 適用場景：目前模型滿足某種條件時，對資料進行變數
* 實例：
+ 需求：銷售訂單的單據狀態顯示爲已完成時，銷售訂單中的訂單表單被單據號變數。
+ 設定：打開銷售訂單模型下的表單規則，編輯流程生效表單規則，在流程生效表單規則中新增一個“資料變數”節點；如下圖：
①設定目標模型：目前模型-銷售訂單的主表（只支持1個子表）
②設定資料條件：設定了條件之後，滿足條件的資料纔會執行表單方法中綁定的表單服務；不設定執行條件則所有資料都會執行表單方法中綁定的表單服務；
③設定變數欄位，把相應的資料變數給對應的欄位。
- 運行結果：銷售訂單單據狀態顯示爲已完成時，銷售訂單中的訂單號由單據號填入。
資料判斷
- 適用場景：查詢目標模型，如果目標模型資料是否爲空或資料數量來進行下一個節點的處理和操作
- 實例：
需求：客戶表單維護，如果客戶表單中的客戶與客戶聯繫人匹配，那麼客戶表單的資料不能進行刪除。
- 當客戶聯繫人表單中沒有資料時，可以進行刪除。
- 當客戶聯繫人表單中有資料，且與客戶表單中有相同欄位，不能刪除；與客戶表單中無相同欄位，可以刪除。
設定：打開客戶模型下的表單規則，編輯刪除表單規則，在刪除表單規則中新增“資料判斷”“邏輯校對”。第一步判斷如果資料爲空，可以進行刪除客戶表單的資料；資料不爲空，進行邏輯校對判斷第二步，邏輯校對，有相同欄位，不可以刪除，沒有相同欄位可以刪除。如下圖：
- 實例：
①設定【資料判斷】節點目標模型爲客戶聯繫人
②設定驗證條件
+ 一個資料校對節點只支持一個校對
③設定”資料判斷“是否走向
④設定【邏輯校對】節點驗證模型爲客戶，目標模型爲客戶聯繫人
⑤設定判斷條件與驗證條件
⑥設定”邏輯校對“是否走向
- 運行結果：
當客戶聯繫人表單沒有資料，客戶表單可以進行刪除；當客戶聯繫人表單有資料，且客戶聯繫人與客戶表單有相同欄位，不能刪除；客戶聯繫人與客戶表單沒有相同欄位，可以刪除。
更新: 2022-09-28 21:01:52
原文: https://www.yuque.com/skwme4/hyk0u0/gcqr1n