Workiva Support Center

通过将步骤合并到同一条链中，可以进一步简化数据管理。在本关联学习路径中，我们将逐步介绍替换 Wdata 表中数据的最佳方法，这是一个使用一个链的两步过程。

步骤 1：运行链

1. 导航至 CLP | 上传数据到表 链。
2. 单击 执行 ，然后选择 使用输入运行。
3. 请输入运行时输入值：
   • 表 ID- CLP 员工详细信息表的 ID
     查看此文档以获取查找 ID 的帮助。
   • 文件名- 你想给文件起的任何名称，在本例中，我们将文件命名为“员工详情”。
   • 文件位置 - https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail.csv.
4. 点击 开始。
5. 链式操作完成后，单击 导入文件到表 节点以验证是否成功。
   CLP员工详细信息表中现在已有数据，我们将使用单个链删除旧数据并上传新数据，然后用更新后的数据集替换旧数据。

步骤 2：创建链

1. 添加一个新的 链。
2. 命名链： CLP | 替换表中的数据。
3. 拯救链条。

步骤 3：运行时输入

我们使用运行时输入命令来启动链。这样，我们就可以在运行链时指定文件名和要将文件导入的表的 ID。

1. 在“开始”区域添加 运行时输入 命令，该命令来自链式触发事件。
2. 双击命令编辑 运行时输入 链事件。
   添加以下三个输入项：
   • 输入 1：
     • 类型：文本字段
     • 显示名称： 表 ID：
     • 必填：已勾选
   • 输入 2：
     • 类型：文本字段
     • 显示名称： 文件名：
     • 必填：已勾选
   • 输入 3：
     • 类型：文本字段
     • 显示名称： 文件位置：
     • 必填：已勾选
3. 保存命令。

步骤 4：列出文件

要删除表中的旧文件，我们需要文件 ID。要通过编程方式查找文件 ID，我们将使用列出文件命令。此命令使用表 ID 搜索该表中的所有文件，并向我们提供文件的输出以及有关这些文件的信息，包括文件 ID。

1. 向链画布添加 列出文件命令
2. 将 运行时输入 链式事件连接到 列出文件 命令。
3. 双击命令进行配置，然后单击 表 ID 字段。
4. 在左侧的 变量 面板中，单击向下箭头展开 触发器。
   1. 单击向下箭头展开 运行时输入。
   2. 选择 TableID。
5. 保存命令。

步骤 5：从表中取消导入文件

与向表格上传数据类似，从表格中删除数据也是一个两步过程。文件必须先移至暂存状态才能删除。要将文件设置为暂存状态，需要先取消导入。我们将使用 从表 中取消导入文件命令来准备要删除的数据集。

1. 向链画布添加 从表中取消导入文件命令。
2. 将 列出文件 命令连接到 从表中取消导入文件命令。
3. 双击该命令进行配置。
   1. 点击 表 ID 字段。
      1. 在左侧的 变量 面板中，单击向下箭头展开 触发器。
      2. 单击向下箭头展开 运行时输入。
      3. 选择 TableID。
   2. 点击 文件 ID 字段。
      1. 在左侧的“变量”面板中，单击向下箭头展开 列表文件。
      2. 选择 文件列表。
      3. 单击 列出文件 - 文件列表变量 以转换变量。
         1. 单击 选择转换 ，然后选择 从 JSON 获取值。
         2. 点击加号添加变量转换。
         3. 在“值”字段中输入“0”，然后按 Enter。
         4. 在出现 =0 之后，输入 'id' 并按 Enter 再次。
            该变量现在将读取“列出文件”命令的 JSON 输出，并查找表中第一个文件的 ID。

            提示！解析 JSON 值时，请特别注意大小写。

         5. 点击 接受。
            
   3. 保存 命令。
      

    

   步骤 6：下载文件

   接下来，我们可以从表中删除暂存文件，或者准备上传新文件。我们建议在卸载旧文件后上传新文件，以确保卸载过程成功，然后再正式删除任何数据。

   为了准备上传新文件，我们首先需要使用 HTTP 请求 Get 命令下载该文件。我们已将一个文件托管到网上，供 Chain 下载，以演示如何从云端下载文件。

   1. 从 HTTP 请求 连接器向链画布添加 Get 命令。
   2. 将 从表 中取消导入文件命令连接到 获取 命令。
   3. 双击命令进行配置。
      
      1. 点击 URL 字段。
         1. 在左侧的 “选择变量”面板中，单击向下箭头展开 “触发器”。
         2. 点击向下箭头展开 运行时输入。
         3. 选择 文件位置。
      2. 将 内容类型 字段更新为： application/csv。
   4. 保存 命令。

   

   步骤 7：创建文件

   就像我们在 将数据上传到表格连接学习路径中所做的那样，我们将按照两步流程将数据上传到 Wdata 表格。文件需要先创建为“暂存”状态，然后才能导入以供最终使用。我们将使用“创建文件”命令在 Wdata 表中创建处于“暂存”状态的文件，表示该文件已创建但尚未作为数据集导入。

   1. 从 Workiva连接器向链画布添加 创建文件 命令。
   2. 将 获取 命令连接到 创建文件 命令。
   3. 双击命令进行配置。
      
      1. 点击 表 ID 字段。
         1. 在左侧的 “选择变量”面板中，单击向下箭头展开 “触发器”。
         2. 点击向下箭头展开 运行时输入。
         3. 选择 表 ID。
      2. 点击 文件 字段。
         1. 在左侧的 “选择变量”面板中，单击向下箭头展开 “获取”选项。
         2. 选择 响应。
      3. 点击 名称 字段。
         1. 在左侧的 “选择变量”面板中，单击向下箭头展开 “触发器”。
         2. 点击向下箭头展开 运行时输入。
         3. 选择 文件名。
         4. 在左侧的 “选择变量 ”面板中，单击向下箭头展开 “运行时” 。
         5. 选择 Chain.ExecutionDateTime.
         6. 在两个变量后面输入“.csv”。
            Chain.ExecutionDateTime 变量用于显示文件的生成时间，并确保每个文件都有唯一的名称。

   

   步骤 8：将文件导入表

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

   1. 从 Workiva连接器向链画布添加 导入文件到表 命令。
   2. 将 创建文件 命令连接到 导入文件到表 命令。
   3. 双击该命令进行配置。
      
      • 对于 表 ID 字段：
        1. 在左侧的 选择变量 面板中，单击向下箭头展开 触发器。
        2. 单击向下箭头展开 运行时输入。
        3. 选择 表 ID。
      • 对于 文件 ID 字段。
        1. 在左侧的 选择变量 面板中，单击向下箭头展开 创建文件。
        2. 选择 结果。
        3. 点击 创建文件 - 结果 进行转换。
           1. 在 选择转换 下拉列表中，选择 从 JSON 获取值。
           2. 点击“+”（加号）按钮。
           3. 在“值”字段中，键入“id” ，然后按 Enter。
           4. 点击 接受。
   4. 保存 命令

   

   步骤 9：删除文件

   现在新数据已经上传完毕，可以投入使用，旧数据集也已准备就绪，最后一步就是正式删除旧数据。此步骤使用 删除文件 命令从表中删除数据集。

   1. 从 Workiva连接器向链 画布添加 “删除文件 ”命令
   2. 将 “导入文件到表”命令连接到 “删除文件”命令
   3. 双击命令进行配置。
      为确保我们删除的是与取消导入的文件相同的文件，我们将以与“从表取消导入文件”命令相同的方式生成文件 ID：
      • 在 文件 ID 字段中：
        1. 在左侧的 变量 面板中，单击向下箭头展开 文件列表。
        2. 选择 文件列表。
        3. 单击 列出文件 - 文件列表 变量以转换变量。
           1. 单击 选择转换 ，然后选择 从 JSON 获取值。
           2. 点击加号（+）添加变量转换。
              1. 在 值 字段中键入“0”，然后按 Enter。
              2. 在出现 =0 之后，输入“id”并按 Enter 再次。
                 该变量现在将读取“列出文件”命令的 JSON 输出，并查找表中第一个文件的 ID。

                 提示！解析 JSON 值时，请特别注意大小写。

              3. 点击 接受
                 
              4. 保存 命令.xx
                 

               

              步骤 10：测试练习

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

              1. 单击 执行 ，然后选择 使用输入运行。
              2. 为运行时输入添加值。
                 • 表 ID- CLP 员工详细信息表的 ID
                   请参阅此文档以获取查找 ID 的帮助
                 • 文件名- 你想给文件起的任何名称；在本例中，我们将文件命名为“员工详情”。
                 • 文件位置 - https://cs-sftp-training-bucket.s3.amazonaws.com/cs-training/transformation-qs/employee_detail_replace.csv
              3. 点击 开始
                 • 链式操作应该已经成功删除了旧文件，并将新文件替换到您的表中。
                 • 您可以通过在 Wdata 中导航到表格，并在右侧面板中查看数据集来验证表格中的数据是否已替换。

              

              

              要了解有关使用 Chains 简化数据收集的更多信息，请查看其余的 数据中心化路径！