Workiva 支援中心

您是否已觀看Chains Foundations 網路研討會 ？想要以自己的步調跟進嗎？在本連結學習路徑中，我們將根據 Chain Foundations Webinar 的步驟，建立一個 Chain，從來源下載資料、上傳至 Wdata Table 並刷新連線。

步驟 1：建立鏈條

為了自動將源資料移動到我們的終端報表，我們首先需要建立一個 Chain，從頭到尾統籌整個流程。由於我們會一直使用相同的 Spreadsheet 和 Table，因此我們會設定 Chain 變數來儲存這些詳細資料，以便進行一致的存取。

1. 建立新的Chain ，並命名 Chain：CLP | Chains Foundations 。

2. 在Chain Variables 下，按兩次加號來建立兩個 Chain Variables，並如下所述進行設定：

   變數 1：

   • 類型： 鏈式可變 (cv)
   • 名稱： cv-Spreadsheet ID
   • 值：在Wdata Foundations CLP 中建立的 CLP Company Spend by Department Spreadsheet 的 ID。
   • 尋找試算表 ID：
     1. 導覽至 CLP Company Spend by Department Spreadsheet。
     2. 在 URL 中選擇電子表格 ID，該 ID 位於「「spreadsheet/」之後和「/sheet」之前。 
        例如，試算表 ID 在此以粗體顯示： app.wdesk.com/a/QWNjb3VudB8yMDkwNzExMDQ0/spreadsheet/6c4a23966c3c4a10a3178ae5791db7fd/-1/sheet/3161ee0402ec4b9fa4e937e6f0f63b13

   變數 2：

   • 類型： 鏈式可變 (cv)
   • 名稱: cv-Table ID
   • 值： 輸入中電公司支出表的 ID。
   • 若要尋找資料表 ID：
     1. 導覽到 CLP Company Spend Table。
     2. 在 URL 中，選擇表 ID，該 ID 位於 "table/" 之後。 
        例如，表 ID 在此以粗體顯示： app.wdesk.com/s/wdata/a/QWNjb3VudB8yMDkwNzExMDQ0/tables/16aba1634ead43a29df8f839422582f0
3. 保存 鏈條。

步驟 2：下載檔案

HTTP Request Get 指令將用於下載要上傳到表格的檔案。我們在線上提供檔案供 Chain 下載，以示範從雲端下載檔案。為了讓這個流程動態化，我們會在 URL 中加入目前的期間，這與我們所處的月份對應，並確保我們拉取的是目前的資料集。

1. 從HTTP Request 連接器新增Get 指令到起始區域。
2. 按兩下指令進行設定。
   1. 在URL 欄位中填入以下內容，使用變數產生目前月份，與期間對應：
      https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/Webinars/ERP-P <System.DateTime>.csv 。
   2. 以系統日期和時間的運行時間變數取代 <System.DateTime>。
   3. 在選擇變數面板中，按一下向下箭頭以展開執行階段。
   4. Select System.DateTime
   5. 按一下System.DateTime 變數進行轉換。使用下列值：
      1. 選擇轉換： ，選擇解析日期/時間。
      2. 按一下+ 按鈕 。
      3. Format（格式）下拉選項： ，選擇 ISO Extended（平台標準）。
      4. 輸出日期格式： ，選擇 %m。
         此輸出表示我們只會獲得系統日期和時間中的兩位數字月份。
         在此瞭解更多關於常見日期和時間轉換的資訊。
      5. 在輸入日期時區 欄位和輸出日期時區 欄位中，選擇您目前的時區。
      6. 按一下「接受」(Accept)。
         
3. 更新內容類型欄位為：application/csv。
4. 儲存指令。

步驟 3：建立檔案

將檔案上傳至 Wdata 資料表需要兩個步驟。檔案首先需要在Staged 狀態下建立，才能匯入供最終使用。我們將使用 Create File 指令在 Wdata 表中以 Staged 狀態建立檔案，表示檔案已建立，但尚未匯入為資料集。

1. 從Workiva Connector 新增Create File 指令到 Chain canvas。
2. 將Get 指令連接到Create File 指令。
3. 按兩下指令進行設定。
   1. 按一下Table ID 欄位。
      1. 在左側Select a Variable 面板中，按一下向下箭頭以展開Chain 。
      2. 選取「cv-Table ID」。
   2. 按一下「檔案」欄位。
      1. 在左側Select a Variable 面板中，按一下向下箭頭以展開GET 。
      2. 選取「回應」。
   3. 使用下列資訊填入Name 欄位，遵循之前在名稱欄位中填入週期的相同步驟：
      ERPSpendData<System.DateTime>.csv
   4. 以系統日期和時間的運行時間變數取代 <System.DateTime>。
      1. 在左側Select a Variable 面板中，按一下向下箭頭以展開Runtime 。
      2. Select System.DateTime
      3. 按一下System.DateTime 變數進行轉換。
         1. 對於選擇轉換 ，選擇解析日期/時間 。
         2. 按一下 + 按鈕。
         3. 對於格式 ，請選擇ISO Extended (Platform Standard) 。
         4. 對於輸出日期格式 ，選擇%m-%d-%Y@T%H:%M 。
            此輸出表示我們只會獲得 Chain 執行的完整日期和時間。
            在此瞭解更多關於常見日期和時間轉換的資訊。
         5. 在輸入日期時區 欄位和輸出日期時區 欄位中，選擇您目前的時區。
         6. 按一下ACCEPT 。
            
4. 按一下「儲存」 儲存指令。

步驟 4：匯入檔案至表格

將檔案上傳至 Wdata 表的第二步驟是匯入資料，使其可用於查詢。此步驟擷取暫存檔案，並將其作為資料集匯入指定的資料表。

1. 從 Workiva 連接器新增「將檔案匯入表格」指令到鏈結畫布。
2. 將建立檔案指令連接到將檔案匯入表格指令。
3. 按兩下指令進行設定。
4. 按一下Table ID 欄位。
   1. 在左側Select a Variable 面板中，按一下向下箭頭以展開Chain 。
   2. 選取「cv-Table ID」。
5. 按一下File ID 欄位。
   1. 在左側Select a Variable 面板中，按一下向下箭頭以展開Create File 。
   2. 按一下向下箭頭以展開「結果」。
   3. 選擇 Id。
6. 儲存指令。

步驟 5：列出連線

我們將使用 List Connections 指令擷取與試算表 ID 相關聯的 Connection ID 清單。List Connections 指令的輸出將會是一個 JSON 檔案，包含 Spreadsheet 中的每個連線，以及與連線相關的詳細資訊，包括連線 ID。

1. 從Workiva Connector 新增List Connections 指令到 Chain canvas。
2. 將「將檔案匯入表格」指令連接到「列出連線」指令。
3. 按兩下指令進行設定。
   • 目的地類型：試算表
   • 目的地 ID：使用試算表 ID 連鎖變數
     1. 按一下目的地 ID 欄位。
     2. 在左側變數面板中，展開Chain 下拉選項。
     3. 選擇試算表 ID 變數。
4. 儲存指令。

步驟 6：指令群組

我們將使用命令群組來啟用每個 Connection 的迭代。Group Iterator 會將 Spreadsheet 上的每個 Connection 逐一推進以下步驟。

1. 在 Chain 畫布上新增Command Group 。
2. 將List Connections 指令連接到In 指令群組的部分。
3. 按兩下指令進行設定。
   1. 命名小組：連線迭代
   2. 導覽到Iterators 索引標籤。
   3. 啟用Iterations 切換，然後按一下Iterations 欄位。
      1. 在Select a Variable 面板中，按一下向下箭頭以展開List Connections 。
      2. 選擇連線 輸出。
4. 儲存指令群組。

步驟 7：更新連線

我們將使用 Refresh Connection 指令，使用迭代中的 Connection ID 來刷新我們的 Connections。

1. 從Workiva Connector 新增Refresh Connection 指令到 Chain canvas。
2. 將Start 部分從群組迭代器連接到Refresh Connection 指令。
3. 按兩下指令來設定它。
   • 對於連線 ID： 使用群組迭代器 - 連線迭代器中的連線 ID。這可讓我們將當前迭代的 ID 推送至「重新整理連線」指令
     1. 按一下Connection ID 欄位。
     2. 在左側面板中，展開Group Iterator 下拉式選單。
     3. 展開 Connections Iteration 下拉式選單。
     4. 選擇ConnectionId 變數。
   • 勾選「使用之前的來源參數」核取方塊。

步驟 8：測試練習

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

1. 發表鏈結。
2. 按一下Execute ，然後按Run Chain 。
3. 一旦 Chain 完成，導航回到 Table，看到資料已載入，導航到 Spreadsheet，看到連線已成功刷新。

成功運行鏈結

資料已加入表格

刷新連接