自动刷新连接对于简化数据集中化和向 Workiva 平台迁移至关重要,尤其是在存在多个连接的情况下。在本关联学习路径中,我们将学习如何创建一个链,该链使用电子表格 ID 刷新 Wdata 和 Workiva 平台之间的连接列表。该链将在单个电子表格中生成连接列表,然后向我们提供这些连接的 ID 列表,以便我们可以自动刷新电子表格中的每个连接。
| 主要业务用例 | Workiva 和 Wdata 之间的数据连接 |
| 主要学习目标 | 了解如何使用链式连接刷新连接列表 |
| 次要学习目标 | 学习分组迭代器的基本知识 |
| 先决条件 |
为关联的 OAuth 授权用户授予对电子表格的权限 |
| 支持模板 | CLP | 刷新连接列表 |
步骤 1:创建链
- 添加一个新的链
- 命名链: CLP | 刷新连接列表
- 拯救链条
步骤 2:运行时输入
我们使用运行时输入命令来启动链。这样我们就可以指定要刷新哪个电子表格的所有连接。
- 添加 运行时输入 链事件,来自链触发事件的起始节点
- 双击命令来编辑运行时输入链事件
- 类型: 文本框
- 显示名称: 电子表格 ID:
- 必填: 已勾选:
- 保存命令
步骤 3:列出连接
我们将使用“列出连接”命令来检索与电子表格 ID 关联的连接 ID 列表。列出连接命令的输出将是一个 JSON 文件,其中包含电子表格中的每个连接以及与连接相关的详细信息,包括连接 ID。
- 从 Workiva连接器向链 画布添加 “列出连接 ”命令
- 将 运行时输入 命令连接到 列出连接 命令
- 双击命令进行配置
- 目标类型: 电子表格
- 目标 ID:使用运行时输入中的 电子表格 ID 变量 - 这允许我们将链运行时指定的值传递给“刷新连接”命令。
- 点击“目的地 ID”字段
- 在左侧面板中,展开“ 触发器 ”下拉菜单
- 展开 “运行时输入 ”下拉菜单
- 选择 电子表格 ID 变量
- 保存命令
步骤 4:命令组
我们将使用 命令组 来对每个连接进行迭代。分组迭代器将逐一推动电子表格中的每个连接执行以下步骤。
- 在链画布上添加一个 命令组
- 将 “列出连接 ”命令连接到命令组的 “输入 ”部分
- 双击命令进行配置
- 组名称: 连接迭代
- 导航至“迭代器”选项卡
- 启用 “迭代次数 ”切换开关,然后单击 “迭代 次数”字段
。- 在 “选择变量 ”面板中,单击向下箭头展开 “连接列表”。
- 选择 连接 输出
- 启用 “迭代次数 ”切换开关,然后单击 “迭代 次数”字段
- 保存命令组
步骤 5:刷新连接
我们将使用刷新连接命令,通过迭代中的连接 ID 来刷新我们的连接。
- 从 Workiva连接器向链 画布添加一个 “刷新连接 ”命令
- 将组迭代器的 开始 部分连接到 刷新连接 命令
- 双击命令进行配置
- 连接 ID:使用组迭代器 - 连接迭代中的 连接 ID 。这样我们就可以将当前迭代的 ID 传递给“刷新连接”命令。
- 点击“连接 ID”字段
- 在左侧面板中,展开 “组迭代器 ”下拉菜单
- 展开 “连接迭代 ”下拉菜单
- 选择 ConnectionId 变量
- 使用先前源参数: 已选中
- 这样我们就可以使用来自源的先前参数值来刷新连接——在本例中,带有国家/地区参数的查询仍将以巴西作为筛选值进行刷新。
- 连接 ID:使用组迭代器 - 连接迭代中的 连接 ID 。这样我们就可以将当前迭代的 ID 传递给“刷新连接”命令。
步骤 6:测试练习
现在链式循环已经完成,测试结果
- 发布 链
- 点击 执行 ,然后选择 使用输入运行
- 查找电子表格 ID
- 导航至 CLP 员工概览电子表格
- 在 URL 中,选择电子表格 ID,它位于“spreadsheet/”之后和“/sheet”之前。
- 例如,此处以粗体显示的是电子表格 ID:app.wdesk.com/a/QWNjb3VudB8yMDkwNzExMDQ0/spreadsheet/de9a4ab1374f4d438c9585a94dd9acf4/-1/sheet/3161ee0402ec4b9fa4e937e6f0f63b13
- 返回“链式构建器”,并将电子表格 ID 粘贴到“电子表格 ID”字段中。
- 点击开始
- 链式连接完成后,返回电子表格,查看两个连接是否都已成功刷新!
链式运行成功,共进行了两次迭代:
连接刷新成功:
要了解有关使用 Chains 简化数据收集的更多信息,请查看其余的 数据中心化路径!