從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 。
- 按一下執行 和執行鏈 。