Workiva 支援中心

Watershed 的企業氣候平台可讓您測量、報告和減少組織的碳足跡。

使用 Workiva 平台，您可以建立鏈，根據自定義Watershed 電子表格中指定的時間段，自動從 Watershed 下載碳足跡數據 - 例如用於在環境、社會和治理 (ESG) 或可持續發展報告中披露 - 到表格中。然後，您可以使用該表作為查詢或試算表連線的來源，例如將資料包含在報告輸出中。

備註： 當您在這些指示中建立多個鏈時，您只需執行一個鏈 - 然後自動執行其他鏈 - 從 Watershed 下載資料並更新試算表。

注意： 這些連鎖店使用的分水嶺 電子表格由 Workiva 提供。如果您沒有但有興趣，請聯絡您的客戶成功經理以取得詳細資訊。

必要條件

要建立這些鏈，您需要這些連接器：

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

提示： 所有鏈的命令都使用預設 CloudRunner。不需要 GroundRunner。

要成功運行鏈，還需識別

• 密鑰，供活動提供者 用於驗證分水嶺 API 並執行其動作
• 分水嶺 電子表格 、其控制表 部分及其連接表的 ID

建立記錄資料下載的鏈

開始時，建立連鎖以更新控制表 部分，以追蹤碳足跡資料上傳至 Workiva 的時間。

步驟 1. 建立鏈結

1. 從Chains ，點擊Create ，並選擇Create chain 。
   
2. 在Setup 中，輸入名稱3. 分水嶺 以及有助於識別該鏈記錄分水嶺資料上載的描述。
   
3. 按一下「儲存」(Save)。
   
   

步驟 2.以運行時輸入事件開始

1. 從連鎖事件 ，移動運行時間輸入 到開始 。
2. 選擇Runtime inputs 事件，然後按一下Edit 。
3. 在基本資訊 中，輸入名稱和描述以協助識別事件。
   
4. 在變數 中，使用這些顯示名稱新增 TextField 輸入：
   • 範圍
   • SpreadsheetID
   • SheetID

   提示： 這些變數的預設值留空；它們會在執行 1 時產生： 將這些變數的預設值留空，它們會在您執行1 時產生。稍後建立的分水嶺 連鎖。

5. 為所有三個變數選擇Required ，然後按一下Save 。
   
   

步驟 3.新增檔案公用程式建立檔案指令

若要為Control Sheet 區段建立記錄檔，請新增 File UtilitiesCreate file 指令：

1. 從可用連線 ，選擇檔案公用程式 ，並將建立檔案 移至畫布。
2. 從Runtime inputs 拖曳連結到Create file 。
3. 選擇Create file 指令，然後按Edit 。
4. 在基本資訊 中，輸入名稱和描述以協助識別命令。
   
5. 輸入命令的內容，然後按一下儲存 ：
   

   摘要資訊	值
   連接器	選擇要使用的檔案公用程式連接器。
   文字	輸入上次在 上刷新的足跡資料，並選擇System.DateTime 運行時間變數。

步驟 4.添加 Workiva Write Sheet Data 命令

若要使用記錄檔更新Control Sheet 區段，請新增 WorkivaWrite sheet data 指令：

1. 從可用的連接器 ，選擇Workiva ，並移動寫工作表資料 到畫布。
2. 從建立檔案 拖曳連結至寫入工作表資料 。
3. 選擇寫入工作表資料 指令，然後按一下編輯 。
4. 在Basic info 中，輸入名稱和說明，以協助識別命令。
5. 輸入命令的屬性，然後按儲存 ：
   
   

   摘要資訊	值
   連接器	選擇要使用的 Workiva 連接器。
   試算表 ID	選擇SpreadsheetID runtime input fromTrigger 。
   工作表 ID/名稱	從觸發 ，選擇工作表 ID runtime 輸入。
   資料檔案	選擇Create file 指令的Created file 輸出。
   分隔符號	輸入逗號 (,)。
   區域	從觸發器 中選擇Range runtime 輸入。

6. 單擊發佈 ，輸入關於其發佈的備註，然後單擊發佈 。

從載入資料到 Wdata 模板建立鏈

接下來，使用 Load Data to Wdata 模板 建立鏈，以從 Watershed 下載的資料更新Watershed 電子表格的連接表。Load Data to Wdata 模板創建的鏈共同工作，以確定資料集是否已存在於表中，並使用最新資料集更新表。

從Templates 建立鏈，開啟Load Data to Wdata | Primary chain 模版，然後按一下New chain 。

建立連鎖以從 Watershed 下載資料

最後，建立連鎖從 Watershed 下載和匯入碳足跡資料。

備註： 在此之前建立其他兩個鏈，為其運行鏈 事件。

步驟 1. 建立鏈結

1. 從Chains ，按一下Create ，並選擇Create chain 。
2. 在Setup 中，輸入名稱1. 分水嶺 ，以及有助於進一步識別鏈的描述。
   
3. 在變數 中，為分水嶺 API 金鑰和分水嶺電子表格及其控制工作表的 ID 添加變數。
   

   名稱	值
   APIKey	輸入分水嶺 API 金鑰。
   SpreadsheetID	輸入分水嶺試算表的 ID。
   SheetID	輸入控制工作表 分水嶺試算表部分的 ID。

4. 按一下「儲存」(Save)。
   
   

步驟 2.使用 Workiva Get Sheet Data 命令開始

使用 WorkivaGet sheet data 命令開始，根據分水嶺試算表Control sheet 中的時間段來識別要下載的資料：

1. 從可用連接器 ，選擇Workiva ，並將Get sheet data 移至Start.
2. 選擇Get sheet data 指令，然後按Edit 。
3. 在Basic info 中，輸入名稱和說明，以協助識別命令。
4. 輸入命令的屬性，然後按儲存 ：
   
   

   摘要資訊	值
   連接器	選擇要使用的 Workiva 連接器。
   試算表 ID	選擇試算表 ID 鍊變數。
   工作表 ID/名稱	選擇工作表 ID 鍊變數。
   區域	輸入A11: 。
   數值樣式	選擇「計算」。
   修訂	為確保最新版本，請輸入-1 。

步驟 3.新增指令為 Watershed 準備時間段

若要辨識分水嶺的時間段，請新增進階查詢 和CSV 至 JSON 指令：

1. 從可用連接器 ，選擇表格轉換 ，並將進階查詢 移至畫布。
2. 從取得工作表資料 拖曳連結到進階查詢 。
3. 選擇進階查詢 指令，然後按編輯 。
4. 在基本資訊 中，輸入名稱和描述以協助識別命令。
5. 輸入命令的屬性，然後按儲存 ：
   
   

   摘要資訊	值
   連接器	選取要使用的表格轉換連接器。
   表格	新增時段資料表： 在檔案 中，選擇Get sheet data 指令的Data 輸出。 在表名 中，輸入a 。
   查詢	輸入要執行的查詢 select case when `Start Month` = 'January' then '01' when `Start Month` = 'February' then '02' when `Start Month` = 'March' then '03' when `Start Month` = 'April' then '04' when `Start Month` = 'May' then '05' when `Start Month` = 'June'then '06' when `Start Month` = 'July' then '07' when `Start Month` = 'August' then '08' when `Start Month` = 'September' then '09' when `Start Month` = 'October' then '10' when `Start Month` = 'November' then '11' else '12' end as 'sm'、case 當 `End Month` = 'January「 則 」01「 當 `End Month` = 」February「 則 」02「 當 `End Month` = 」March「 則 」03「 當 `End Month` = 」April「 則 」04「 當 `End Month` = 」May「 則 」05「 當 `End Month` = 」June' 則'06「 當 `End Month` = 」July「 則 」07「 當 `End Month` = 」August「 則 」08「 當 `End Month` = 」September「 則 」09「 當 `End Month` = 」October「 則 」10「 當 `End Month` = 」November「 則 」11' else '12' end as 'em'、報表年份`為 'ry「，TableId 為 」tid' from a
   輸入分隔符	選擇逗號。
   輸出分隔符	選擇逗號。
   預覽結果	選擇此核取方塊。

6. 從可用連線 ，選擇JSON ，並將CSV 至 JSON 移至畫布。
7. 從進階查詢 拖曳連結到CSV 到 JSON 。
8. 選擇CSV 至 JSON 指令，然後按編輯 。
9. 在Basic info 中，輸入名稱和描述以協助識別命令。
   
10. 輸入命令的內容，然後按一下儲存 ：
    

    摘要資訊	值
    連接器	選擇要使用的 JSON 連接器。
    輸入檔	選擇結果 進階查詢 指令的輸出。
    分隔符號	選擇逗號 (, )。

步驟 4.新增 HTTP 請求 GET 指令

若要下載所選時間段的碳足跡資料，請新增 HTTP RequestGET 指令：

1. 從可用連線器 ，選擇HTTP Request ，並將GET 移至畫布。
2. 從CSV 拖曳連結到 JSON 到GET 。
3. 選擇GET 指令，然後按Edit 。
4. 在Basic info 中，輸入名稱和說明，以協助識別命令。
5. 輸入命令的屬性，然後按儲存 ：
   
   

   摘要資訊	值
   連接器	選擇要使用的 HTTP Request 連接器。
   顯示回應	選擇此核取方塊。
   URL|網址	輸入https://api.watershedclimate.com/v1/report/footprint_detail 。
   查詢字串	輸入查詢字串，指出要下載資料的開始和結束月份： 對於開始月份，輸入startMonth= ，並選擇CSV 至 JSON 指令輸出的JSON 檔 兩次。 然後，對於月底，輸入&endMonth= ，並再選擇兩次CSV to JSON 指令的JSON 檔 輸出。 對於兩個月，點選第一個JSON 檔案 輸出，並套用從 JSON 取得變數 變換 ： 在Output 中，選擇 Text。 在Value 中，輸入0 和ry 。 對於兩個月，點擊第二個JSON 檔案 輸出，並應用另一個從 JSON 取得變數 變換 ： 在Output 中，選擇 Text。 在Value 中 ，輸 入0 和sm 。
   頁首	添加標頭： 在Key 中，輸入Authorization 。 在Value 中，輸入Bearer ，然後選擇APIKey 連鎖變數。
   內容類型	輸入application/json 。

步驟 5.添加運行鏈事件以執行和記錄數據上載

要將資料上傳至 Wdata，並在控制表 區段中記錄上傳情況，請為先前建立的鏈新增Run chain 事件：

1. 從Chain events, 將Run chain移至 canvas。
2. 從GET 拖曳連結到Run chain 。
3. 選擇Run chain 事件，然後按Edit 。
4. 在Basic info 中，輸入名稱和描述，以協助識別事件將資料上載到 Wdata。
5. 在Chain to run 中，選擇Load Data to Wdata | Primary chain ，它是從Load Data to Wdata 範本中較早建立的。
   
6. 輸入鏈運行時間輸入，並點擊保存 ：

   輸入	值
   表格 ID	提供要上傳資料至的 Wdata 表的 ID： 選擇CSV to JSON 指令的JSON 檔 輸出。 點選JSON 檔案 輸出，並套用Get variable from JSON 變換： 在Output 中，選擇 Text。 在值 ，輸入0 和tid 。
   檔案前綴	根據資料的時間段，定義要上傳資料集的前綴： 對於起始月份，選擇CSV 至 JSON 指令的JSON 檔案 輸出兩次。 輸入下劃線 (_)。 對於月底，請再選擇兩次CSV 至 JSON 指令的JSON 檔案 輸出。 輸入.csv 。 對於兩個月，點選第一個JSON 檔 輸出，並套用Get variable from JSON 變換： 在Output 中，選擇 Text。 在Value 中，輸入0 和ry 。 點選兩個月的第二個JSON 檔案 輸出，並套用另一個從 JSON 取得變數 變換： 在Output 中，選擇 Text。 在Value 中，輸入0 和sm 。
   資料檔案	選擇GET 指令的回應 輸出。
   載入方法	選擇取代資料集。
   復原	選取此核取方塊。

7. 從Chain events ，移動另一個Run chain到畫布。
8. 從第一個Run Chain 拖曳連結到第二個。
9. 選擇第二個Run Chain 事件，然後按一下Edit 。
10. 在Basic info 中 ，輸 入 名 稱 和 描 述 以 協 助 識 別 該 事 件 在 分 水 層 電 子 報 表 中 記 錄 上 載 的 數 據 。
11. 在Chain 中執行 ，選擇3. 先前建立的分水嶺 鏈。
    
12. 輸入鏈運行時間輸入，然後按一下儲存 ：

    輸入	值
    範圍	輸入F12:F12.
    試算表 ID	選擇SpreadsheetID 鍊變數。
    工作表 ID	選擇SheetID 鍊變數。

13. 按一下發佈 ，輸入關於其發佈的任何備註，然後按一下發佈 。
    
    

執行鏈

使用最新的碳足跡數據刷新分水嶺 電子表格：

1. 從Control sheet section of theWatershed 試算表，選擇要從 Watershed 下載的資料的時間段 - 月和年。
   
2. 從 WdataChains ，選擇1. 分水嶺 鏈，並點擊執行 和運行鏈 。
   
   

   備註： 執行此鏈時，會自動執行其他兩個鏈，以更新 Wdata 表和Watershed 電子表格中的資料。