Watershed的企业气候平台使您能够衡量、报告和减少您组织的碳足迹。
借助 Workiva 平台,您可以构建链,根据自定义 [] Watershed [] 电子表格中指定的时间段,自动从 Watershed 下载 碳足迹数据(例如用于环境、社会和治理 (ESG) 或可持续发展 报告的披露)到表格中。然后,您可以将该表用作查询或电子表格连接的数据源,例如将数据包含在报表输出中。
注意: 虽然这些说明中您需要构建多个链,但您只需运行其中一个链(该链会自动运行其他链)即可从 Watershed 下载数据并更新电子表格。
注: 这些链使用的 Watershed 电子表格由 Workiva 提供。如果您还没有这项服务但感兴趣,请联系您的客户成功经理了解详情。
先决条件
要构建这些链条,您需要以下连接器:
提示: 所有链的命令都使用默认的CloudRunner。不需要地面巡逻员。
为了成功运行这些链,还需要确定:
- 活动提供者 用于向 Watershed API 进行身份验证和执行操作的密钥
- 流域 电子表格、 其 控制表部分及其关联表的 ID
构建一个用于记录数据下载的链
首先,建立一个链来更新 控制表 部分,以跟踪碳足迹数据何时上传到 Workiva。
步骤 1. 创建链条
- 从 链中,单击 创建,然后选择 创建链。
- 在 设置中,输入
3 的名称。流域和描述,以帮助识别链式日志流域数据上传。 - 点击 保存。
步骤 2. 从运行时输入事件开始
- 从 链事件中,将 运行时输入 移动到 开始。
- 选择 运行时输入 事件,然后单击 编辑。
- 在 基本信息中,输入名称和描述,以帮助识别事件。
- 在 变量中,添加具有以下显示名称的 TextField 输入框:
范围表格ID工作表ID
提示: 将这些变量的默认值留空;它们将在运行 1. 分水岭链是后来形成的
。 - 为所有三个变量选择 必填 ,然后单击 保存。
步骤 3. 添加文件实用程序“创建文件”命令
要为 “控制表 ”部分创建日志文件,请添加“文件实用程序 ”中的“创建文件 ”命令:
- 从 可用连接器中,选择 文件实用工具,并将 创建文件 移动到画布上。
- 将链接从 运行时输入 拖到 创建文件。
- 选择 创建文件 命令,然后单击 编辑。
- 在 基本信息中,输入名称和描述以帮助识别命令。
- 输入命令属性,然后单击 保存:
摘要信息 值 连接线 选择要使用的文件实用工具连接器。 文本 输入 上次刷新足迹数据的时间,并选择 System.DateTime 运行时变量。
步骤 4. 添加 Workiva 写入工作表数据命令
要使用日志文件更新 控制表 部分,请添加 Workiva 写入表数据 命令:
- 从 可用连接器中选择 Workiva,并将 写入工作表数据 移动到画布上。
- 将链接从 创建文件 拖到 写入工作表数据。
- 选择 写入工作表数据 命令,然后单击 编辑。
- 在 基本信息中,输入名称和描述以帮助识别命令。
- 输入命令属性,然后单击 保存:
摘要信息 值 连接线 选择要使用的 Workiva 连接器。 电子表格ID 从 触发器 [中选择 [ SpreadsheetID [] 运行时输入。 图纸编号/名称 从 触发器[中选择 [] SheetID 运行时输入。 数据文件 选择 创建文件命令 的输出结果。 分隔符号 输入逗号( ,)。地区 从 触发器 [] 中选择 范围] 运行时输入。 - 点击 发布,输入有关其发布的说明,然后点击 发布。
从“加载数据到 Wdata”模板构建链
接下来,使用 将数据加载到 Wdata 模板 构建链,以使用从 Watershed 下载的数据更新 Watershed 电子表格的连接表。 Load Data to Wdata 模板创建一系列链,这些链协同工作,以确定数据集是否已存在于表中,并使用最新数据集更新表。
要从 模板创建链,请打开 加载数据到 Wdata | 主链 模板,然后单击 新建链。
构建一个从 Watershed 下载数据的链
最后,建立一条从 Watershed 下载和导入碳足迹数据的链。
注: 在此链之前创建其他两个链,以便运行其 链 事件。
步骤 1. 创建链条
- 从 链中,单击 创建,然后选择 创建链。
- 在 设置中,输入名称
1。分水岭和描述,以帮助进一步识别该链条。 - 在 变量中,添加流域 API 密钥以及流域电子表格及其控制表的 ID 的变量。
姓名 值 API密钥 输入流域API密钥。 电子表格ID 输入流域电子表格的 ID。 工作表ID 输入流域电子表格中 控制表 部分的 ID。 - 点击 保存。
步骤 2. 首先使用 Workiva 的“获取工作表数据”命令
首先使用 Workiva 获取工作表数据 命令,根据流域电子表格 控制工作表中的时间段来确定要下载的数据:
- 从 可用连接器中,选择 Workiva,并将 获取工作表数据移动到 开始。
- 选择 获取工作表数据命令,然后单击 编辑。
- 在 基本信息中,输入名称和描述以帮助识别命令。
- 输入命令属性,然后单击 保存:
摘要信息 值 连接线 选择要使用的 Workiva 连接器。 电子表格ID 选择 电子表格 ID 链变量。 图纸编号/名称 选择 工作表 ID 链变量。 地区 输入 A11:。价值风格 选择“计算”。 修订 为确保使用最新版本,请输入 -1。
步骤 3. 添加命令以准备流域时间段
要确定流域时间段,请添加 高级查询 和 CSV 转 JSON 命令:
- 从 可用连接器中选择 表格转换,并将 高级查询 移动到画布上。
- 将链接从 获取工作表数据拖到 高级查询。
- 选择 高级查询 命令,然后单击 编辑。
- 在 基本信息中,输入名称和描述以帮助识别命令。
- 输入命令属性,然后单击 保存:
摘要信息 值 连接线 选择要使用的表格转换连接器。 表格 添加时间段数据表: - 在 文件中,选择 获取工作表数据 命令的 数据 输出。
- 在 表名中,输入
一个。
查询 输入要运行的查询: 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 when `End Month` = 'January' then '01' when `End Month` =如果 `End Month` 为 'March',则 `February` 为 '02';如果 `End Month` 为 'April',则 `February` 为 '03';如果 `End Month` 为 'May',则 `February` 为 '04';如果 `End Month` 为 'June',则 `February` 为 '05';如果 `End Month` 为 'June',则 `February` 为 '06';如果 `End Month` 为 'July',则 `February` 为 '07';如果 `End Month` 为 'August',则 `February` 为 '08';如果 `End Month` 为 'September',则 `February` 为 '09';如果 `End Month` 为 'October',则 `February` 为 '10';如果 `End Month` 为 'November',则 `February` 为 '11';否则 `February` 为 '12'。`Reporting Year` 为 'ry';TableId 为 'tid'。数据来自
。输入分隔符 选择逗号。 输出分隔符 选择逗号。 预览结果 选中此复选框。 - 从 可用连接器中选择 JSON,并将 CSV 到 JSON 移动到画布上。
- 将链接从 高级查询 拖到 CSV 转 JSON。
- 选择 CSV 转 JSON 命令,然后单击 编辑。
- 在 基本信息中,输入名称和描述以帮助识别命令。
- 输入命令属性,然后单击 保存:
摘要信息 值 连接线 选择要使用的JSON连接器。 输入文件 选择 高级查询 命令的 结果 [] 输出。 分隔符号 选择逗号(,)。
步骤 4. 添加 HTTP 请求 GET 命令
要下载所选时间段的碳足迹数据,请添加 HTTP 请求 GET 命令:
- 从 可用连接器中,选择 HTTP 请求,并将 GET 移动到画布上。
- 将链接从 CSV 拖到 JSON 到 GET。
- 选择 GET 命令,然后单击 编辑。
- 在 基本信息中,输入名称和描述以帮助识别命令。
- 输入命令属性,然后单击 保存:
摘要信息 值 连接线 选择要使用的HTTP请求连接器。 显示回复 选中此复选框。 网址 输入 https://api.watershedclimate.com/v1/report/footprint_detail。查询字符串 请输入查询字符串,以指定要下载数据的起始月份和结束月份: - 对于起始月份,输入
startMonth=,并选择 JSON 文件 输出 CSV 转 JSON 命令两次。 - 然后,对于最后一个月份,输入
&endMonth=,并选择 JSON 文件 输出的 CSV 转 JSON 命令再两次。 - 对于这两个月,单击第一个 JSON 文件 输出,并 应用 从 JSON 获取变量 转换:
- 在 输出中,选择文本。
- 在 值中,输入
0和ry。
- 对于这两个月,单击第二个 JSON 文件 输出,并 应用另一个 从 JSON [] 获取变量 转换:
- 在 输出中,选择文本。
- 在 值中,输入
0和sm。
页首 添加标题: - 在 密钥中,输入
授权。 - 在 值中,输入
Bearer,然后选择 APIKey 链变量。
内容类型 输入 application/json。 - 对于起始月份,输入
步骤 5. 添加运行链事件以执行并记录数据上传
要将数据上传到 Wdata 并在 控制表 部分记录上传操作,请为先前创建的链添加 运行链 事件:
- 从 链事件中,将 运行链 移动到画布上。
- 将链接从 GET 拖到 Run 链。
- 选择 运行链 事件,然后单击 编辑。
- 在 基本信息中,输入名称和描述,以帮助识别该事件将数据上传到 Wdata。
- 在 运行链中,选择 加载数据到 Wdata | 主链 ,该主链 [] 之前已从 加载数据到 Wdata 模板创建。
- 输入链运行时参数,然后点击 保存:
输入 值 表格 ID 提供要上传数据的 Wdata 表的 ID: - 选择 CSV 转 JSON 命令的输出 JSON 文件 。
- 单击 JSON 文件 输出,并应用 从 JSON 获取变量 转换:
- 在 输出中,选择文本。
- 在 值中,输入
0和tid。
文件前缀 根据数据的时间段,定义要上传的数据集的前缀: - 对于起始月份,选择 JSON 文件 输出的 CSV 转 JSON 命令两次。
- 输入下划线(
_)。 - 对于月底,请再选择 CSV 转 JSON [] 命令的输出 JSON 文件 两次。
- 输入
.csv. - 对于这两个月,单击第一个 JSON 文件 输出,并应用 从 JSON 获取变量 转换:
- 在 输出中,选择文本。
- 在 值中,输入
0和ry。
- 对于这两个月,单击第二个 JSON 文件 输出,并应用另一个 从 JSON 获取变量 转换:
- 在 输出中,选择文本。
- 在 值中,输入
0和sm。
数据文件 选择 GET [] 命令的 响应 输出。 加载方法 选择“替换数据集”。 回滚 选中此复选框。 - 从 链事件中,将另一个 运行链 移动到画布上。
- 将链接从第一个 运行链 拖到第二个 []。
- 选择第二个 运行链 事件,然后单击 编辑。
- 在 基本信息中,输入名称和描述,以帮助识别该事件记录了流域电子表格中的数据上传。
- 在 链式运行中,选择 3。 分水岭链是之前创建的。
- 输入链运行时参数,然后点击 保存:
输入 值 范围 输入 F12:F12。电子表格ID 选择 SpreadsheetID 链变量。 工作表 ID 选择 SheetID 链变量。 - 点击 发布,输入有关其发布的任何注释,然后点击 发布。
跑链
要使用最新的碳足迹数据更新 Watershed 电子表格:
- 从 Watershed 电子表格的 ] Control 表 ] 部分,选择要从 Watershed 下载的数据的时间段(月份和年份)。
- 从 Wdata Chains中选择 1。分水岭 链,然后单击 执行 和 运行链。
注意:运行此链时,它会自动运行另外两个链 ,以使用数据更新 Wdata表和 Watershed 电子表格
。