查詢單筆資料節點
簡介
功能簡介
查詢單筆資料,可以利用查詢條件和資料排序來定位、查詢出目標表單中的某筆資料,且查詢結果支援被後續執行節點多次調用。
應用場景
該節點主要用於查詢出某筆資料,供後續節點進行新增、刪除、修改等操作的場景。如:
- 在客戶管理中,當新增聯繫人時,查詢客戶表中是否存在對應客戶,若不存在,則新建客戶資訊;
- 在訂單管理中,當訂單送出時,查詢庫存數量,當庫存數量大於訂單所需數量時,新建一個出庫單;否則,向負責人發起通知,提示庫存不足。
預期效果
以客戶管理場景為例,當新增聯繫人時,查詢客戶表中是否存在對應客戶資訊,若不存在,則新建一條客戶記錄。效果如下圖所示:
設定步驟
新增節點
根據業務需求,在已有節點後新增一個查詢單筆資料節點:
選擇目標表單
目標表單是指,查詢單筆資料節點取得資料的表單,支援選擇當前應用以及跨應用的表單:
新增查詢條件
查詢單筆資料節點僅能從目標表單中查詢出單筆資料。因此,當目標表單中的資料較多時,可以根據需求新增查詢條件,使其僅查詢出符合特定條件的資料。
點擊「新增條件」,查詢條件需要設定的內容如下:
- 多個條件的關係:當存在多個查詢條件時,可以選擇滿足「所有」或「任一」條件;
- 所有:查詢條件之間的關係為「且」,僅查詢出滿足所有條件的資料;
- 任一:觸發條件之間的關係為「或」,可查詢出滿足任一條件的資料;
- 目標表單欄位:選擇目標表單中的欄位,或部分系統欄位(送出人、送出時間、更新時間、流程狀態);
- 過濾關係:根據目標表單的欄位類型,設定不同的過濾關係,如等於/不等於、包含/不包含、為空/不為空等;
- 過濾值:可選擇「節點欄位值」、「自訂」或「空值」,選擇自訂時,欄位值需手動輸入。
附註:
1. 不同類型的目標表單欄位可設定的過濾關係與過濾值不同。如需使用子表單欄位作為過濾值,則需要將過濾關係設定為「等於任意一個/不等於任意一個/同時包含/包含任意一個」,詳情參見:過濾值說明;
2. 支援引用欄位值的前置節點包括:觸發節點、查詢單筆節點、新增資料(單筆)、計算節點和外掛節點。其中,當觸發方式為「定時觸發 > 自訂時間」時,不可引用觸發節點的欄位值;
3. 目標表單中的部分欄位不能設定查詢條件,包括:分割線、關聯查詢、選擇資料、按鈕、當前節點以及當前負責人。
設定排序規則
若新增了排序規則,查詢單筆資料節點在查詢目標表單資料時,將按照排序規則,取排序後的第一筆資料。排序規則設定如下:
- 排序欄位:支援按照多個欄位對資料進行排序,可選欄位類型如下:
- 表單欄位:單行文字、數字、日期時間、單選、下拉單選、流水號
- 系統欄位:送出時間、更新時間、連結參數
- 排序順序:支援設定為「升序」或「降序」
附註:
若未新增排序規則,查詢單筆資料節點在查詢目標表單資料時,將隨機取得一筆資料。
注意事項
當「查詢單筆資料」節點的查詢結果被後續執行節點調用時,若查詢結果為空,則會對後續節點的執行效果產生影響,詳情參見:執行節點詳解。