Workiva 支援中心

重要： 在任何這些索引標籤上按一下取消 ，即可關閉命令組態對話框。自上次按下儲存 後所做的任何變更，都將被捨棄且無法復原。

修改命令標籤

修改命令 選項卡讓您設定執行此命令時要考慮或排除哪些欄位。

修改此命令：

1. 選取修改命令 索引標籤。
2. (選項) 在Name 中，修改提供者的預設名稱。
3. (選項) 在Description 中，輸入有用的說明，說明組態命令的用途。

4. 在Command Properties（命令屬性） ，選取適合此命令的Workday Connection 以及連接/串連類型 (CloudRunner 或 GroundRunner)。

   附註： CloudRunner 為預設選取，但此連線也可使用 GroundRunner。安裝和使用 GroundRunner 的相關資訊，請參考 Workiva 支援頁面安裝和管理 GroundRunner 。

5. 選取要使用的輸入檔案 。
   這是一個包含來源資料的 .csv 檔案。此檔案的範本可從 Workiva 文件中取得。

   附註：如果您使用 EIB 範本 (請參閱下文)，CSV 的歸檔首頁/標頭必須與範本檔案中定義的欄位相符。

6. 在預算組態 下 ，輸入與計劃結構相關聯的預算結構 ID ，以及與財務計劃名稱相關聯的Custom_Budget_ID 。

7. 選取要使用的匯入模式 。

   匯入模式	行為
   僅新增	新增行並更新現有的行。不刪除任何內容。
   取代全部	刪除整個現有預算計劃，並嚴格以檔案中的資料取代。
   已刪除的新增	同步系統以符合上傳的檔案。新增、更新現有，並刪除系統中上傳檔案中遺漏的任何行。
   取代所有期間/週期	僅針對在上傳檔案 中尋找的時段/週期，清除並取代資料。保留其他月份/週期的資料。

8. (選項) 輸入備忘錄 ，說明命令的目的。

9. 選取此節點完成時要觸發的動作程序。

   命令	說明
   自動完成	當記號被標示（勾選）時，業務流程會自動處理。這意味著所有核准者將自動在系統中核准，所有審閱／待辦事項將自動繞過，所有通知將自動壓制。
   提交	當記號被標記（勾選）時，鏈結會自動提交動作。

最後一個欄位和核取方塊僅適用於使用 EIB 範本。如果您沒有使用 EIB 範本檔案，則可以忽略這兩項。

附註：EIB 範本必須是定義完成匯入預算動作所需欄位的 XML 檔案。如果指定，這將優先於 「預算組態 」資料。

1. 如果使用 EIB 範本檔案匯入預算資料，請在EIB 範本檔案 欄位輸入檔案名稱。
2. (選項）選取Ignore warnings 核取方塊，可忽略任何遺漏選用欄位的所有警告。
   範本檔案包含選用/選填欄位，因此除非選取此選項，否則若欄位不存在，命令將產生錯誤。
   此選項只適用於使用 EIB 範本的匯入預算流程。

通知索引標籤

通知 標籤可讓您設定在符合條件時發送的通知電子郵件。

建立通知：

1. 選取Notifications 索引標籤。
2. 按一下新的通知 。
3. 按一下電子郵件 。
   

4. 完成通知面板上的欄位。 

   

   通知面板欄位

   欄位名稱	支援的值和動作有
   條件	支援的條件有： 成功： Success: 命令已正確完成。 Error: 命令以某種方式失敗。 警告: 這表示預定的結果受到影響，但可能還存在未解決的情況，不知道是如何發生的。請檢查命令的輸出記錄，以瞭解觸發此程序的具體原因。  暫停 是命令的狀態。如果命令為 「暫停」，則會傳送通知。它與暫停通知無關。 永遠傳送 ：總是傳送訊息。
   收件者	訊息要傳送給的電子郵件地址（必須是完整的電子郵件地址）。在此欄位中按一下，會開啟一個下拉式 (清單)，列出工作區有效的所有電子郵件地址。無法提供其他電子郵件。
   主旨	電子郵件的主旨行。預設使用Chains.Environment（自動化工作流程）,Chain.Name, 和Command Name 變數，接著是選取的條件，但如果需要，您也可以輸入自己的文字。
   附件	這可讓您在電子郵件中附加檔案。從組態對話框左側的Select a variable 窗格中列出的檔案中選取。
   附件名稱	這是要指派給檔案的名稱（包括延伸模組/副檔名，如 .txt 或 .csv）。
   訊息本文	要顯示在電子郵件訊息中的文字。支援基本 HTML 格式設定。

5. 按一下「儲存」(Save)。

若要傳送其他電子郵件通知，請按一下目前通知下方的新的通知 ，並重複這些步驟。

關於通知的更多資訊，請參考 Workiva 支援頁面管理鏈結和命令通知 。

跳過條件索引標籤

跳過條件 選項卡允許您指定將導致命令被跳過的條件，以及如果命令被跳過將會發生什麼。

要為此命令建立跳過條件：

1. 選取跳過條件 索引標籤。
2. 按一下跳過條件 欄位，然後選取觸發程序。
   選項有： 選取/選填： 
   • Success (命令已正確完成)。
   • Error (命令以某種方式失敗)。

   • 警告 （這表示預定的結果受到影響，但可能還存在未解決的情況，不知道是如何發生的。檢查命令的輸出記錄，以瞭解觸發此程序的更多具體原因)

     

3. 建立決定跳過命令時會發生何事的規則。
   1. 選取AND 或OR 。預設第一條指令以AND 起始者。

   2. 按一下+RULE ，然後選取要測試的資料型別。
      選項有String (預設)、Integer,Date,Float, 和JSON 。

      

   3. 輸入要用於測試的準則。

   4. 選取測試值。選項如下：Is Blank

      選項	結果
      是否為空白	結果為空白（空設定）。
      Is Not Blank	結果不是空設定。
      包含	結果包含特定值。選取此選項可開啟第二個欄位，讓您輸入要匹配的字串。
      匹配 RegExp	結果符合特定的正規表示式。選取此選項可開啟第二個欄位，讓您輸入正規表示式。
      起始者	Result（結果）以特定字串起始者。選取此選項可開啟第二個欄位，讓您輸入字串。
      結束於	結果以特定字串結束。選取此選項可開啟第二個欄位，讓您輸入字串。
      = (等於)	結果符合特定值。選取此選項可開啟第二欄位，讓您輸入值。
      != (不相等)	結果不符合特定值。選取此選項可開啟第二欄位，讓您輸入值。
      < (小於)	結果小於特定值。選取此選項可開啟第二欄位，讓您輸入值。
      > (大於)	結果大於特定值。選取此選項可開啟第二欄位，讓您輸入值。
      <=(小於或等於)	結果小於或等於特定值。選取此選項可開啟第二欄位，讓您輸入值。
      >= (大於或等於)	結果大於或等於特定值。選取此選項可開啟第二欄位，讓您輸入要考慮的值。

4. 如果只有一個條件，請按一下儲存 。
5. 如果您有多個條件，請再次按一下+RULE 以新增單一條件，或+GROUP 以將條件當成群組評估。

附註

• 條件依其排列順序（從上至下）進行評估。群組條件是以一個單元來評估，然後根據群組在清單中出現的順序來評估其結果。
• 沒有重新排列條件順序的方法；如果您要變更條件的順序，則必須按照您希望評估的順序重新建立清單。
• 有關跳過條件的更多資訊，請參考 Workiva 社群/社區頁面跳過條件：Not to Be Skipped, But Definitely Worth Considering! 和 Workiva Support 頁面管理鏈結中的命令.

動態輸出索引標籤

動態輸出 選項卡允許您指定從命令輸出中提取值或值清單的規則，這些值或值清單可以在鏈結的後面使用。您可以使用下列任一種方式，新增多個動態輸出到一個命令：

• 精確匹配 - 要擷取值的起始者或結束者的特定文字。
• 正規表達式 - 根據特定圖案或序列來匹配值。

若要設定動態輸出規則，請完成下列步驟。

1. 選取動態輸出 索引標籤。
2. 按一下+ADD DYNAMIC OUTPUT 。這會顯示動態輸出組態面板。
   
3. 為此輸出輸入一個名稱 。
4. 在Original output 中 ，選取要轉換／轉型的輸出。
5. 組態輸出的衍生和儲存方式。下列欄位皆為選用/選填。
   • 匹配文本 欄位可以包含要匹配的文字或正規表示式。
   • 若要精確匹配所提供者的文字，請在鍵入匹配類型 中選取「精確」。
   • 要使用正則表達式，請在中選取「正則表達式 (regex)」，匹配類型 。
   • 在匹配結果 中，輸入結果文字的顯示方式。
     例如，如果結果是括在括號內的數字，您可以輸入$0 來顯示包括括號在內的整個匹配值，或$1 來只顯示不包括括號在內的匹配數字。
   • 若要只匹配輸出中特定行的文字，請在要檢查的行中輸入以逗號分隔的行號或數字範圍。若要包括行的範圍，請使用破折號 (-)，因此 1-10 只會回傳第 1 行至第 10 行的內容。若要分隔行或範圍，請使用逗號 (,) ，因此 1-10, 13 只會回傳第 1 到第 10 行以及第 13 行的內容。
6. 在Output type 中 ，選取您要傳回單一輸出或輸出清單。
7. 記號或清除Case sensitive 和Trim Matches 核取方塊，以產生您想要的結果。
8. 按一下「儲存」(Save)。
9. (選項) 按一下測試 ，看看是否得到預期的結果。

如果要建立額外的動態輸出，請按一下+ADD DYNAMIC OUTPUT 。這會顯示額外一個動態輸出的動態輸出組態面板。

有關使用動態運算符號的更多資訊，請參閱 Workiva 支援頁面管理命令的動態輸出 。

錯誤動作索引標籤

Error actions 選項卡允許您指定在處理命令流程中發生錯誤時要採取的動作。

若要設定此命令產生錯誤時要採取的動作，請： 選取 Error Actions 標籤：

1. 選取Error Actions 索引標籤。
2. 在Error actions 下 ，選取您希望在命令失敗時鏈結採取的動作。
   • 若要遵循鏈結的分支邏輯，請選擇「使用鏈結繼續」(Continue with chain)。
   • 若要暫時停止鏈結（例如解決問題），請選取「 暫停鏈結」。 
     若要在問題已解決後再重新開始鏈結，請選取鏈結中的命令，然後按一下Resume 。
   • 若要完全停止鏈結，請選擇「離開鏈結」(Exit chain)。
3. 若要在命令執行時間超過預期時停止命令，請在Timeout conditions 下 ，輸入任務執行的最長時間（以秒為單位）。
4. 若要重試命令的資料來源為間歇或無法使用，請輸入重試次數，以嘗試在嘗試間需等待幾秒。
   

5. 在Error conditions 下 ，選取要忽略的錯誤。

   條件	說明
   無效參數	記號會使命令忽略任何無效的參數。
   一般故障	記號會使鏈結繼續，即使此命令可能已失敗。

6. 若要根據輸出設定命令的狀態，請按一下輸出解釋 左側的綠圈加號。
7. 按一下+Rule ，然後定義規則 - 或規則群組 - 以解釋輸出狀態。
   
   如果要指定其他條件，請按一下藍色圈中的加號，以新增條件定義欄位。
   條件依列出的順序評估（從上至下）。群組條件會以一個單元來評估，然後根據群組在清單中出現的順序來評估其結果。

附註： 無法重新排列條件的順序；如果要變更條件的順序，您必須依據要評估的順序重新建立清單。

8. 在Log interpretation 下 ，選取是否根據特定輸出使命令失敗。
   • 若要not 根據特定輸出使命令失敗，請選取Do not interpret 。
   • 若要在找到特定輸出時使命令失敗，請選取Fail if output(s) found ，並輸入要掃描的輸出。
   • 若要在找不到特定輸出時使命令失敗，請選取Fail if output(s) not found ，然後輸入要掃描的輸出。
   • 以\n 分隔多行文字。
9. 按一下「儲存」(Save)。

迭代器標籤

迭代器 選項卡允許您設定 Get Workers 命令的迭代（循環或重複）規則。

附註： 此索引標籤預設為停用。

若要設定迭代器，請完成下列步驟。

1. 選取迭代器 標籤。
2. 切換標籤頂端的開關，啟用迭代器。 
   
   這樣做會將標籤頭 (迭代器) 旁邊的圖示從深灰色變更為藍色，並顯示迭代器組態面板。標籤標題下一步/下一個標記也變成綠色。
   

3. 選取要使用的修改器類型 。
   選項有List (預設) 和Repeat until 。

   • 選取List 會使命令重複執行：
     • 靜態的值清單，例如區域或實體。這也可以是一個數字，例如「3」。
     • 值的動態或變數清單，例如來自上傳為工作區資源的檔案或鏈結中較早命令的輸出。
   • 選取Repeat until 會使命令重複執行，直到符合指定條件為止。

   附註： 命令最多只能迭代 1000 次。

4. 輸入控制迭代器的規則。
   有關使用迭代器的更多資訊，包括如何指定迭代器，請參閱 Workiva 支援頁面使用具有命令和命令群組的迭代器 。
5. 按一下「儲存」(Save)。