從Chain Builder ，您可以建立一個鏈，從 Schneider Electric® 下載資料至 Workiva，例如您的溫室氣體 (GHG) 排放量，用於環境、社會與治理 (ESG) 或永續性報告。
必要條件
要建立此鏈，您將使用這些核心連接器：
註： 所有連接器均使用 CloudRunner。此連結不需要 GroundRunner。
要下載排放數據，您還需要在施耐德電氣進行基本認證時使用的用戶名和密碼。
步驟 1. 建立鏈結
- 從Chains ，按一下Create ，並選擇Create chain 。
- 在設定 下 ，輸入名稱和描述以識別鏈。
- 在變數 下 ，新增變數以指定要從 Schneider Electric 下載的資料：
名稱 值 clientHierIds 輸入在 Resource Advisor 中為 Schneider Electric 設定的貴公司客戶層級的 ID。 serviceIds 若要僅下載特定排放源的數據，請輸入下載排放數據的溫室氣體源 ID。 fromMonth 輸入要下載資料時段的最早月份，格式為 yyyy-MM。toMonth 輸入要下載資料的最後月份，格式為 yyyy-MM。碳圖類型 輸入 Resource Advisor 中要使用的碳地圖 - Primary 或 Secondary。如果留空，則命令使用 Primary carbon map。 emissionUOMId 輸入下載排放資料時使用的首選測量單位。 emissionURL 輸入施耐德電氣 API 端點 的 URL 來請求資料。 - 按一下「儲存」(Save)。
步驟 2.以 HTTP 請求開始
若要請求從施耐德電機下載資料，請以HTTP POST 指令開始。
- 在Connectors 下 ，選擇HTTP ，並移動POST 到Start 。
- 選擇POST 指令，然後按Edit 。
- 在Basic info 下，輸入名稱和描述以協助識別命令。
- 在Command properties 下 ，選擇要使用的 HTTP Request 連接器。
- 輸入命令的內容：
摘要資訊 說明 使用者名稱 輸入用於與 Schneider Electric 進行基本驗證的使用者名稱。 密碼 輸入用於施耐德電機基本驗證的密碼。 顯示回應 勾選此方塊。 URL|網址 選擇Chain 下的emissionsURL 變量。 內容類型 選擇 application/json。 本文 以 JavaScript Object Notation (JSON) 字串形式輸入請求，在Chain 下選擇適用的變數，作為每個名稱/值對的值： { "clientHierIds"：[<clientHierId>], "serviceIds"：[<serviceIds>], "fromMonth"："<fromMonth>", "toMonth"："<toMonth>", "carbonMapType"："<carbonMapType>", "emissionsUOMId"："<emissionUOMId>"}輸出模式 輸入施耐德電機的 JSON 樣本回應： { "serviceOutput"：[ { "divisionClientHierId"：0, "divisionName"："string", "siteClientHierId"：0, "siteName"："string", "dataSourceLevel"："string", "serviceId"：0, "serviceName": "string", "scope": "string"string", "scope"："string", "usage"：0, "emission"：0, "emissionUOM"："string", "usageUOM"："string", "serviceMonth"："string" }], "errorMessage"："string", "errorCode"："string" } - 按一下「儲存」(Save)。
步驟 3.新增陣列至 CSV 指令
若要將施耐德電機的 JSON 回應轉換為逗號分隔值 (CSV) 格式，請新增Array to CSV 指令：
- 在Connectors 下 ，選擇JSON ，並將Array to CSV 移至畫布。
- 從Start 拖曳連結到Array to CSV 指令。
- 選擇Array to CSV 指令，然後按Edit 。
- 在Basic info 下，輸入名稱和說明，以協助識別命令。
- 在Command properties 下，選擇要使用的 JSON 連接器。
- 對於JSON 資料 ，請選擇POST 指令的回應 輸出。
- 在Columns 下 ，為從 Schneider Electric 下載的資料新增欄位：
資料欄名稱 JSONPath 使用方式 .usage 排放量 .emissions - 對於Delimiter ，請選擇逗號。
- 按一下「儲存」(Save)。
步驟 4. 新增「建立檔案」(Create File) 命令
若要從資料建立 CSV 檔案，請新增Create file 指令：
- 在Connectors 下 ，選擇File Utilities ，並將Create file 移至畫布。
- 從Array to CSV 指令拖曳連結至Create file 指令。
- 選擇Create file 指令，然後按Edit 。
- 在Basic info 下，輸入名稱和說明，以協助識別命令。
- 在Command properties 下 ，選擇要使用的 File Utilities 連接器。
- 輸入命令的屬性：
摘要資訊 說明 文字 選擇Array to CSV 指令的轉換檔案 輸出。 檔案路徑 選擇Runtime 下的Chain.Workspace 變數，並輸入 \和副檔名為.csv的檔案名稱。 - 按一下「儲存」(Save)。
步驟 5.新增指令以使用 Workiva 中的資料
若要在 Workiva 平台中使用 CSV 資料，請新增Workiva 連結器指令，以使用Create file 指令與試算表或 Wdata 表的Created file 變數輸出。例如，要在 Wdata 表中添加施耐德電氣數據作為數據集，請添加Run chain 事件，該事件使用從 Update datasets in a table 模板 創建的鏈。
步驟 6.發佈並執行鏈
要啟用鏈執行：
- 按一下發佈 。
- 輸入任何有關其出版的評論，然後按一下Publish.
執行鏈結：
- 從Chains ，從 Chain 的功能表中選擇Edit 。
- 按一下Chain Settings ，輸入變數值以指定要下載的資料，然後按一下Save 。
- 按一下執行 和執行鏈 。