FromChain Builder, 您可以使用這些鏈模板,它們共同簡化了環境、社會和治理 (ESG) 或永續性數據的前移:
- 1a. ESG 向前滾動 | 主要 | 從這裡開始
- 1b. ESG 滾動 | 更新連接和狀態
- 1c. ESG 向前滾動 | 更新連接 | 執行
提示: 當您從這些範本建立三個鏈時,您只會執行建立的第一個鏈,它會自動執行所有鏈。
注意: 這些鏈只向前滾動資料收集試算表 -而非 a可持續發展計劃 。要瞭解如何在程式中向前滾動數值,請檢視在永續性方案中向前滾動並管理報告年份 。
當您執行根據這些範本建立的鏈時,它們會一起自動將上一年的資料集歸檔並匯入表格。當您執行鏈時,也可以選擇:
- 匯入資料集前,刷新來源 Spreadsheet 的連線,例如確保最新的值
- 清除來源 Spreadsheet 中的值(與來源或目的地鏈結的值除外),例如為下一年的資料收集做準備
備註: 這些資料鏈會自動取代連接的 Wdata 表中同一時期的任何資料集。如果匯入新資料集時發生錯誤,該表會還原為先前的資料集。
必要條件
從這些範本建立的鏈需要特定的連接器來執行其指令。
從這些範本建立鏈之前,請在 Chain Builder 中設定這些連接器:
注意: 這些範本鏈中使用的所有連接器都使用預設 CloudRunner。不需要 GroundRunners。
注意: 要執行其指令,HTTP Request connector 需要為 Workiva connector 的整合使用者建立的 OAuth grant 的client ID 和 secret。確保 OAuth 授權有適當的範圍。
步驟 1.設定 Workiva 檔案
根據這些範本建立的鏈需要針對永續性資料進行特定的 Workiva 檔案設定。在執行這些範本鏈之前,請設定 Workiva 檔案以收集和滾動資料:
- 在 Spreadsheets 中,確定用於永續發展報告的資料收集表。
- 在 Wdata 中,創建表 ,使用 Spreadsheet 作為連接的數據集 ,並記錄表的 ID ,以便執行鏈時使用。
- 在試算表中,添加工作表 ,以追蹤 Wdata 表的傳出連接的刷新狀態,並記錄工作表的名稱,以便執行鏈時使用。
- 建立查詢 ,以便在鏈存檔資料時執行:
- 使用連接至資料收集試算表的 Wdata 表作為資料來源 。
- 在查詢中,包括一個多重選擇參數 年,其資料類型與資料表的年 欄相同。
- 記錄查詢的 ID ,以便運行鏈時使用。
步驟 2.確定變數和運行時輸入的值
要使鏈與多個工作空間一起工作,它們使用變量來識別 Workiva 連接器的集成用戶和環境。在Chain Builder,建立這些工作區變數 :
| 變數 | 值 |
|---|---|
| wsv-ClientID | 為 Workiva 整合使用者建立的 OAuth2 授權的用戶端 ID |
| wsv-ClientSecret | 為整合使用者建立的 OAuth2 授權所產生的用戶端秘密 |
| wsv-BaseURL-Wdata | 根據環境的區域,Wdata 指令的 URL 主機基礎和基本路徑:
|
| wsv-BaseURL-IAM | 身份和存取管理命令的 URL 主機基址和基本路徑,以環境的區域為基礎:
|
| wsv-BaseURL-OC | 根據環境的區域,Chains 指令的 URL 主機基礎和基本路徑:
|
當您執行從1a.ESG roll forward | Primary | Start here 模板,它會提示運行時輸入,以識別要與之交互的 Workiva 檔案以及如何識別資料集:
| 運行時輸入 | 值 |
|---|---|
| 資料收集-向前滾動表 ID | Wdata 表的 ID - 連接到要將資料集匯入的資料收集試算表 |
| 資料收集-向前滾動查詢 ID | 執行 Wdata 查詢以將資料歸檔的 ID |
| PY年 | 要歸檔的資料年份 |
| 標記值 | 存檔資料集的名稱 注意: 鏈使用Tag value 輸入和PY year 輸入來建立資料集的檔案名稱,如 |
| 狀態-工作表名稱 | 工作表名稱,用於追蹤 Spreadsheet 與 Wdata 表的傳出連接的刷新狀態 |
步驟 3.建立鏈
要創建向前滾動數據收集所需的鏈,請使用1a. ESG roll forward | Primary | Start here template:
- 從Templates 在Chain Builder ,開啟1a. ESG roll forward | Primary | Start here 模板,然後點擊New chain 。
- 輸入名稱以協助識別鏈。
- 選擇使用鏈的環境,然後按一下下一步 。
- 對於dcv-clearSuccess 變數,輸入名稱
dvc-clearSuccess,然後按一下下一步 。 - 對於每個連線,選擇要使用的連線器,然後按一下下一連結 。
注意: 對於每個連接器,請使用預設 CloudRunner。
- 設定每個變數,然後按一下下一步 。
變數 變數類型 新增變數 wsv-ClientID 工作區 選擇 wsv-ClientID。 cv-TimeToCheck 鏈 cv-TimeToCheckwsv-ClientSecret 工作區 選擇 wsv-ClientSecret。 dcv-RefreshStatus 動態鏈 dcv-RefreshStatuswsv-BaseURL-IAM 工作區 選擇 wsv-BaseURL-IAM。 wsv-BaseURL-OC 工作區 選擇 wsv-BaseURL-OC。 - 針對每個連線,選擇要使用的連接器,然後按一下下一連結 。
注意: 對於每個連接器,請使用預設 CloudRunner。
- 設定每個變數,然後按一下下一步 。
變數 變數類型 新變數 dcv-srcStatus 動態鏈 dcv-srcStatuswsv-ClientID 工作區 選擇 wsv-ClientID。 dcv-destStatus 動態鏈 dcv-destStatuswsv-ClientSecret 工作區 選擇 wsv-ClientSecret。 wsv-BaseURL-Wdata 工作區 選擇 wsv-BaseURL-Wdata。 wsv-BaseURL-IAM 工作區 選擇 wsv-BaseURL-IAM。 - 對於每個連線,選擇要使用的連線器,然後按一下Submit 。
注意: 對於每個連接器,使用預設 CloudRunner。
步驟 4.發佈鏈
注意: 為了方便安裝,Refresh connections & status 模板有一個Run chain 事件。在您發佈從範本建立的鏈之前,請刪除這個不相干的Run chain 事件。
- 從Chains ,對於從Refresh connections & status 模板建立的鏈,選擇Edit 。
- 選擇執行鏈 - 刪除 事件,然後單擊刪除 和刪除 。
- 單擊Publish和Publish 。
- 從Chains ,對於從Primary 模板建立的鏈,選擇Edit 。
- 單擊Publish 和Publish 。
- 從Chains ,對於從Execution 模板建立的鏈,選擇Edit 。
- 單擊Publish 和Publish 。
執行鏈
存檔您的資料並為下一年的資料收集做準備:
- 在Chain Builder ,從Chains ,選擇為從1a.ESG roll forward | Primary | Start here 模板。
- 按一下用輸入執行, 並輸入執行時的輸入:
運行時間輸入 值 資料收集-向前滾動表 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 範本建立的連線名稱。 清除試算表值列 選擇是否從試算表中刪除輸入值作為向前滾動的一部分。 注意: 不會刪除具有來源或目的地連結的值。
- 若要在匯入資料集前確保最新值,請選擇在資料存檔前刷新連線 。
如果選擇此選項,鏈將刷新 Spreadsheet 的出站連接,並在控制工作表中追蹤其刷新狀態:- 在Status-SheetName 中,輸入來源 Spreadsheet 中的工作表名稱,鏈可在此儲存傳出連接的刷新狀態。
- 在RefreshExecution-ChainName 中,輸入從ESG Rollforward | Refresh connection | Execution 模板創建的鏈的名稱。
提示: 根據 Spreadsheet 的傳出連線數量,刷新可能需要幾分鐘。 要調整等待時間,請編輯從1b.ESG 向前滾動 | 更新連接和狀態 模板。
- 若要從來源 Spreadsheet 中刪除輸入值作為存檔的一部分,例如為下一年的資料收集做準備,請選擇Clear spreadsheet value column 。
注意: 鏈保留與來源或目的地連結的任何值。您無法復原任何從試算表中刪除的值。我們建議您僅在年度最後一次滾動時選擇此選項,以便為下一年度的資料收集準備試算表。
提示: 預設情況下,鏈會刪除 Spreadsheet 工作表第 2 行開始的值。若要調整,請編輯Clear sheet data 指令的Region 屬性。
- 按一下啟動 。