Workiva Support Center

Watershed的企业气候平台使您能够衡量、报告和减少您组织的碳足迹。

借助 Workiva 平台，您可以构建链，根据自定义 [] Watershed [] 电子表格中指定的时间段，自动从 Watershed 下载 碳足迹数据（例如用于环境、社会和治理 (ESG) 或可持续发展 报告的披露）到表格中。然后，您可以将该表用作查询或电子表格连接的数据源，例如将数据包含在报表输出中。

注意： 虽然这些说明中您需要构建多个链，但您只需运行其中一个链（该链会自动运行其他链）即可从 Watershed 下载数据并更新电子表格。

注： 这些链使用的 Watershed 电子表格由 Workiva 提供。如果您还没有这项服务但感兴趣，请联系您的客户成功经理了解详情。

先决条件

要构建这些链条，您需要以下连接器：

• Workiva 连接器
• 表格变换 连接器
• JSON 连接器
• HTTP 请求 连接器
• 文件实用工具 连接器

提示： 所有链的命令都使用默认的CloudRunner。不需要地面巡逻员。

为了成功运行这些链，还需要确定：

• 活动提供者 用于向 Watershed API 进行身份验证和执行操作的密钥
• 流域 电子表格、 其 控制表部分及其关联表的 ID

构建一个用于记录数据下载的链

首先，建立一个链来更新 控制表 部分，以跟踪碳足迹数据何时上传到 Workiva。

步骤 1. 创建链条

1. 从 链中，单击 创建，然后选择 创建链。
   
2. 在 设置中，输入 3 的名称。流域 和描述，以帮助识别链式日志流域数据上传。
   
3. 点击 保存。
   
   

步骤 2. 从运行时输入事件开始

1. 从 链事件中，将 运行时输入 移动到 开始。
2. 选择 运行时输入 事件，然后单击 编辑。
3. 在 基本信息中，输入名称和描述，以帮助识别事件。
   
4. 在 变量中，添加具有以下显示名称的 TextField 输入框：
   • 范围
   • 表格ID
   • 工作表ID

   提示： 将这些变量的默认值留空；它们将在运行 1. 分水岭链是后来形成的

   。
5. 为所有三个变量选择 必填 ，然后单击 保存。
   
   

步骤 3. 添加文件实用程序“创建文件”命令

要为 “控制表 ”部分创建日志文件，请添加“文件实用程序 ”中的“创建文件 ”命令：

1. 从 可用连接器中，选择 文件实用工具，并将 创建文件 移动到画布上。
2. 将链接从 运行时输入 拖到 创建文件。
3. 选择 创建文件 命令，然后单击 编辑。
4. 在 基本信息中，输入名称和描述以帮助识别命令。
   
5. 输入命令属性，然后单击 保存:
   

   摘要信息	值
   连接线	选择要使用的文件实用工具连接器。
   文本	输入 上次刷新足迹数据的时间，并选择 System.DateTime 运行时变量。

步骤 4. 添加 Workiva 写入工作表数据命令

要使用日志文件更新 控制表 部分，请添加 Workiva 写入表数据 命令：

1. 从 可用连接器中选择 Workiva，并将 写入工作表数据 移动到画布上。
2. 将链接从 创建文件 拖到 写入工作表数据。
3. 选择 写入工作表数据 命令，然后单击 编辑。
4. 在 基本信息中，输入名称和描述以帮助识别命令。
5. 输入命令属性，然后单击 保存:
   
   

   摘要信息	值
   连接线	选择要使用的 Workiva 连接器。
   电子表格ID	从 触发器 [中选择 [ SpreadsheetID [] 运行时输入。
   图纸编号/名称	从 触发器[中选择 [] SheetID 运行时输入。
   数据文件	选择 创建文件命令 的输出结果。
   分隔符号	输入逗号（,）。
   地区	从 触发器 [] 中选择 范围] 运行时输入。

6. 点击 发布，输入有关其发布的说明，然后点击 发布。

从“加载数据到 Wdata”模板构建链

接下来，使用 将数据加载到 Wdata 模板 构建链，以使用从 Watershed 下载的数据更新 Watershed 电子表格的连接表。 Load Data to Wdata 模板创建一系列链，这些链协同工作，以确定数据集是否已存在于表中，并使用最新数据集更新表。

要从 模板创建链，请打开 加载数据到 Wdata | 主链 模板，然后单击 新建链。

构建一个从 Watershed 下载数据的链

最后，建立一条从 Watershed 下载和导入碳足迹数据的链。

注： 在此链之前创建其他两个链，以便运行其 链 事件。

步骤 1. 创建链条

1. 从 链中，单击 创建，然后选择 创建链。
2. 在 设置中，输入名称 1。分水岭 和描述，以帮助进一步识别该链条。
   
3. 在 变量中，添加流域 API 密钥以及流域电子表格及其控制表的 ID 的变量。
   

   姓名	值
   API密钥	输入流域API密钥。
   电子表格ID	输入流域电子表格的 ID。
   工作表ID	输入流域电子表格中 控制表 部分的 ID。

4. 点击 保存。
   
   

步骤 2. 首先使用 Workiva 的“获取工作表数据”命令

首先使用 Workiva 获取工作表数据 命令，根据流域电子表格 控制工作表中的时间段来确定要下载的数据：

1. 从 可用连接器中，选择 Workiva，并将 获取工作表数据移动到 开始。
2. 选择 获取工作表数据命令，然后单击 编辑。
3. 在 基本信息中，输入名称和描述以帮助识别命令。
4. 输入命令属性，然后单击 保存:
   
   

   摘要信息	值
   连接线	选择要使用的 Workiva 连接器。
   电子表格ID	选择 电子表格 ID 链变量。
   图纸编号/名称	选择 工作表 ID 链变量。
   地区	输入 A11:。
   价值风格	选择“计算”。
   修订	为确保使用最新版本，请输入 -1。

步骤 3. 添加命令以准备流域时间段

要确定流域时间段，请添加 高级查询 和 CSV 转 JSON 命令：

1. 从 可用连接器中选择 表格转换，并将 高级查询 移动到画布上。
2. 将链接从 获取工作表数据拖到 高级查询。
3. 选择 高级查询 命令，然后单击 编辑。
4. 在 基本信息中，输入名称和描述以帮助识别命令。
5. 输入命令属性，然后单击 保存:
   
   

   摘要信息	值
   连接线	选择要使用的表格转换连接器。
   表格	添加时间段数据表： 在 文件中，选择 获取工作表数据 命令的 数据 输出。 在 表名中，输入 一个。
   查询	输入要运行的查询： 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'。数据来自 。
   输入分隔符	选择逗号。
   输出分隔符	选择逗号。
   预览结果	选中此复选框。

6. 从 可用连接器中选择 JSON，并将 CSV 到 JSON 移动到画布上。
7. 将链接从 高级查询 拖到 CSV 转 JSON。
8. 选择 CSV 转 JSON 命令，然后单击 编辑。
9. 在 基本信息中，输入名称和描述以帮助识别命令。
   
10. 输入命令属性，然后单击 保存:
    

    摘要信息	值
    连接线	选择要使用的JSON连接器。
    输入文件	选择 高级查询 命令的 结果 [] 输出。
    分隔符号	选择逗号（，）。

步骤 4. 添加 HTTP 请求 GET 命令

要下载所选时间段的碳足迹数据，请添加 HTTP 请求 GET 命令：

1. 从 可用连接器中，选择 HTTP 请求，并将 GET 移动到画布上。
2. 将链接从 CSV 拖到 JSON 到 GET。
3. 选择 GET 命令，然后单击 编辑。
4. 在 基本信息中，输入名称和描述以帮助识别命令。
5. 输入命令属性，然后单击 保存:
   
   

   摘要信息	值
   连接线	选择要使用的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 并在 控制表 部分记录上传操作，请为先前创建的链添加 运行链 事件：

1. 从 链事件中，将 运行链 移动到画布上。
2. 将链接从 GET 拖到 Run 链。
3. 选择 运行链 事件，然后单击 编辑。
4. 在 基本信息中，输入名称和描述，以帮助识别该事件将数据上传到 Wdata。
5. 在 运行链中，选择 加载数据到 Wdata | 主链 ，该主链 [] 之前已从 加载数据到 Wdata 模板创建。
   
6. 输入链运行时参数，然后点击 保存：

   输入	值
   表格 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 [] 命令的 响应 输出。
   加载方法	选择“替换数据集”。
   回滚	选中此复选框。

7. 从 链事件中，将另一个 运行链 移动到画布上。
8. 将链接从第一个 运行链 拖到第二个 []。
9. 选择第二个 运行链 事件，然后单击 编辑。
10. 在 基本信息中，输入名称和描述，以帮助识别该事件记录了流域电子表格中的数据上传。
11. 在 链式运行中，选择 3。 分水岭链是之前创建的。
    
12. 输入链运行时参数，然后点击 保存：

    输入	值
    范围	输入 F12:F12。
    电子表格ID	选择 SpreadsheetID 链变量。
    工作表 ID	选择 SheetID 链变量。

13. 点击 发布，输入有关其发布的任何注释，然后点击 发布。
    
    

跑链

要使用最新的碳足迹数据更新 Watershed 电子表格：

1. 从 Watershed 电子表格的 ] Control 表 ] 部分，选择要从 Watershed 下载的数据的时间段（月份和年份）。
   
2. 从 Wdata Chains中选择 1。分水岭 链，然后单击 执行 和 运行链。
   
   

   注意：运行此链时，它会自动运行另外两个链 ，以使用数据更新 Wdata表和 Watershed 电子表格

   。