通过 Chain Builder，您可以创建一个链，将施耐德电气®的数据下载到 Workiva 中，例如您的温室气体 (GHG) 排放量，用于环境、社会和治理 (ESG) 或可持续发展报告。
先决条件
要构建这条链，您将使用以下核心连接器：
注： 所有连接器均使用 CloudRunner。此链条不需要地面运行器。
要下载排放数据，您还需要用于施耐德电气基本身份验证的用户名和密码。
步骤 1. 创建链条
- 从 链中，单击 创建，然后选择 创建链。
- 在 设置下，输入名称和描述以标识该链。
- 在 变量下，添加变量以指定要从施耐德电气下载的数据：
姓名 值 clientHierIds 输入贵公司客户层级结构的 ID，该 ID 已在 Resource Advisor 中为施耐德电气设置。 服务 ID 要仅下载特定来源的数据，请输入要下载排放数据的温室气体来源 ID。 从月份 请输入要下载数据的时间段的最早月份，格式为 yyyy-MM。到月 请输入要下载数据的时段内的最新月份，格式为 yyyy-MM。carbonMapType 从资源顾问中输入要使用的碳排放地图——一次碳排放或二次碳排放。如果留空，则该命令使用主碳图。 排放UOMId 请输入下载排放数据时要使用的首选计量单位。 发射URL 输入 施耐德电气 API 端点 的 URL 以请求数据。 - 点击 保存。
步骤 2. 从 HTTP 请求开始
要请求从施耐德电气下载数据，请以 HTTP POST 命令开始。
- 在 连接器下，选择 HTTP，并将 POST 移动到 开始。
- 选择 POST 命令，然后单击 编辑。
- 在 基本信息下，输入名称和描述以帮助识别命令。
- 在 命令属性下，选择要使用的 HTTP 请求连接器。
- 请输入命令属性：
摘要信息 描述 用户名 请输入用于施耐德电气基本身份验证的用户名。 密码 请输入用于施耐德电气基本身份验证的密码。 显示回复 勾选此框。 网址 在 Chain下选择 ] emissionsURL 变量。 内容类型 选择 application/json。 正文 请以 JavaScript 对象表示法 (JSON) 字符串的形式输入请求，并在 链 下选择适用的变量作为每个名称/值对的值： { "clientHierIds": [<clientHierId variable> ], "serviceIds": [<serviceIds variable> ], "fromMonth": "<fromMonth variable> ", "toMonth": "<toMonth variable> "", "carbonMapType": "<carbonMapType variable> "", "emissionsUOMId": "<emissionUOMId variable> “ }输出方案 输入施耐德电气提供的示例 JSON 响应： { "serviceOutput": [ { "divisionClientHierId": 0, "divisionName": "string", "siteClientHierId": 0, "siteName": "string", "dataSourceLevel": "string", "serviceId": 0, "serviceName": "string", "scope": "string", "usage": 0, "emission": 0, "emissionUOM": "string", "usageUOM": "string", "serviceMonth": "string" } ], "errorMessage": "string", "errorCode": "string" } - 点击 保存。
步骤 3. 将数组添加到 CSV 命令
要将施耐德电气的 JSON 响应转换为逗号分隔值 (CSV) 格式，请添加 Array to CSV 命令：
- 在 连接器下，选择 JSON，并将 数组到 CSV 移动到画布上。
- 将链接从 开始 拖到 数组到 CSV 命令。
- 选择 数组到 CSV 命令，然后单击 编辑。
- 在 基本信息下，输入名称和描述以帮助识别命令。
- 在 命令属性下，选择要使用的 JSON 连接器。
- 对于 JSON数据，请选择 POST 命令的 响应 输出。
- 在 列下，添加从施耐德电气下载的数据列：
列名称 JSONPath 使用情况 。用法 排放 排放 - 对于 分隔符，选择逗号。
- 点击 保存。
步骤 4. 添加创建文件命令
要从数据创建 CSV 文件，请添加 Create file 命令：
- 在 连接器下，选择 文件实用工具，并将 创建文件 移动到画布上。
- 将链接从 数组到 CSV 命令拖到 创建文件 命令。
- 选择 创建文件 命令，然后单击 编辑。
- 在 基本信息下，输入名称和描述以帮助识别命令。
- 在 命令属性下，选择要使用的文件实用工具连接器。
- 请输入命令属性：
摘要信息 描述 文本 选择 数组转 CSV [] 命令的 转换文件 输出。 文件路径 在 [ Runtime下选择 ] Chain.Workspace 变量，然后输入 \和带有.csv扩展名的文件名。 - 点击 保存。
步骤 5. 添加命令以在 Workiva 中使用数据
要在 Workiva 平台中使用 CSV 数据，请添加 Workiva 连接器命令，以使用 创建文件 命令的 创建文件 变量输出，并将其与电子表格或 Wdata 表一起使用。例如，要将施耐德电气数据作为数据集添加到 Wdata 表中，请添加一个 运行链 事件，该事件使用从 更新表中的数据集模板创建的链。
步骤 6. 发布并运行链
要使该链运行：
- 点击 发布。
- 输入有关其发布的任何评论，然后单击 发布。
运行该链：
- 从 链中，从链的菜单中选择 编辑 。
- 点击 链设置，输入变量值以指定要下载的数据，然后点击 保存。
- 单击 执行 和 运行链。