CLP - 在控制表中執行流程和記錄結果 – 支援中心

現在是時候將各項工作匯集到一個集中式報告工作流程中，在此我們將處理新資料，並使用單一 Chain 來刷新依賴於該資料的連接。在本連線學習路徑中，我們將使用控制工作表中的變數來執行工作流程，在更新控制工作表狀態的同時準備資料，讓業務使用者更清楚地瞭解工作流程最近完成的時間。

主要業務使用個案	從集中位置協調報表工作流程簡化終端使用者的工作流程管理讓終端使用者深入瞭解工作流程的完成情況
主要學習目標	瞭解如何使用控制表中的值執行類似的流程使用連鎖指令為控制工作表新增記錄
必要條件	完成CLP \| 從控制表路徑使用值配置以下連接器：檔案公用程式表格轉換
支援範本	CLP \| 在控制表中執行程序和記錄結果

步驟 1：更新控制表以包含記錄

為了通知終端使用者 Control Sheet 執行流程的狀態和最新更新，我們需要一個地方來儲存工作流程執行時間和該工作流程狀態的詳細資訊。我們將在控制表中儲存此資訊。

從 Workiva 平台，導覽至CLP 控制工作表 試算表
在 FileLocation 欄之後新增兩列，標題如下：
- 狀態
- 時間戳記
請勿在這些列的標題下方新增任何值

步驟 2：編輯現有的連結

導覽至 Chain Builder 並找到 ChainCLP | 使用控制表中的值
按一下鉛筆按鈕編輯 Chain
按一下右上方的Chain Settings
- 重新命名 Chain：CLP | 在控制表中執行程序和記錄結果
- 在 Chain Variables（鏈變量）下，按兩下 Plus 符號，以建立兩個 Chain Variables（鏈變量），並將其設定如下：
  - 類型：連鎖變數 (cv)
    - 名稱：cv-Status 欄位字母
    - 值：Status 標頭所建立的列字母
      - 在提供的示例中，值是F
  - 類型：連鎖變數 (cv)
    - 名稱：cv-Time Stamp Column Letter
    - 值：Time Stamp標頭所建立的列字母
      - 在提供的示例中，值是G
- 現在連鎖應該有四個連鎖變數
儲存鏈

步驟 3：新增行數指令

我們將使用Add Row Numbers Command 自動新增行號至控制工作表。這將允許我們確定記錄應在控制工作表中的何處發生。

雙擊 Get Sheet Data Command 和Convert Control Sheet to JSON Command 之間的連結。
- 按一下刪除按鈕，以斷開連結
從Tabular Transformation Connector 新增Add Row Numbers 指令至 Chain canvas
將Get Sheet Data Command 連接到Add Row Numbers Command
將Add Row Numbers 指令連接至Convert Control Sheet to JSON指令
雙擊Add Row Numbers 指令進行設定
- 按一下輸入檔案 欄位
  - 在Select a Variable（選取變數） 面板內，按一下向下箭頭以展開Get Sheet Data（取得工作表資料
  - 從Get Sheet Data 指令選取Data 輸出。
儲存指令

現在我們已將 Row Numbers 加入資料集，因此需要更新後續 Command 以使用轉換後的資料。在這種情況下，需要更新 CSV 至 JSON 指令。
- 雙擊Convert Control Sheet to JSON 指令以更新它
  - 按一下輸入檔案 欄位，並刪除取得工作表資料輸出
    - 在Select a Variable 面板內，按一下向下箭頭以展開Add Row Numbers。
    - 從Add Row Numbers 指令中選擇Add Row Numbers輸出
- 儲存指令

步驟 4：執行上傳資料到 Wdata 的程序

現在，我們將使用控制表中的變數來執行上載資料到 Wdata 表的程序。我們將使用 Run Chain 事件來執行，該事件會啟動 Upload Data to Wdata Chain，該事件來自Uploading Data to a Table Path 。

現在我們已經可以使用 Handlebars 從控制工作表中使用變數進行可視化，因此不再需要 Handlebars 指令
- 將滑鼠移至 Handlebars 指令上方，然後按一下垃圾筒以刪除
  - 按一下刪除，確認刪除指令
在 Chain canvas 上新增Run ChainEvent
將Active Flag Conditional Command 連接到Run Chain Event
按兩下指令進行設定
- 命名該命令：執行連鎖 - 上載資料到 Wdata
- 按一下Chain 下拉式 ，然後選擇 ChainCLP | Upload Data to a Table
- 使用控制表中的變數設定 Runtime Inputs：
  - 按一下表 ID 欄位
    - 從Select a Variable 面板，按一下向下箭頭以展開Group Iterator
    - 選擇 <> JSON File Iteration
    - 按一下綠色的 JSON 檔案迭代 藥丸來轉換變數
      - 按一下 Select a Transformation 並選擇 Get Value from JSON
      - 按綠色的 + 符號
      - 在值欄位中輸入TableID，內容與控制工作表中的一模一樣，然後按 Enter 鍵
      - 按一下「接受」(Accept)。

- - 按一下檔案名稱欄位
    - 按照上面相同的步驟使用控制工作表中的變數，使用FileName欄位代替 TableID
  - 按一下File Location欄位
    - 按照上面的相同步驟使用控制工作表中的變數，使用FileLocation欄位代替 TableID
儲存指令

步驟 5：執行流程以刷新連接

接下來，我們將使用控制表中的變數來執行一個流程，以刷新報表電子表格中的資料，讓終端使用者可以使用新上傳的資料。我們將使用 Run Chain 事件來執行此功能，該事件會從Refresh List of Connections Path 中啟動 Refresh List of Connections Chain。

在 Chain canvas 上新增Run ChainEvent
連接Run Chain - Upload Data to Wdata Chain Event 到Run Chain Event
雙擊指令進行設定
- 命名該命令：執行連鎖 - 重新整理連線
- 按一下Chain 下拉式 ，然後選擇 ChainCLP | Refresh List of Connections
- 使用控制工作表中的變數配置運行時輸入：
  - 按一下試算表 ID 欄位
    - 從Select a Variable 面板，按一下向下箭頭以展開Group Iterator
    - 選擇 <> JSON File Iteration
    - 按一下綠色的 JSON 檔案迭代 藥丸來轉換變數
      - 按一下 Select a Transformation 並選擇 Get Value from JSON
      - 按綠色的 + 符號
      - 在值欄位中輸入試算表 ID，與控制工作表中的值完全相同，然後按回車鍵
      - 按一下「接受」(Accept)。

儲存指令

步驟 6：填入狀態和時間戳記指令

現在，我們將新增用於產生和填入數值的指令，這些數值將傳送回控制工作表，以指示工作流程是否成功。這樣做的第一步是建立具有狀態和時間的檔案。

從File Utilities Connector 新增Create File Command 到 Chain canvas。
將執行連鎖 - 重新整理連線 連鎖事件連接到建立檔案 指令
按兩下指令進行設定
- 命名命令：名稱：填入狀態與時間戳記
- 在Text 欄位中，輸入下列資訊：

資料上傳與更新完成,(*<System.DateTime>*)

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

步驟 7：寫回控制工作表

現在，我們將使用 Write Sheet Data（寫入工作表資料）指令，將上一個 Command 中填寫的資訊寫回控制工作表。這將使我們的終端使用者能夠看到流程，顯示資料載入和更新的狀態，以及更新的日期。

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