你看过 Chains Foundations 网络研讨会吗?想按照自己的节奏学习吗?在本关联学习路径中,我们将创建一个链,该链从源下载数据,上传到 Wdata 表,并刷新连接,遵循链基础网络研讨会期间采取的步骤。
| 主要业务用例 | 自动化报告工作流程 |
| 主要学习目标 | 学习基础链式反应概念 |
| 先决条件 |
请完成以下步骤: |
| 支持模板 | CLP | 链式基金会 |
步骤 1:创建链
为了实现源数据到最终报告的自动迁移,我们首先需要创建一个链,该链将协调从开始到结束的整个过程。由于我们将始终使用同一个电子表格和表格,我们将设置链式变量来存储这些详细信息,以便进行一致的访问。
- 创建一个新的 链,并将链命名为: CLP | 链基础。
-
在 链式变量下,单击加号两次以创建两个链式变量,并按如下所述进行配置:
变量 1:
- 类型: 链变量 (cv)
- 名称: 简历电子表格 ID
- 值:在 Wdata Foundations CLP中创建的 CLP 公司按部门支出电子表格的 ID。
- 查找电子表格 ID:
- 导航至 CLP 公司按部门划分的支出电子表格。
- 在 URL 中,选择电子表格 ID,该 ID 位于“
spreadsheet/”之后和“/sheet”之前。例如,此处以粗体显示的是电子表格 ID:app.wdesk.com/a/QWNjb3VudB8yMDkwNzExMDQ0/spreadsheet/
6c4a23966c3c4a10a3178ae5791db7fd/-1/sheet/3161ee0402ec4b9fa4e937e6f0f63b13
变量 2:
- 类型: 链变量 (cv)
- 名称: cv-表 ID
- 值: 输入 CLP 公司支出表的 ID。
- 查找表 ID:
- 导航至 CLP 公司支出表。
- 在 URL 中,选择“
table/”后面的表 ID。例如,此处以粗体显示的是表 ID:app.wdesk.com/s/wdata/a/QWNjb3VudB8yMDkwNzExMDQ0/tables/16aba1634ead43a29df8f839422582f0
- 保存 链条。
步骤二:下载文件
我们将使用 HTTP 请求 GET 命令下载要上传到表中的文件。我们已将文件托管在网上,供 Chain 下载,以演示如何从云端下载文件。为了使这个过程动态化,我们将在 URL 中添加当前周期,该周期对应于我们所在的月份,这将确保我们提取的是最新的数据集。
- 从 HTTP 请求 连接器向起始区域添加 Get 命令。
- 双击该命令进行配置。
- 使用变量生成当前月份(对应于当前周期),并将以下内容填充到 URL 字段中:
https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/Webinars/ERP-P <System.DateTime>.csv. - 代替 <System.DateTime> 使用运行时变量作为系统日期和时间。
- 在 选择变量 面板中,单击向下箭头展开 运行时。
- 选择 System.DateTime。
- 单击 System.DateTime 变量进行转换。请使用以下数值:
- 对于 选择转换:,选择解析日期/时间。
- 点击 + 按钮。
- 对于 格式下拉菜单:,选择 ISO 扩展(平台标准)。
- 对于 输出日期格式:,选择 %m。
这意味着我们将只能获得系统日期和时间中的两位数月份。
点击此处了解更多常见日期和时间转换信息。 - 在 输入日期时区 字段和 输出日期时区 字段中,选择您当前的时区。
- 点击 接受。
- 使用变量生成当前月份(对应于当前周期),并将以下内容填充到 URL 字段中:
- 将 内容类型 字段更新为: application/csv。
- 保存命令。
步骤 3:创建文件
将文件上传到 Wdata 表是一个两步过程。文件必须先创建为 暂存 状态,然后才能导入以供最终使用。我们将使用“创建文件”命令在 Wdata 表中创建处于“暂存”状态的文件,表示该文件已创建但尚未作为数据集导入。
- 从 Workiva连接器向链 画布添加一个创建 文件 命令。
- 将 Get 命令连接到 Create File 命令。
- 双击该命令进行配置。
- 点击 表 ID 字段。
- 在左侧的 选择变量 面板中,单击向下箭头展开 链。
- 选择 cv-表 ID。
- 点击 文件 字段。
- 在左侧的 选择变量 面板中,单击向下箭头展开 获取。
- 选择 响应。
- 按照之前在名称字段中填充期间相同的步骤,将以下信息填充到 名称 字段中:
ERPSpendData<System.DateTime>.csv - 代替 <System.DateTime> 使用运行时变量作为系统日期和时间。
- 在左侧的 选择变量 面板中,单击向下箭头展开 运行时。
- 选择 System.DateTime。
- 单击 System.DateTime 变量进行转换。
- 对于 选择转换,选择 解析日期/时间。
- 点击 + 按钮。
- 对于 格式,选择 ISO 扩展(平台标准)。
- 对于 输出日期格式,选择%m-%d-%Y@T%H:%M。
这意味着我们将只能获得链运行的完整日期和时间。
点击此处了解更多常见日期和时间转换信息。 - 在 输入日期时区 字段和 输出日期时区 字段中,选择您当前的时区。
- 点击 接受。
- 点击 表 ID 字段。
- 点击 保存 以保存命令。
步骤 4:将文件导入表
将文件上传到 Wdata 表的第二步是导入数据,使其可在查询中使用。此步骤会将暂存的文件作为数据集导入到指定的表中。
- 从 Workiva连接器向链画布添加 导入文件到表 命令。
- 将 创建文件 命令连接到 导入文件到表 命令。
- 双击该命令进行配置。
- 点击 表 ID 字段。
- 在左侧的 选择变量 面板中,单击向下箭头展开 链。
- 选择 cv-表 ID。
- 点击 文件 ID 字段。
- 在左侧的 选择变量 面板中,单击向下箭头展开 创建文件。
- 点击向下箭头展开 结果。
- 选择 Id。
- 保存命令。
步骤五:列出连接
我们将使用“列出连接”命令来检索与电子表格 ID 关联的连接 ID 列表。列出连接命令的输出将是一个 JSON 文件,其中包含电子表格中的每个连接以及与连接相关的详细信息,包括连接 ID。
- 将 Workiva连接器中 的 “列出连接 ”命令添加到链画布中。
- 将 导入文件到表 命令连接到 列出连接 命令。
- 双击该命令进行配置。
- 目标类型: 电子表格
- 目标 ID:使用 电子表格 ID 链变量
- 点击“目的地 ID”字段。
- 在左侧变量面板中,展开 链 下拉菜单。
- 选择 电子表格 ID 变量。
- 保存命令。
步骤 6:命令组
我们将使用命令组来对每个连接进行迭代。分组迭代器将逐一推动电子表格中的每个连接执行以下步骤。
- 在链画布上添加一个 命令组 。
- 将 列出连接 命令连接到 [] 命令组的 在 部分。
- 双击该命令进行配置。
- 组名称: 连接迭代
- 导航至 迭代器 选项卡。
- 启用 迭代 开关,然后单击 迭代 字段。
- 在 选择变量 面板中,单击向下箭头展开 列出连接。
- 选择 连接 输出。
- 保存命令组。
步骤 7:刷新连接
我们将使用“刷新连接”命令,利用迭代中的连接 ID 来刷新我们的连接。
- 从 Workiva连接器向链画布添加 刷新连接 命令。
- 将组迭代器的 开始 部分连接到 刷新连接 命令。
- 双击该命令进行配置。
- 对于 连接 ID: 使用来自组迭代器 - 连接迭代的连接 ID。这样我们就可以将当前迭代的 ID 传递给“刷新连接”命令。
- 点击 连接 ID 字段。
- 在左侧面板中,展开 组迭代器 下拉菜单。
- 展开 连接迭代 下拉菜单。
- 选择 ConnectionId 变量。
- 选中 “使用先前源参数 ”复选框。
- 对于 连接 ID: 使用来自组迭代器 - 连接迭代的连接 ID。这样我们就可以将当前迭代的 ID 传递给“刷新连接”命令。
步骤 8:测试练习
现在链式流程已完成,请测试结果。
- 发布 链。
- 单击 执行 ,然后单击 运行链。
- 链式操作完成后,返回表格,查看数据是否已加载;返回电子表格,查看连接是否已成功刷新。