通过 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 行开始删除值。要调整此设置,请编辑 “清除工作表数据 ”命令的 “区域 ”属性
。 - 点击 开始。