若要重複執行連鎖中的命令或命令群組,請設定迭代器。
注意: 要將關聯式資料庫或外部 web 服務的輸出轉換為 JSON 陣列以便與迭代器一起使用,請使用JSON connector 的CSV to JSON 指令 或JSON 變量轉換 。
設定迭代器
使用迭代器,您可以根據以下條件重複指令或群組:
- 數值的靜態或動態清單
- 準確的數值
- 基於條件是否存在
迭代器可以重複指令或群組:
- 靜態的值清單,例如區域或實體
- 動態或可變的值清單,例如來自上載為工作區資源的檔案,或來自鏈中較早命令的輸出。
註記: 指令或群組的迭代次數限制為 1000 次。
要在值清單上執行迭代器:
- 在連鎖中,選擇要重複執行的指令或群組,然後按一下編輯 。
- 在迭代 索引標籤上,啟用迭代器 。
- 在中選擇修改器類型 ,選擇清單。
- 輸入迭代值:
- 對於靜態清單,輸入每次迭代的值,每次輸入後按Enter 。
- 對於動態 清單,請選擇先前命令的輸出,並輸入要使用的值。
- 對於靜態清單,輸入每次迭代的值,每次輸入後按Enter 。
迭代器可以重複命令或群組的確實數值,例如鏈中較早的命令所輸出的總頁數。
步驟 1.設定數值變數
要表示迭代次數,請建立動態鏈變數:
- 在鏈中,為迭代次數添加動態變量 ,如Counter ,無初始值。
- 要在執行鏈時設定變數的初始值,在輸出迭代次數的命令之後,添加設定動態鏈變數 事件:
- 選擇為迭代次數建立的動態變數。
- 在值 ,並輸入起始值,如 1。
步驟 2.新增命令群組
要顯示要迭代的指令和迭代規則,請新增指令群:
- 在設定動態連鎖變數 事件之後,新增指令群 ,並在兩者之間拖曳連結。
- 選擇群組,然後按一下Edit 。
- 在群組的迭代 索引標籤上,啟用迭代器 。
- 在選擇修改器類型 ,選擇重複,直到。
- 按一下+ 規則 ,選擇資料類型為 Float,並指定停止迭代的時間。例如,若要根據先前命令的Total records 輸出進行迭代,請設定規則,當變數值大於 (>)Total records 輸出時,停止迭代。
- 將命令加入迭代到群組。
步驟 3.新增事件以增加變量值
要在每次迭代時增加變量值:
- 作為群組的最後一個步驟,新增另一個設定動態連鎖變數 事件:
- 選擇為迭代次數建立的動態變數。
- 在Value 中,選擇相同的變數。
- 若要變換值 ,點選值 中的變數,並新增解析數值 變換。
- 新增新增 變換,且值為 1,然後按一下接受 。
如果值或值的確實數目未知,您可以根據是否滿足特定條件來遍歷。例如,您可以在指定條件存在時重複執行指令,或直到指定條件存在為止。
步驟 1.為條件值設定變數
要表示指示要遍歷的值的條件,請建立動態鏈變數。例如,如果命令提供了一個布林鍵輸出以指示其回應是否包含額外的頁面,以及一個整數偏移量參數以識別每個頁面,則為這些值建立變數:
- 在連鎖中,,為每個條件新增動態變數 ,且不含初始值。
- 要設定變數在連鎖執行時的初始值,在輸出條件值的命令之後,新增設定動態連鎖變數 事件 ,選擇動態變數,並輸入起始值。
例如,輸入布林鍵的值為 True,偏移值為 0。
步驟 2.新增命令群組
要顯示要迭代的指令和迭代規則,請新增指令群:
- 在設定動態連鎖變數 事件之後,新增指令群 ,並在兩者之間拖曳連結。
- 選擇群組,然後按一下Edit 。
- 在群組的迭代 索引標籤上,啟用迭代器 。
- 在選擇修改器類型 ,選擇重複,直到。
- 按一下+ 規則 ,並指定何時停止迭代,例如當布林鍵為 False 時。
- 將指令加入迭代群組。
步驟 3.設定每次迭代的變數值
在群組的最後一步,加入另一個設定動態連鎖變數 事件,在每次迭代時設定或增加變數值。
- 要設定變量值,請將每個變量對應到先前命令中各自的輸出。例如,對於布林 變數,選擇布林鍵輸出;對於偏移量 變數,選擇整數偏移量參數。
- 要增加變數 ,如偏移量 ,點選它的值,然後套用解析數 變換和增加 變換,每次迭代都要增加數值。
迭代器輸出
您可以使用迭代器的輸出作為其後鏈中其他指令或事件的屬性。輸出取決於迭代器的修飾子-List or重複,直到 。
| 輸出 | 說明 |
|---|---|
| 命令迭代或群組迭代 | 循環中處理的迭代變量值 |
| 索引 | 基於零的計數,表示在循環中處理的迭代次數 |
| 第一次迭代 |
一個布林值,指定所處理的迭代是否為迴圈中的第一個迭代 |
| 最後一次迭代 | 僅適用於List 迭代器,一個布林值,用於指定處理的迭代是否是循環中的最後一次迭代 |
| 總迭代次數 | 僅對於List 迭代器,循環處理的總迭代次數的基於零的計數 |
要將輸出作為另一個命令或事件的屬性,請分別在Command Iterator 或Group Iterator 下選取。