通过 Chain Builder，您可以使用这些链模板，它们共同简化了环境、社会和治理 (ESG) 或可持续性数据的滚动更新：
- 1a. ESG 滚动更新 | 主要 | 从这里开始
- 1b. ESG 滚动更新 | 刷新连接和状态
- 1c. ESG 滚动更新 | 刷新连接 | 执行
提示：虽然您使用这些模板创建了三个链， 但实际上只会执行创建的第一个链，它会自动运行所有链
。注： 这些链仅向前滚动数据收集电子表格 — 而不是可持续发展计划。要了解如何在项目中结转数值，请参阅 可持续发展项目中结转和管理报告年份
。当您运行使用这些模板创建的链时，它们会协同工作，自动将上一年的数据集归档并导入到表中。运行链式调用时，您还可以选择：
- 导入数据集之前，请刷新源电子表格的连接，以确保使用最新值。
- 清除源电子表格中的值（链接到其他来源或目标的值除外），例如为下一年度的数据收集做准备。
注： 这些链会自动替换连接的 Wdata 表中同一时期的任何数据集。如果在导入新数据集时发生错误，则表格将恢复为之前的数据集。
先决条件
由这些模板创建的链需要特定的连接器来执行其命令。
在使用这些模板创建链之前，请先在链构建器中设置这些连接器：
注： 这些模板链中使用的所有连接器均使用默认的 CloudRunner。不需要地面巡逻员。
注意： 要执行其命令，HTTP 请求连接器需要 为 Workiva 连接器集成用户创建的 OAuth 授权的客户端 ID 和密钥 。确保 OAuth 授权具有适当的范围。
步骤 1. 设置 Workiva 文件
使用这些模板创建的链条需要对 Workiva 文件进行特定的设置，以收集可持续性数据。在运行这些模板链之前，请设置 Workiva 文件以收集和滚动数据：
- 在电子表格中，确定用于可持续发展报告的数据收集表。
- 在 Wdata 中， 创建一个表 ，该表使用电子表格作为 连接的数据集， 并记录表的 ID ，以便在运行链时使用。
- 在电子表格中， 添加一个工作表 来跟踪与 Wdata 表的传出连接的刷新状态，并记录运行链时工作表的名称。
- 创建一个查询 ，以便在链式数据归档时运行：
- 使用连接到数据收集电子表格的 Wdata 表作为 数据源。
- 在查询中， 包含一个用于年份的多选参数 ，其数据类型与表中的 年份 列相同。
- 记录查询的 ID ，以便在运行链时使用。
步骤 2. 确定变量和运行时输入的值
为了使这些链能够与多个工作区协同工作，它们使用变量来识别 Workiva 连接器的集成用户和环境。在 Chain Builder中， 创建以下工作区变量：
| 多变的 | 值 |
|---|---|
| wsv-客户端ID | 为 Workiva 集成用户创建的 OAuth2 授权的客户端 ID |
| wsv-ClientSecret | 为集成用户创建的 OAuth2 授权生成的客户端密钥 |
| wsv-BaseURL-Wdata | 根据环境区域，Wdata 命令的 URL 主机基址和基址路径：
|
| wsv-BaseURL-IAM | 根据环境区域，身份和访问管理命令的 URL 主机基本路径和基本路径：
|
| wsv-BaseURL-OC | Chains 命令的 URL 主机基址和基址路径，取决于环境的区域：
|
当你运行由 1a.创建的链时ESG 滚动更新 | 主要 | 从这里开始 模板，它会提示运行时输入，以识别要交互的 Workiva 文件以及如何识别数据集：
| 运行时输入 | 值 |
|---|---|
| 数据收集—滚动表 ID | 导入数据集时，需要将与数据收集电子表格关联的 Wdata 表的 ID 导入到该电子表格中。 |
| 数据收集—滚动查询 ID | 用于归档数据的 Wdata 查询的 ID |
| PY 年 | 待存档数据的年份 |
| 标签值 | 已归档数据集的名称 注意： 链使用 标签值 输入和 PY 年份 输入来创建数据集的文件名，格式为 文件 |
| 状态—工作表名称 | 用于跟踪电子表格与 Wdata 表之间的出站连接刷新状态的工作表名称 |
步骤 3. 创建链条
要创建向前滚动数据收集所需的链，请使用 1a。ESG滚动更新 | 主要 | 从这里开始 模板：
- 从 模板 中的 链式构建器中，打开 1a。ESG 滚动更新 | 主要 | 从这里开始 模板，然后点击 新建链。
- 请输入名称以帮助识别该链条。
- 选择要使用该链的环境，然后单击 下一步。
- 对于 dcv-clearSuccess 变量，输入名称
dvc-clearSuccess，然后单击 下一步。 - 对于每个连接，选择要使用的连接器，然后单击 下一个链。
注： 每个连接器都使用默认的 CloudRunner。
- 设置每个变量，然后单击 下一步。
多变的 变量类型 新变量 wsv-客户端ID 工作区 选择 wsv-ClientID。 cv-TimeToCheck 链 cv-TimeToCheckwsv-ClientSecret 工作区 选择 wsv-ClientSecret。 dcv-刷新状态 链式动力学 dcv-刷新状态wsv-BaseURL-IAM 工作区 选择 wsv-BaseURL-IAM。 wsv-BaseURL-OC 工作区 选择 wsv-BaseURL-OC。 - 对于每个连接，选择要使用的连接器，然后单击 下一个链。
注： 每个连接器都使用默认的 CloudRunner。
- 设置每个变量，然后单击 下一步。
多变的 变量类型 新变量 dcv-srcStatus 链式动力学 dcv-srcStatuswsv-客户端ID 工作区 选择 wsv-ClientID。 dcv-destStatus 链式动力学 dcv-destStatuswsv-ClientSecret 工作区 选择 wsv-ClientSecret。 wsv-BaseURL-Wdata 工作区 选择 wsv-BaseURL-Wdata。 wsv-BaseURL-IAM 工作区 选择 wsv-BaseURL-IAM。 - 对于每个连接，选择要使用的连接器，然后单击 提交。
注： 每个连接器都使用默认的 CloudRunner。
步骤 4. 发布链
注： 为了方便安装， 刷新连接和状态 模板有一个 运行链 事件。在发布由模板创建的链之前，请删除此多余的 运行链 事件。
- 从 链中，对于从 刷新连接和状态 模板创建的链，选择 编辑。
- 选择 运行链 - 删除 事件，然后单击 删除和 删除。
- 点击 发布 和 发布。
- 从 链中，对于从 主 模板创建的链，选择 编辑。
- 点击 发布 和 发布。
- 从 Chains中，对于从 Execution 模板创建的链，选择 Edit。
- 点击 发布 和 发布。
跑链
为了存档您的数据并为下一年度的数据收集做好准备：
- 在 链构建器中，从 链中选择 执行 ，以执行由 1a.创建的链。ESG 滚动更新 | 主要 | 从这里开始模板。
- 点击 运行并输入参数，然后输入运行时输入参数：
运行时输入 值 数据收集—滚动表 ID 输入要导入数据集的 Wdata 表的 ID。 数据收集—滚动查询 ID 输入要运行以归档数据的查询的 ID。 PY 年 请输入要存档的数据年份。 标签值 请输入已存档数据集的名称。 注： 使用 PY 年份 输入时，此输入会将数据集的文件名创建为
文件[标签值]_[PY 年份].csv。例如，如果 PY年份为 2021 年，标签值为 Archived ，则会生成名Archived_2021.csv。数据归档前刷新工作表连接。 选择是否在运行前滚查询之前刷新电子表格与 Wdata 表的传出连接，例如在归档之前更新数据集。 状态—工作表名称 输入用于跟踪从电子表格到 Wdata 表的传出连接的刷新状态的工作表名称。 刷新执行—链名 输入从 ESG Rollforward | Refresh connection | Execution 模板创建的链的名称。 清除电子表格值列 选择是否在滚动更新过程中从电子表格中删除输入值。 注： 任何带有源链接或目标链接的值都不会被删除。
- 为确保在导入数据集之前获得最新值，请选择 在数据归档之前刷新连接。
如果选择此选项，链式结构将刷新电子表格的传出连接，并在控制表中跟踪其刷新状态：- 在 状态—工作表名称中，输入源电子表格中链可以保存传出连接的刷新状态的工作表名称。
- 在 RefreshExecution—ChainName中，输入从 ESG Rollforward | Refresh connection | Execution 模板创建的链的名称。
提示： 刷新可能需要几分钟时间，具体取决于电子表格的出站连接数。要调整等待时间，请编辑由 1b.创建的链的 暂停链 事件。ESG 前滚 | 刷新连接和状态 模板。
- 要从源电子表格中删除输入值以进行归档（例如，为下一年度的数据收集做准备），请选择 清除电子表格值列。
注： 链会保留与源或目标关联的任何值。从电子表格中删除的任何值都无法恢复。我们建议您仅在年度最后一次滚动更新时选择此选项，以便为下一年度的数据收集准备电子表格。
提示： 默认情况下，链式删除操作会从电子表格工作表的第 2 行开始删除值。要调整此设置，请编辑 “清除工作表数据 ”命令的 “区域 ”属性
。 - 点击 开始。