在鏈結中管理命令

命令是根據與資料來源的連線在鏈結中執行的任務。對於更複雜的鏈結，這可能包括由各種條件觸發的命令。

注意：在新增鏈結之前，請確保您的群組織設定啟用與其資料來源的命令所需的連線。

要連續執行特定命令——即依次執行命令，每個命令都會等待上一個命令完成——或以並行的方式同時執行命令，或者需要設定為：當多個命令中的一個失敗則整個命令鏈失敗，請將它們分在同一組。

將命令新增至鏈結

1. 在鏈結中，選取要執行的命令：
   • 若要為鏈中新增命令，請在 可用連接器下按一下其連接，然後將命令移至鏈中應出現的位置。
   • 若要複製現有命令，請選擇其節點，按一下「複製」(Copy)file_copy，然後移動制節點應在鏈結中出現的位置。

   提示：要將命令新增為鏈結的第一個節點，請將其移動到「開始」。

2. 若要將命令連結到鏈中的前一個和下一個節點，請按一下並拖曳其節點連接埠之間的線條。

   注意： 要更改節點在鏈中的位置，請取消其與其他節點的鏈接，然後將其移動到應出現的位置。要一次移動多個節點，請在選取它們時按住 Shift。

3. 選擇新節點，然後按一下「編輯」(Edit)create。
4. 輸入命令的參數：
   • 在「基本資訊」(Basic Info) 下，輸入唯一的名稱和描述以識別命令和其用途。
   • 如果您想遮罩敏感資料輸出，請切換眼睛圖示。
   • 若要多次執行命令，如對清單中的各項目，請啟用「迭代器」repeat，然後輸入迭代值。
   • 在「命令屬性」(Command Properties) 下根據連接器輸入命令的輸入。
5. 按一下「儲存」(Save)。

僅執行單一命令或群組

為了在您建立鏈節時簡化測試並加速迭代，您可以在鏈結中執行單一命令或命令群組。

1. 在「鏈結產生器」的「鏈結」索引標籤中，從「鏈結」的功能表中選取「執行」flight_takeoff。
2. 若要執行命令或群組，請按一下執行此命令play_circle_outline。
3. 按一下「執行鏈結」(Run Chain)。

略過命令

要開發分支邏輯，或作為開發鏈結的一部分，您可能需要略過命令以強制產生特定結果。您還可以設定條件邏輯，以根據設定的規則自動傳回特定結果。

1. 在鏈結中選取命令節點，按一下「編輯」 create ，然後選擇「略過」skip_next 。
2. 選擇跳過命令時是否要自動回傳結果資訊 check_circle、警告warning 或錯誤 error。
3. 若要僅在滿足特定條件時略過該命令，請指定時間。將條件邏輯建立為一個群組，向其新增規則和其他規則群組，每個規則群組都使用 AND 或 OR 布林值聯結。
   • 如果必須滿足所有條件才能略過，請選擇 AND。
   • 如果只有一個條件必須為真才能略過，請選擇 OR。

   您可以為多種資料類型新增規則：

   資料類型	說明
   字串	兩個或更多字元
   整數	任何整數、無小數點的數值
   日期	任何日期字串或日期變數
   浮點	任何數值
   JSON	JavaScript 物件表示法；使用變數轉換來解析物件

   若要驗證資料是否符合命令的略過規則，請將其與運算符號和值配對：

   • Is blank 或 Is not blank
   • 包含
   • Matches RegExp，用於正則運算式
   • Starts with 或 Ends with
   • = or !=
   • < 或 >
   • <= or >=
4. 按一下「儲存」(Save)。

管理命令的處理錯誤作業

若要偵測或忽略命令的錯誤：

1. 在鏈結中選取命令結點，按一下「編輯」(Edit)create，然後選擇「處理錯誤」warning。
2. 在「錯誤動作重複」下，選取命令失敗時要執行的動作。
   
   • 若要遵循鏈結的分支邏輯，請選擇「使用鏈結繼續」(Continue with chain)。
   • 若要暫時停止鏈結（例如解決問題），請選取「 暫停鏈結」。要在問題解決後重新啟動鏈結，請選取鏈結中的命令，然後按一下「繼續」。
   • 若要完全停止鏈結，請選擇「離開鏈結」(Exit chain)。
3. 要停止命令（如果它花費的時間比應花費的時間長），請在「超時條件」警報下輸入以秒為單位的最大持續時間。
   
4. 若要重試命令的資料來源為間歇或無法使用，請輸入重試次數，以嘗試在嘗試間需等待幾秒。
5. 在「錯誤條件」(Error conditions)priority_high 下，選擇所有要忽略的錯誤，例如建立已經存在的資料夾。
6. 若要根據命令的輸出設定命令的狀態，請按一下「輸出解譯」下的「新增」，然後定義規則（或規則群組）以解譯其狀態。例如，使用「命令詳細資訊」輸出的「狀態」變數，可以將規則設定為在命令成功時出現警告。
   
7. 在「編譯日誌」(Log interpretation) 下選擇是否根據特定輸出成果使命令失敗。
   • 為了避免因特定的輸出而失敗，請選擇請勿轉譯。
   • 若要在找到特定輸出時使命令失敗，請選擇「若找到輸出時失敗」，並輸入要尋找的輸出。
   • 若要在找不到特定輸出時使命令失敗，請選擇「若找不到輸出時失敗」，並輸入要尋找的輸出。
   • 多行文字需要用 \n分隔
8. 按一下「儲存」(Save)。

查看命令輸出

在「監控 」flight_takeoff，您可以預覽透過 CloudRunner 執行之命令的輸出。 

1. 在建立器的「監控」中開啟附輸出的運行進行預覽，然後選擇命令。
2. 在輸出分頁按一下預覽輸出觀看權限以查看輸出。
   

注意：您只能預覽透過 CloudRunner 執行之命令的輸出，而不能預覽 GroundRunner。

移除鏈結中的命令

若要移除鏈結中的命令，請按一下其節點，按一下「刪除」(Delete)delete，然後再按一下「刪除」。

注意：為協助確保鏈結的邏輯，如果命令的父系在同一層級上有多個同層級或分支，則無法刪除該命令。