CLP - 在控制表中記錄故障 – 支援中心

如果鏈發生故障會發生什麼？讓最終使用者充分瞭解可能的結果是非常重要的。在此 Connected Learning Path 中，我們將通過加入額外的分支來增強我們的主要 Chain，這些分支將通訊回我們的控制表，特別是指示任何故障。這個擴充的 Chain 將提供多一層的透明度，讓使用者可以輕鬆辨識指令最後成功執行的日期。此外，它還可以讓用戶清楚瞭解 Chain 是否已成功運行或遇到任何問題。此項改善可確保使用者具備必要的資訊，以監控並及時處理任何潛在故障。

主要業務使用個案	從集中位置協調報告工作流程讓終端使用者深入瞭解工作流程狀態
主要學習目標	學習如何在 Chain 控制表中加入失敗追蹤學習 Chain 分支學習複製指令
必要條件	完成CLP \| 在控制表中執行程序和記錄結果
支援範本	CLP \| 在控制表中記錄故障

步驟 1：編輯現有連結

導覽至 Chain Builder 並找到 ChainCLP | 在控制表中執行流程和記錄結果
按一下鉛筆按鈕編輯 Chain
按一下右上方的鏈設定
- 重新命名連鎖：CLP | 在控制表中記錄故障
儲存連鎖

步驟 2：為上傳資料程序新增失敗分支

現在，我們將新增命令，用於產生和填入將傳送回控制工作表以指示上載資料程序失敗的值。這樣做的第一步是建立有狀態和時間的檔案。

從File Utilities Connector 新增Create File Command 到 Chain canvas。
連接執行連鎖 - 上傳資料 連鎖事件至建立檔案 指令
按兩下連結以編輯連結條件
- 按一下失敗選項
  
  在選取失敗選項後，連結會變成紅色，表示只有在「執行 Chain - 上傳資料」 Chain 事件失敗時，Chain 才會繼續此分支
雙擊Create File 指令進行設定
- 命令名稱：填入資料上載失敗和時間戳記
- 在Text 欄位中，輸入下列資訊：

資料上傳失敗,(*<System.DateTime>*)

- - 以適當的 Runtime 變數取代(*System.DateTime*) 占位符，這將以程式化方式從 Chains 取得日期和時間。
    - 從Select a Variable 左側面板，展開 Runtime
    - 選擇System.DateTime 值
儲存指令

步驟 3：將上傳失敗的資料寫回控制工作表

我們現在將使用 Write Sheet Data Command 將上一個 Command 中填寫的資訊寫回控制工作表。這將使我們的最終使用者能夠看到資料上傳失敗的情況以及失敗的日期。

從Workiva Connector 新增Write Sheet Data Command 到 Chain canvas
將Populate Data Upload Failure & Time Stamp 指令連結至Write Sheet Data指令
按兩下指令進行設定
- 命名該命令：寫入工作表資料 - 資料上傳失敗
- 按一下試算表 ID 欄位
  - 在Select a Variable 面板內，按一下向下箭頭以展開 Chain
  - 選擇cv-Control 試算表 ID 鍊變數
- 按一下工作表 ID/名稱欄位
  - 在Select a Variable 面板內，按一下向下箭頭以展開 Chain
  - 選擇cv-Control Sheet Name Chain 變數
- 按一下資料檔案欄位
  - 在Select a Variable 面板內，按一下向下箭頭以展開 Populate Data Upload Failure & Time Stamp（載入資料上傳失敗和時間戳記）。
  - 選擇建立的檔案 輸出
- 區域欄位將以 Chain 變數和 JSON 輸出的組合填入，以告知 Chain 目前迭代要寫入到控制工作表中的特定儲存格：
  - 按一下區域欄位，並填入下列內容：
  - cv-Status Column Letter - 在 Chain Variables 下的 Variables 面板中找到的變數。
  - JSON File Iteration - 我們使用迭代的 Row Number 加一來指定要寫入資料的區域。我們加入一來表示標頭行。
    - 從Select a Variable 面板，按向下箭頭展開群迭代器
    - 選擇 <> JSON File Iteration
    - 按一下綠色的 JSON 檔案迭代 藥丸來轉換變數
      - 按一下 Select a Transformation 並選擇 Get Value from JSON
      - 按綠色的 + 符號
      - 在值欄位中輸入行號，然後按 Enter 鍵
      - 選擇另一個轉換，然後選擇 解析編號
      - 按一下綠色的+ 符號
      - 選取另一個變形，然後選取新增
      - 按一下綠色的+ 符號
      - 在值欄位中輸入 1
      - 按一下「接受
        」(Accept)。
  - 在第一個 JSON 檔案迭代之後輸入一個冒號：
  - cv-Time Stamp Column Letter - 在 Chain Variables 下的 Variables 面板中找到的變量
  - JSON File Iteration - 我們使用迭代的 Row Number 加一來指定要寫入資料的區域。我們加一以表示標頭行。
    - 依照上述相同步驟進行第二次 JSON 檔案迭代

儲存指令

步驟 4：新增刷新連線程序的失敗分支

現在，我們將新增用於產生和填入值的 Commands，這些值將回傳到控制工作表，以指示刷新連線程序失敗。這次，我們將複製已建立的兩個 Command，以簡化程序。

按一下Populate Data Upload Failure & Time Stamp指令，然後按一下Copy 按鈕
將Run Chain - Refresh Connections Chain Event 連接到Populate Data Upload Failure & Time Stamp - Copy 指令，該指令剛被複製。
按兩下連結以編輯連結條件
- 按一下失敗選項
按兩下Populate Data Upload Failure & Time Stamp - Copy 指令以設定它
- 命名命令：輸入刷新連線失敗和時間戳記
- 在Text 欄位中，更新下列資訊：
```
Refresh Connection Failed,(*<System.DateTime>*)
```
  - 您會發現系統日期和時間變數不需要更新或新增
儲存指令

步驟 5：將刷新連接失敗寫回控制工作表

我們現在將使用 Write Sheet Data Command 將前一個 Command 中填寫的資訊寫回控制工作表。這將使我們的終端使用者可以看到刷新連線失敗的情況以及失敗的日期。再一次，我們將複製先前建立的 Command 以節省時間。

按一下Write Sheet Data - Data Upload FailureCommand 並按一下Copy 按鈕
連接Populate Refresh Connection Failure & Time Stamp 指令到Write Sheet Data - Data Upload Failure - 複製剛才複製的 指令
按兩下連結以編輯連結條件
- 按一下失敗選項
雙擊Write Sheet Data - Data Upload Failure - 複製指令以設定它
- 命名該命令：寫入工作表資料 - 更新連線 失敗
- 按一下資料檔案欄位，然後刪除變數
  - 在Select a Variable 面板內，按一下向下箭頭以展開Populate Refresh Connection Failure & Time Stamp
  - 選擇Created File 輸出
    - 您會注意到其他欄位已填入 Write Sheet Data - Data Upload Failure 指令所填寫的相同資訊，其他一切保持不變
儲存指令

步驟 6：測試練習

現在 Chain 已經完成，請測試結果。

發佈連鎖
為了測試我們的新指令，我們將透過編輯控制表強制失敗
- 導覽至 Workiva 平台中的CLP 控制表 試算表
- 刪除其中一列的 TableID 值
- 刪除不同行中的試算表 ID 值
導航回CLP | 控制工作表內的記錄故障 鏈，然後按一下Execute 。選擇 執行鏈
一旦連鎖完成，請檢查以下項目，以確認工作流程是否已完成：