修改資料節點
簡介
功能簡介
修改資料是指,當「智慧助手 Pro」執行到該節點時,修改節點所指向的資料或目標表單中滿足條件的已有資料;若找不到對應資料,還可直接新增資料。
附註:
在使用修改資料節點前,建議先參考修改資料節點使用說明來學習如何使用修改資料節點。
應用場景
- 進銷存場景中,當退貨單簽核完成後,自動修改庫存表中貨物的在庫狀態;
- 設備管理場景中,當設備保養單的資料修改後,自動修改設備檔案表中的設備保養狀態;
- 學生管理場景中,當迎新表中的學生狀態標記為已報到後,自動將該學生的資訊同步到學籍表中,如果學籍表中沒有該學生的資訊,則在學籍表中新增一條記錄。
預期效果
以學生管理為例,透過「智慧助手Pro」實現當「迎新表」中學生的狀態被標記為已報到後,同步修改「學籍表」中的學生狀態;如果「學籍表」中沒有該學生的資訊,則新增一筆資料。效果如下:
1. 「學籍表」中存在對應學生資訊,進行修改操作。
2. 「學籍表」中無對應學生資訊,進行新增操作。
操作步驟
新建智慧助手Pro後,將自動進入設計畫布,配置好觸發節點後,即可進行後續執行節點的配置。
新增節點
根據業務需求,在已有節點後新增一個修改資料節點:
選擇修改對象
修改資料節點支援如下兩種修改對象,且各自適用場景不同:
- 選擇表單修改資料:前置節點上不存在要修改的資料,需要額外從表單中取得資料並修改;
- 選擇節點修改資料:前置節點中已儲存/指向了要修改的資料,直接選擇對應節點進行修改即可。
附註:
修改資料操作實質上包括兩個步驟:取得資料,對其進行修改。在「智慧助手 Pro」中,部分節點(如觸發節點、查詢單/多筆節點等)可實現取得資料,因此可以直接對節點進行修改,從而實現修改資料操作。
1. 選擇表單修改資料
選擇表單修改資料是指,修改目標表單中滿足條件的資料,支援選擇當前應用以及跨應用表單:
2. 選擇節點修改資料
選擇節點修改資料是指,對節點所指向的資料進行修改操作。支援選擇觸發節點、查詢單筆/多筆資料節點、新增資料節點。具體實現效果如下:
- 觸發節點:修改觸發該「智慧助手 Pro」的資料;
- 新增資料:修改已新增的資料,用於修正或更新先前新增的資料;
- 查詢單筆/多筆資料:修改查詢到的資料,用於修改目標表單中的特定資料。
附註:
1. 查詢單筆/多筆資料節點,僅能查詢出整筆資料,不支援單獨查詢出子表單中的部分資料;
2. 若修改節點在某條分支上,則不支援選擇其他分支上的節點;若不在任意分支上,則不支援選擇分支上的節點。
篩選出要修改的資料
當修改對象為「選擇表單修改資料」時,可以新增過濾條件,僅從目標表單中篩選出符合條件的資料,用於後續修改(下文會將此處篩選出的待修改資料統稱為目標資料)。
點擊「新增條件」,修改條件需要設定的內容如下:
- 多個條件的關係:當存在多個修改條件時,可以選擇滿足「所有」或「任一」條件;
- 所有:多個修改條件之間的關係為「且」,僅修改滿足所有條件的資料;
- 任一:多個修改條件之間的關係為「或」,將修改滿足任一條件的資料;
- 目標表單欄位:選擇目標表單中的欄位,或部分系統欄位(送出人、送出時間、更新時間、流程狀態);
- 過濾關係:根據目標表單的欄位類型,設定不同的過濾關係,如等於/不等於、包含/不包含、為空/不為空等;
- 過濾值:可選擇「節點欄位值」、「自訂」或「空值」,選擇自訂時,欄位值需手動輸入。
附註:
1. 即使在篩選條件中使用了子表單欄位,篩選對象仍為整筆資料,無法單獨篩選出子表單中的某幾筆資料。
可以參考本文「設定欄位值」節設定匹配條件,使得只對匹配上的子表單資料進行修改,未匹配上的則不做修改;
2. 不同類型的目標表單欄位可設定的過濾關係與過濾值不同。如需使用子表單欄位作為過濾值,則需要將過濾關係設定為「等於任意一個/不等於任意一個/同時包含/包含任意一個」,詳情參見:過濾值說明;
3. 目標表單中的部分欄位不支援設定修改條件,包括:分割線、關聯查詢、選擇資料、手機、按鈕、流程狀態、當前節點、當前負責人以及系統欄位(送出人、送出時間、更新時間)。
選擇修改方式
透過以下選項,可以確定資料的修改方式:
- 不勾選:修改方式為「修改已有資料」,在找不到/匹配不到目標資料時的執行邏輯如下:
- 找不到需要修改的目標資料時,則跳過執行該節點;
- 匹配不到需要修改的目標資料時,則不執行修改資料操作,繼續進行下一次匹配;
- 勾選:修改方式為「修改或新增資料」,若找不到/匹配不到需要修改的目標資料,則會直接向目標表單中新增資料。
附註:
1. 找不到需要修改資料的情況包括:
修改對象為「選擇表單修改資料」,但過濾條件篩選出的資料為空;
修改對象為「選擇節點修改資料」,但所選節點查詢到的資料為空。
2. 匹配不到需要修改資料的情況是指,已找到了需要修改資料,但在執行修改的過程中,賦值資料源無法根據本文「修改資料欄位值」設定的匹配條件,匹配到對應資料。(該場景僅會在修改多條資料/子表單資料時出現)
如果對修改資料節點中的過濾配置、匹配條件配置存有疑惑,可參考修改資料節點使用說明【第三節】中提供的執行邏輯圖和範例,進行了解學習。
設定欄位值
1. 修改資料欄位值
a. 選擇賦值資料源
若在修改資料時,想要使用前置節點上的欄位值對目標資料進行動態賦值,則需要在下拉單選中選取用於賦值的資料源,否則只能將目標資料修改為自訂值、空值。
附註:
1. 支援選擇觸發節點、新增資料節點、查詢單筆/多筆資料節點、計算節點、外掛節點。其中,當觸發方式為「定時觸發 > 自訂時間」時,不可引用觸發節點進行賦值。
2. 若修改方式為「修改或新增資料」,則該資料源同樣是新增資料時的賦值資料源。
b. 新增修改欄位
點擊「新增欄位」,從目標資料中選取需要修改值的欄位並設定其新值(支援:節點欄位值、自訂值或空值)。
附註:
1. 目標表單中不支援設定的欄位包括:分割線、選擇資料、關聯查詢、手寫簽名、流水號以及系統欄位(送出人、送出時間、更新時間);
2. 修改資料時,不同類型欄位的欄位值設定方式不同,詳情參見本文「修改數量限制」。
c. 設定資料修改關係(選做,僅需要在特定場景下進行配置)
當目標資料為多筆資料/子表單,且賦值資料源為一或多筆資料時,「修改資料節點」在執行過程中會遇到一個問題:取到賦值資料源中的一筆資料後,它不知道應該去修改哪一筆或幾筆目標資料。
因此,需要設定目標資料和賦值資料源間的資料修改關係,確保能夠準確地找到並修改對應的目標資料。
2. 新增資料欄位值
若修改方式為「修改或新增資料」,相應地,在欄位值設定處將會出現「新增資料」區域,用於設定新增資料時每個欄位的值:
附註:
新增資料時,不同類型欄位的欄位值設定方式不同,詳情參見:新增資料。
注意事項
通用說明
- 目標表單中的圖片、附件欄位,只能設定為觸發表單欄位值或空值,不支援自訂。
- 修改資料時,子表單欄位的賦值規則請參考:子表單賦值規則。
- 在調用前置節點上的資料,對目標資料進行過濾和賦值時,若所調用的資料不存在,則修改資料節點的執行效果會受到影響,詳情參見:執行節點詳解。
修改數量限制
- 修改資料節點每次最多支援修改 200 筆資料。在一次修改過程中,若滿足修改條件的資料或前置節點指向的資料超過 200 筆,則不會執行該次修改操作,並進行報錯提示。
- 如下類型的欄位值設定,可對多筆子表單資料進行修改。當匹配資料時的計算量SUM(目標資料.子表單資料量 * 賦值資料源的資料量 * 匹配條件數) 小於等於 100 萬時,可繼續進行修改操作,否則會修改失敗。
- 使用「多條資料的主欄位」修改「目標表單的子表單欄位」
- 使用「單筆資料的子表單欄位」修改「目標表單的子表單欄位」
以同步變更入庫資料為例,若發起了採購變更申請,對同一商品在多個倉庫的採購數量進行變更,則需要同步修改入庫單中的多筆入庫資料,計算量為:sum(1*2*2,2*2*2) = 12:
若因為計算量超出限制而導致修改失敗,可以減少匹配條件或修改資料條數。
欄位值說明
欄位值可以設定為以下三種:節點欄位值、自訂以及空值。
附註:
「節點欄位值」,即該「智慧助手 Pro」中前置節點(包括觸發節點和執行節點)上所儲存的資料欄位值,下文將統一稱為「前置節點欄位值」。
1. 節點欄位值
a. 支援將「目標表單的欄位值」修改為「前置節點欄位值」,即將「智慧助手 Pro」中前置節點上儲存的資料應用到目標表單的相應欄位上。
b. 對於不同類型的目標表單欄位,可以設定的前置節點欄位類型如下:
目標表單欄位 | 前置節點欄位 |
單行文字 下拉單選 單選 | 單行文字、下拉單選、單選、連結參數、流水號、子表單(單行文字、下拉單選、單選) |
多行文字 | 多行文字、子表單(多行文字) |
數字 | 數字、子表單(數字) |
複選 下拉複選框 | 複選、下拉複選框、子表單(複選、下拉複選框) |
日期時間 | 日期時間、子表單(日期時間)、送出時間、更新時間 |
子表單欄位 | 子表單欄位 |
圖片 | 圖片、子表單(圖片) |
附件 | 附件、子表單(附件) |
成員單選 | 成員單選、子表單(成員單選)、送出人 |
成員多選 | 成員多選、子表單(成員多選) |
部門單選 | 部門單選、子表單(部門單選) |
部門多選 | 部門多選、子表單(部門多選) |
c. 當目標表單欄位與前置節點欄位的設定存在以下區別時,將作為特殊情況處理:
目標表單欄位 | 前置節點欄位 | 特殊情況的處理方法 |
圖片欄位僅允許上傳一張 | 圖片欄位可上傳多張 | 將前置節點中圖片欄位中的第一張圖賦值給目標表單的圖片欄位 |
附件欄位僅允許上傳一個 | 附件欄位可上傳多個文件 | 將前置節點中附件欄位中的第一個文件賦值給目標表單的附件欄位 |
日期時間欄位只顯示日期 | 日期時間欄位顯示日期 + 時間 | 將前置節點中日期時間欄位件中的日期賦值給目標表單中的日期時間欄位,丟棄時間 |
日期時間欄位顯示日期 + 時間 | 日期時間欄位只顯示日期 | 將前置節點中日期時間欄位中的日期賦值給目標表單中的日期時間欄位,時間設定為00:00:00 |
2. 自訂
a. 支援自訂目標表單的欄位值。如下圖所示:
b. 對於不同類型的目標表單欄位,自訂值的設定方法如下:
目標表單欄位 | 設定方法 |
單行文字、多行文字、單選、下拉單選 | 直接輸入文字 |
複選、下拉複選框 | 可以輸入多個文字,多個值用 enter 隔開 |
數字 | 直接輸入數字,如果輸入非數字內容,視為空值 |
日期時間 | 直接選擇日期/日期時間 |
成員單選、成員多選 | 點擊選擇成員 |
部門單選、部門多選 | 點擊選擇部門 |
3. 空值
支援將「目標表單的欄位值」修改為「空值」。如下圖所示: