Workiva Support Center

你看过 Chains Foundations 网络研讨会吗？想按照自己的节奏学习吗？在本关联学习路径中，我们将创建一个链，该链从源下载数据，上传到 Wdata 表，并刷新连接，遵循链基础网络研讨会期间采取的步骤。

步骤 1：创建链

为了实现源数据到最终报告的自动迁移，我们首先需要创建一个链，该链将协调从开始到结束的整个过程。由于我们将始终使用同一个电子表格和表格，我们将设置链式变量来存储这些详细信息，以便进行一致的访问。

1. 创建一个新的 链，并将链命名为： CLP | 链基础。

2. 在 链式变量下，单击加号两次以创建两个链式变量，并按如下所述进行配置：

   变量 1：

   • 类型： 链变量 (cv)
   • 名称： 简历电子表格 ID
   • 值：在 Wdata Foundations CLP中创建的 CLP 公司按部门支出电子表格的 ID。
   • 查找电子表格 ID：
     1. 导航至 CLP 公司按部门划分的支出电子表格。
     2. 在 URL 中，选择电子表格 ID，该 ID 位于“spreadsheet/”之后和“/sheet”之前。例如，此处以粗体显示的是电子表格 ID：app.wdesk.com/a/QWNjb3VudB8yMDkwNzExMDQ0/spreadsheet/
        6c4a23966c3c4a10a3178ae5791db7fd/-1/sheet/3161ee0402ec4b9fa4e937e6f0f63b13

   变量 2：

   • 类型： 链变量 (cv)
   • 名称： cv-表 ID
   • 值： 输入 CLP 公司支出表的 ID。
   • 查找表 ID：
     1. 导航至 CLP 公司支出表。
     2. 在 URL 中，选择“table/”后面的表 ID。例如，此处以粗体显示的是表 ID：app.wdesk.com/s/wdata/a/QWNjb3VudB8yMDkwNzExMDQ0/tables/16aba1634ead43a29df8f839422582f0
        
3. 保存 链条。

步骤二：下载文件

我们将使用 HTTP 请求 GET 命令下载要上传到表中的文件。我们已将文件托管在网上，供 Chain 下载，以演示如何从云端下载文件。为了使这个过程动态化，我们将在 URL 中添加当前周期，该周期对应于我们所在的月份，这将确保我们提取的是最新的数据集。

1. 从 HTTP 请求 连接器向起始区域添加 Get 命令。
2. 双击该命令进行配置。
   1. 使用变量生成当前月份（对应于当前周期），并将以下内容填充到 URL 字段中：
      https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/Webinars/ERP-P <System.DateTime>.csv.
   2. 代替 <System.DateTime> 使用运行时变量作为系统日期和时间。
   3. 在 选择变量 面板中，单击向下箭头展开 运行时。
   4. 选择 System.DateTime。
   5. 单击 System.DateTime 变量进行转换。请使用以下数值：
      1. 对于 选择转换:，选择解析日期/时间。
      2. 点击 + 按钮。
      3. 对于 格式下拉菜单：，选择 ISO 扩展（平台标准）。
      4. 对于 输出日期格式：，选择 %m。
         这意味着我们将只能获得系统日期和时间中的两位数月份。
         点击此处了解更多常见日期和时间转换信息。
      5. 在 输入日期时区 字段和 输出日期时区 字段中，选择您当前的时区。
      6. 点击 接受。
         
3. 将 内容类型 字段更新为： application/csv。
4. 保存命令。

步骤 3：创建文件

将文件上传到 Wdata 表是一个两步过程。文件必须先创建为 暂存 状态，然后才能导入以供最终使用。我们将使用“创建文件”命令在 Wdata 表中创建处于“暂存”状态的文件，表示该文件已创建但尚未作为数据集导入。

1. 从 Workiva连接器向链 画布添加一个创建 文件 命令。
2. 将 Get 命令连接到 Create File 命令。
3. 双击该命令进行配置。
   1. 点击 表 ID 字段。
      1. 在左侧的 选择变量 面板中，单击向下箭头展开 链。
      2. 选择 cv-表 ID。
   2. 点击 文件 字段。
      1. 在左侧的 选择变量 面板中，单击向下箭头展开 获取。
      2. 选择 响应。
   3. 按照之前在名称字段中填充期间相同的步骤，将以下信息填充到 名称 字段中：
      ERPSpendData<System.DateTime>.csv
   4. 代替 <System.DateTime> 使用运行时变量作为系统日期和时间。
      1. 在左侧的 选择变量 面板中，单击向下箭头展开 运行时。
      2. 选择 System.DateTime。
      3. 单击 System.DateTime 变量进行转换。
         1. 对于 选择转换，选择 解析日期/时间。
         2. 点击 + 按钮。
         3. 对于 格式，选择 ISO 扩展（平台标准）。
         4. 对于 输出日期格式，选择%m-%d-%Y@T%H:%M。
            这意味着我们将只能获得链运行的完整日期和时间。
            点击此处了解更多常见日期和时间转换信息。
         5. 在 输入日期时区 字段和 输出日期时区 字段中，选择您当前的时区。
         6. 点击 接受。
            
4. 点击 保存 以保存命令。

步骤 4：将文件导入表

将文件上传到 Wdata 表的第二步是导入数据，使其可在查询中使用。此步骤会将暂存的文件作为数据集导入到指定的表中。

1. 从 Workiva连接器向链画布添加 导入文件到表 命令。
2. 将 创建文件 命令连接到 导入文件到表 命令。
3. 双击该命令进行配置。
4. 点击 表 ID 字段。
   1. 在左侧的 选择变量 面板中，单击向下箭头展开 链。
   2. 选择 cv-表 ID。
5. 点击 文件 ID 字段。
   1. 在左侧的 选择变量 面板中，单击向下箭头展开 创建文件。
   2. 点击向下箭头展开 结果。
   3. 选择 Id。
6. 保存命令。

步骤五：列出连接

我们将使用“列出连接”命令来检索与电子表格 ID 关联的连接 ID 列表。列出连接命令的输出将是一个 JSON 文件，其中包含电子表格中的每个连接以及与连接相关的详细信息，包括连接 ID。

1. 将 Workiva连接器中 的 “列出连接 ”命令添加到链画布中。
2. 将 导入文件到表 命令连接到 列出连接 命令。
3. 双击该命令进行配置。
   • 目标类型： 电子表格
   • 目标 ID：使用 电子表格 ID 链变量
     1. 点击“目的地 ID”字段。
     2. 在左侧变量面板中，展开 链 下拉菜单。
     3. 选择 电子表格 ID 变量。
4. 保存命令。

步骤 6：命令组

我们将使用命令组来对每个连接进行迭代。分组迭代器将逐一推动电子表格中的每个连接执行以下步骤。

1. 在链画布上添加一个 命令组 。
2. 将 列出连接 命令连接到 [] 命令组的 在 部分。
3. 双击该命令进行配置。
   1. 组名称： 连接迭代
   2. 导航至 迭代器 选项卡。
   3. 启用 迭代 开关，然后单击 迭代 字段。
      1. 在 选择变量 面板中，单击向下箭头展开 列出连接。
      2. 选择 连接 输出。
4. 保存命令组。

步骤 7：刷新连接

我们将使用“刷新连接”命令，利用迭代中的连接 ID 来刷新我们的连接。

1. 从 Workiva连接器向链画布添加 刷新连接 命令。
2. 将组迭代器的 开始 部分连接到 刷新连接 命令。
3. 双击该命令进行配置。
   • 对于 连接 ID： 使用来自组迭代器 - 连接迭代的连接 ID。这样我们就可以将当前迭代的 ID 传递给“刷新连接”命令。
     1. 点击 连接 ID 字段。
     2. 在左侧面板中，展开 组迭代器 下拉菜单。
     3. 展开 连接迭代 下拉菜单。
     4. 选择 ConnectionId 变量。
   • 选中 “使用先前源参数 ”复选框。

步骤 8：测试练习

现在链式流程已完成，请测试结果。

1. 发布 链。
2. 单击 执行 ，然后单击 运行链。
3. 链式操作完成后，返回表格，查看数据是否已加载；返回电子表格，查看连接是否已成功刷新。

成功运行

数据已添加到表中

连接已刷新