Workiva 支援中心

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

附註： 在您加入鏈結之前，請確保您的組織設定連接 所需的連線，以啟用與其資料來源的命令。

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

將命令新增至鏈結

1. 在鏈結中，選取要執行的命令：
   • 若要在連鎖中加入新指令，請在Available Connectors 下，按一下它的連線，然後將指令移到它應該出現在連鎖中的位置。
   • 若要複製現有命令，請選擇其節點，按一下「複製」(Copy)file_copy，然後移動制節點應在鏈結中出現的位置。

   秘訣： 若要新增一個命令作為鏈結的第一節點，請將它移至起始者 。

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

   注意：要變更節點在鏈結中的位置，請取消其與其他節點的連結，然後將其移動到應發生的位置。若要一次移至多個節點，請在選取這些節點時按住SHIFT 。

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

僅執行單一命令或群組

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

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

略過命令

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

1. 在鏈結中，選擇命令的節點，按一下編輯 建立 ，並選擇跳過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)。

查看命令輸出

從Monitorflight_takeoff ，您可以預覽透過 CloudRunner 執行的命令輸出。 

1. 在建立器的「監控」中開啟附輸出的運行進行預覽，然後選擇命令。
2. 在Outputs 選項卡上，按一下Preview the outputvisibility 以檢視輸出。
   

附註： 您只能預覽透過 CloudRunner 執行的命令輸出，而非 GroundRunner。

移除鏈結中的命令

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

附註： 為了協助確保鏈結的邏輯性，如果命令的父代有多個同級分支或分支，則不能刪除該命令。