Workiva 支援中心

將步驟合併到相同的鏈中，可以進一步簡化資料管理。在本連線學習路徑中，我們將介紹在 Wdata 表中替換資料的最佳方式，這是使用一個 Chain 的兩步流程。

步驟 1：執行連結

1. 巡覽到CLP | 上傳資料表格 鏈結。
2. 按一下Execute ，然後選取Run With Inputs 。
3. 輸入 Runtime Inputs 的值：
   • 表格 ID- CLP Employee Detail Table 的 ID
     尋找此文件以協助 尋找 ID 。
   • 檔案名稱- 您想稱呼檔案的任何名稱，在本範例中，我們稱該檔案為 "Employee Detail"。
   • 檔案位置 -https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail.csv 。
4. 按一下啟動 。
5. 鏈結完成後，點擊Import File into Table 節點驗證是否成功(地)。
   CLP Employee Detail Table 中現有可用的資料，我們現在將以更新的資料集取代，使用單一鏈刪除舊資料並上傳新資料。

步驟 2：建立連鎖

1. 新增鏈條 。
2. 命名該 Chains（自動化工作流程）：CLP | 取代表格中的資料 。
3. 保存 鏈條。

步驟 3：運行時輸入

我們使用 Runtime Inputs 指令啟動連線。這可讓我們指定執行 Chain 時，要匯入檔案的檔案名稱和表格 ID。

1. 從 Chains（自動化觸發事件）的 Start 區域新增一個Runtime Inputs 命令。
2. 在命令上按兩下，編輯Runtime Inputs Chains（自動化工作流程）事件。
   新增以下三個 Input：
   • 輸入 1：
     • 類型：TextField文字欄位
     • 顯示名稱：表 ID
     • 需要：已勾選
   • 輸入 2：
     • 類型：TextField文字欄位
     • 顯示名稱：檔案名稱
     • 需要：已勾選
   • 輸入 3：
     • 檔案位置文字欄位
     • 顯示名稱：檔案位置
     • 需要：已勾選
3. 儲存指令。

步驟 4：列出檔案

要刪除表中的舊檔案，我們需要檔案 ID。若要以程式方式查找 FileID，我們將使用 List Files 指令。此指令使用資料表 ID 搜尋該資料表中的所有檔案，並提供檔案輸出以及這些檔案的相關資訊，包括檔案 ID。

1. 在 Chain canvas 上新增List Files 指令
2. 連接Runtime Inputs Chains（自動化工作流程）至List Files 命令。
3. 雙擊該命令以進行組態配置。然後在表格 ID 欄位上按一下。
4. 在左側變數 面板內，按一下向下箭頭以展開觸發程序 。
   1. 單擊向下箭頭，展開Runtime Inputs 。
   2. 選取TableID 。
5. 儲存指令。

步驟 5：從表中取消匯入檔案

與上傳資料到資料表相似，從資料表刪除資料也是一個兩步驟流程。刪除檔案前，必須先將檔案移至暫存狀態。若要將檔案設定為暫存狀態，則需要取消匯入。我們將使用Un-Import File from Table 命令來準備已刪除的資料集。

1. 在 Chains（自動化工作流程）中新增Un-import File from Table 命令。
2. 連接List Files 命令至Un-import File from Table 命令。
3. 雙擊該命令以進行組態配置。
   1. 按一下Table ID 欄位。
      1. 在左側變數 面板內，按一下向下箭頭以展開觸發程序 。
      2. 單擊向下箭頭，展開Runtime Inputs 。
      3. 選取TableID 。
   2. 按一下File ID 欄位。
      1. 在左側變數面板中，按一下向下箭頭以展開List Files 。
      2. 選取檔案清單 。
      3. 點選List Files - 檔案清單變數 ，轉換變數。
         1. 按一下選取轉換型 ，然後選擇從 JSON 取得值 。
         2. 按一下加號，以新增變數轉換／轉型。
         3. 在值欄位中鍵入 '0' 然後按輸入 。
         4. 在=0 出現後，鍵入 'ID' 然後按再次輸入 。
            變數現在會讀取 List Files 指令的 JSON 輸出，並找出表格中第一個檔案的 ID。

            提示！解析 JSON 值時，請特別注意大寫與小寫。

         5. 按一下「接受」(Accept)。
            
   3. 儲存 指令。
      

    

   步驟 6：下載檔案

   下一步/下一個，我們可從表格中已刪除暫存檔案，或準備上傳新的檔案。我們建議在已匯入舊檔案後再上傳新的檔案，以確保在正式刪除任何資料前，流程已成功(地)。

   為了準備上傳新的檔案，我們首先要使用 HTTPRequest Get 命令下載檔案。我們已在線上提供一個檔案供 Chain 下載，以示範從雲端下載檔案。

   1. 從HTTP Request 連接器新增Get Command 到 Chains（自動化工作流程）。
   2. 連接Un-import File from Table 命令至Get 命令。
   3. 按兩下該命令以進行組態設定。
      
      1. 按一下URL 欄位。
         1. 在左側Select a Variable 面板內，按一下向下箭頭以展開Trigger。
         2. 按一下向下箭頭以展開Runtime Inputs。
         3. 選取檔案位置。
      2. 更新內容類型 欄位為：application/csv。
   4. 儲存 指令。

   

   步驟 7：建立檔案

   就像我們在Upload Data to Table Connected Learning Path 所做的一樣，我們將遵循上載資料到 Wdata 表的兩個步驟。檔案首先需要在Staged 狀態下建立，才能匯入供最終使用。我們將使用 Create File 指令在 Wdata Table 中建立檔案，並將其置於 Staged 狀態，表示該檔案已建立但尚未匯入為資料集。

   1. 從Workiva 連接器 新增建立檔案 命令至 Chains（自動化工作流程）。
   2. 連接Get Command 到Create File Command。
   3. 雙擊該命令以進行組態配置。
      
      1. 按一下Table ID 欄位。
         1. 在左側Select a Variable 面板內，按向下箭頭展開Trigger。
         2. 按一下向下箭頭，以展開Runtime Inputs。
         3. 選取表格 ID。
      2. 按一下「檔案」欄位。
         1. 在左側Select a Variable 面板內，按一下向下箭頭以展開 GET。
         2. 選取Response。
      3. 按一下名稱 欄位。
         1. 在左側Select a Variable面板內，按一下向下箭頭以展開Trigger。
         2. 按一下向下箭頭，以展開Runtime Inputs。
         3. 選取檔案名稱。
         4. 在左側Select a Variable面板中，按一下向下箭頭以展開 Runtime。
         5. 選取Chains（自動化工作流程）。
         6. 在兩個變數後鍵入 ".csv" 。
            Chains（自動化工作流程）的變數 ExecutionDateTime 用來顯示檔案的產生時間，並確保每個檔案都有唯一的名稱。

   

   步驟 8：匯入檔案至表格

   上傳檔案至 Wdata 資料表格的下一步/下一個流程是匯入資料，使其可在 Queries 中使用。此步驟擷取暫存檔案，並將其作為資料集匯入指定的資料表。

   1. 從Workiva 連接器 新增 Import File into Table 命令至 Chains（自動化工作流程）。
   2. 連接建立檔案 命令至 匯入檔案至表格 命令。
   3. 雙擊該命令以進行組態配置。
      
      • 對於表格 ID 欄位：
        1. 在左邊的 Select a Variable面板內，按一下向下箭頭以展開Trigger 。
        2. 單擊向下箭頭展開Runtime Inputs 。
        3. 選取表格 ID 。
      • 對於檔案 ID 欄位。
        1. 在左側Select a Variable 面板中，按一下向下箭頭以展開Create File 。
        2. 選取Result 。
        3. 按一下建立檔案 - 結果 進行轉換／轉型。
           1. 在Select Transformation 下拉式 (清單) 中，選擇Get Value from JSON 。
           2. 按一下 + (加號) 按鈕。
           3. 在值欄位中，輸入 "ID" ，然後按輸入 。
           4. 按一下「接受」(Accept)。
   4. 儲存 指令

   

   步驟 9：刪除檔案

   現在，新資料已上傳並準備就緒可供使用，舊資料集也已暫存，最後一個步驟是正式刪除舊資料。此級距使用歸檔/申報 命令從表格中刪除資料集。

   1. 從Workiva Connector 新增Delete File Command 到 Chain canvas。
   2. 將Import File into Table 指令連接至Delete File 指令
   3. 雙擊該命令以進行組態。
      為了確保我們刪除的是未匯入的相同檔案，我們將以與從表格中解除匯入檔案命令相同的方式產生檔案 ID：
      • 在檔案 ID 欄位中：
        1. 在左側的變數 面板中，按一下向下箭頭以展開List Files 。
        2. 選取檔案清單 。
        3. 點選List Files - Files List 變數，以轉換變數。
           1. 點選Select Transformation ，然後選取Get Value from JSON 。
           2. 按一下加號 (+) 以新增變數轉換／轉型。
              1. 在Value 欄位中鍵入 '0'，然後按輸入 。
              2. 在=0 出現後，鍵入 'ID' 並再次按輸入。
                 變數現在會讀取 List Files 指令的 JSON 輸出，並找出表格中第一個檔案的 ID。

                 提示！解析 JSON 值時，請特別注意大寫與小寫。

              3. 按一下「接受
                 」(Accept)。
              4. 另存新檔 the Command.xx
                 

               

              步驟 10：測試練習

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

              1. 按一下 執行 ，然後選取隨選即用輸入執行 。
              2. 為您的 Runtime Inputs 新增值。
                 • 表格 ID- CLP Employee Detail Table 的 ID
                   尋找此文件以協助/說明 ID
                 • 歸檔名稱- 您想稱呼檔案的任何名稱；在本範例中，我們稱該檔案為 "Employee Detail"。
                 • 檔案位置 -https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail_replace.csv
              3. 按一下Start
                 • Chains（自動化工作流程）應已成功移除舊檔案，並用新的檔案取代到您的表格中。
                 • 您可以巡覽到 Wdata 中的表格，並審閱／審核右側面板中的資料集，以驗證表格中的資料是否已被取代。

              

              

              要瞭解有關使用 Chains 簡化資料收集的更多資訊，請查看Data Centralization Paths 的其他內容！