Workiva 支援中心

FromChain Builder, 您可以使用這些鏈模板，它們共同簡化了環境、社會和治理 (ESG) 或永續性數據的前移：

• 1a. ESG 向前滾動 | 主要 | 從這裡開始
• 1b. ESG 滾動 | 更新連接和狀態
• 1c. ESG 向前滾動 | 更新連接 | 執行

提示： 當您從這些範本建立三個鏈時，您只會執行建立的第一個鏈，它會自動執行所有鏈。

注意： 這些鏈只向前滾動資料收集試算表 -而非 a可持續發展計劃 。要瞭解如何在程式中向前滾動數值，請檢視在永續性方案中向前滾動並管理報告年份 。

當您執行根據這些範本建立的鏈時，它們會一起自動將上一年的資料集歸檔並匯入表格。當您執行鏈時，也可以選擇：

• 匯入資料集前，刷新來源 Spreadsheet 的連線，例如確保最新的值
• 清除來源 Spreadsheet 中的值（與來源或目的地鏈結的值除外），例如為下一年的資料收集做準備

備註： 這些資料鏈會自動取代連接的 Wdata 表中同一時期的任何資料集。如果匯入新資料集時發生錯誤，該表會還原為先前的資料集。

必要條件

從這些範本建立的鏈需要特定的連接器來執行其指令。

從這些範本建立鏈之前，請在 Chain Builder 中設定這些連接器：

• Workiva 連結器
• Workiva Chains 連接器
• 表格轉換 連接器
• JSON 連接器
• 手把 連接器
• 檔案公用程式 連接器
• HTTP 請求 連接器

注意： 這些範本鏈中使用的所有連接器都使用預設 CloudRunner。不需要 GroundRunners。

注意： 要執行其指令，HTTP Request connector 需要為 Workiva connector 的整合使用者建立的 OAuth grant 的client ID 和 secret。確保 OAuth 授權有適當的範圍。

步驟 1.設定 Workiva 檔案

根據這些範本建立的鏈需要針對永續性資料進行特定的 Workiva 檔案設定。在執行這些範本鏈之前，請設定 Workiva 檔案以收集和滾動資料：

1. 在 Spreadsheets 中，確定用於永續發展報告的資料收集表。
2. 在 Wdata 中，創建表 ，使用 Spreadsheet 作為連接的數據集 ，並記錄表的 ID ，以便執行鏈時使用。
3. 在試算表中，添加工作表 ，以追蹤 Wdata 表的傳出連接的刷新狀態，並記錄工作表的名稱，以便執行鏈時使用。 
4. 建立查詢 ，以便在鏈存檔資料時執行：
   • 使用連接至資料收集試算表的 Wdata 表作為資料來源 。
   • 在查詢中，包括一個多重選擇參數 年，其資料類型與資料表的年 欄相同。
   • 記錄查詢的 ID ，以便運行鏈時使用。

步驟 2.確定變數和運行時輸入的值

要使鏈與多個工作空間一起工作，它們使用變量來識別 Workiva 連接器的集成用戶和環境。在Chain Builder,建立這些工作區變數 ：

當您執行從1a.ESG roll forward | Primary | Start here 模板，它會提示運行時輸入，以識別要與之交互的 Workiva 檔案以及如何識別資料集：

步驟 3.建立鏈

要創建向前滾動數據收集所需的鏈，請使用1a. ESG roll forward | Primary | Start here template：

1. 從Templates 在Chain Builder ，開啟1a. ESG roll forward | Primary | Start here 模板，然後點擊New chain 。
2. 輸入名稱以協助識別鏈。
   
3. 選擇使用鏈的環境，然後按一下下一步 。
4. 對於dcv-clearSuccess 變數，輸入名稱dvc-clearSuccess ，然後按一下下一步 。
   
5. 對於每個連線，選擇要使用的連線器，然後按一下下一連結 。

   注意： 對於每個連接器，請使用預設 CloudRunner。

   
6. 設定每個變數，然後按一下下一步 。
   
   

   變數	變數類型	新增變數
   wsv-ClientID	工作區	選擇 wsv-ClientID。
   cv-TimeToCheck	鏈	cv-TimeToCheck
   wsv-ClientSecret	工作區	選擇 wsv-ClientSecret。
   dcv-RefreshStatus	動態鏈	dcv-RefreshStatus
   wsv-BaseURL-IAM	工作區	選擇 wsv-BaseURL-IAM。
   wsv-BaseURL-OC	工作區	選擇 wsv-BaseURL-OC。

7. 針對每個連線，選擇要使用的連接器，然後按一下下一連結 。

   注意： 對於每個連接器，請使用預設 CloudRunner。

8. 設定每個變數，然後按一下下一步 。
   

   變數	變數類型	新變數
   dcv-srcStatus	動態鏈	dcv-srcStatus
   wsv-ClientID	工作區	選擇 wsv-ClientID。
   dcv-destStatus	動態鏈	dcv-destStatus
   wsv-ClientSecret	工作區	選擇 wsv-ClientSecret。
   wsv-BaseURL-Wdata	工作區	選擇 wsv-BaseURL-Wdata。
   wsv-BaseURL-IAM	工作區	選擇 wsv-BaseURL-IAM。

9. 對於每個連線，選擇要使用的連線器，然後按一下Submit 。

   注意： 對於每個連接器，使用預設 CloudRunner。

步驟 4.發佈鏈

注意： 為了方便安裝，Refresh connections & status 模板有一個Run chain 事件。在您發佈從範本建立的鏈之前，請刪除這個不相干的Run chain 事件。

1. 從Chains ，對於從Refresh connections & status 模板建立的鏈，選擇Edit 。
   
2. 選擇執行鏈 - 刪除 事件，然後單擊刪除 和刪除 。
   
3. 單擊Publish和Publish 。
4. 從Chains ，對於從Primary 模板建立的鏈，選擇Edit 。
5. 單擊Publish 和Publish 。
6. 從Chains ，對於從Execution 模板建立的鏈，選擇Edit 。
7. 單擊Publish 和Publish 。

執行鏈

存檔您的資料並為下一年的資料收集做準備：

1. 在Chain Builder ，從Chains ，選擇為從1a.ESG roll forward | Primary | Start here 模板。
   
2. 按一下用輸入執行, 並輸入執行時的輸入：
   
   

   運行時間輸入	值
   資料收集-向前滾動表 ID	輸入要匯入資料集的 Wdata 表 ID。
   資料收集-向前滾動查詢 ID	輸入要執行查詢以歸檔資料的 ID。
   PY年份	輸入要歸檔資料的年份。
   標記值	輸入歸檔資料集的名稱。 註： 使用PY 年份 輸入，此輸入會建立資料集的檔案名稱為[標籤值]_[PY 年份].csv 。例如，PY year of 2021 和Tag value of Archived 會產生檔案名Archived_2021.csv 。
   在資料存檔前刷新工作表連接	選擇是否在執行前移查詢前，刷新 Spreadsheet 與 Wdata 表的傳出連接，例如在歸檔前更新資料集。
   狀態-工作表名稱	輸入追蹤從 Spreadsheet 到 Wdata 表的傳出連接的刷新狀態的工作表名稱。
   RefreshExecution—ChainName	輸入從ESG Rollforward | Refresh connection | Execution 範本建立的連線名稱。
   清除試算表值列	選擇是否從試算表中刪除輸入值作為向前滾動的一部分。 注意： 不會刪除具有來源或目的地連結的值。

3. 若要在匯入資料集前確保最新值，請選擇在資料存檔前刷新連線 。
   
   如果選擇此選項，鏈將刷新 Spreadsheet 的出站連接，並在控制工作表中追蹤其刷新狀態：
   • 在Status-SheetName 中，輸入來源 Spreadsheet 中的工作表名稱，鏈可在此儲存傳出連接的刷新狀態。
   • 在RefreshExecution-ChainName 中，輸入從ESG Rollforward | Refresh connection | Execution 模板創建的鏈的名稱。

   提示： 根據 Spreadsheet 的傳出連線數量，刷新可能需要幾分鐘。 要調整等待時間，請編輯從1b.ESG 向前滾動 | 更新連接和狀態 模板。

4. 若要從來源 Spreadsheet 中刪除輸入值作為存檔的一部分，例如為下一年的資料收集做準備，請選擇Clear spreadsheet value column 。
   
   

   注意： 鏈保留與來源或目的地連結的任何值。您無法復原任何從試算表中刪除的值。我們建議您僅在年度最後一次滾動時選擇此選項，以便為下一年度的資料收集準備試算表。

   提示： 預設情況下，鏈會刪除 Spreadsheet 工作表第 2 行開始的值。若要調整，請編輯Clear sheet data 指令的Region 屬性。

5. 按一下啟動 。