Workiva Support Center

步骤 1：编辑现有链

• 导航至链构建器并找到链 CLP | 从控制表读取
• 点击铅笔按钮编辑链条
• 点击右上角的 链设置
  • 重命名链： CLP | 使用控制表中的值
• 拯救链条

步骤 2：将控制表转换为 JSON

为了有效地利用控制表中的值，我们将把 获取表格数据 命令的输出从 CSV 格式转换为 JSON 格式。此转换在控制表中的标题和每个标题下方的行中的相应值之间建立键值对，从而实现高效迭代。

• 从 JSON连接器向链 画布添加 CSV转 JSON命令
• 将 “获取工作表数据 ”命令连接到 “ CSV 转 JSON ”命令
• 双击命令进行配置
  • 命令名称： 将控制表​​转换为 JSON
  • 点击 输入文件 字段
    • 在 “选择变量 ”面板中，单击向下箭头展开 “获取工作表数据”。
    • 选择 数据输出
  • 分隔符字段留空，使用逗号 ( ,)
  • 保存命令
    

步骤 3：添加命令组

向链中添加 命令组 ，以允许遍历控制表中的每一行。这样我们就可以将控制表中的每一行依次传递给该组的一系列命令。

• 向链画布添加一个 命令组
• 将 “将控制表​​转换为 JSON 命令”连接到命令组的 “在 部分”
• 双击“命令”组进行配置
  • 组名称： 控制表迭代器
  • 导航至“迭代器”选项卡
    • 启用 “迭代次数 ”切换开关，然后单击 “迭代 次数”字段
      。
      • 在 “选择变量 ”面板中，单击向下箭头展开 “将控制表转换为 JSON”。
      • 选择 JSON 输出
  • 保存命令

命令配置完成后，它将遍历控制表中的每一行，并为每一行提供输出。

步骤 4：添加条件命令

在控制表中，用户可以决定是否要在工作流程中执行特定的行。这是通过 ActiveFlag 列实现的。我们将使用条件命令来确定控制表中每一行的工作流是否需要继续执行。

• 向链画布添加 条件命令 链事件
• 将 组 [] 开始 连接到 控制表迭代器 组 条件 命令
  
• 双击命令进行配置
  • 命令名称： 启用标志？
  • 将条件保留为 AND ，然后单击 + RULE 按钮
  • 请仔细检查数据类型是否设置为 String ，并将测试操作从 Is Blank 更改为 =
  • 点击命令左侧的空白区域（要测试的值）。
    • 在 “选择变量 ”面板中，单击向下箭头展开 “分组迭代器”。
    • 选择 <> JSON 文件迭代
    • 点击绿色的 JSON 文件迭代 图标来转换变量
      • 单击“选择转换”，然后选择 从 JSON 获取值
      • 按下绿色的 + 符号
      • 在值字段中，完全按照控件表中的格式输入 ActiveFlag 标题，然后按 Enter 键。
      • 选择其他转换方式，然后选择 小写
      • 按下绿色的 + 符号
      • 点击 接受

• • 回到 条件 命令中，在右侧（要比较的值）输入单词 true
    • 请确保使用小写字母，因为之前应用的变量转换会将“活动标志”值全部转换为小写。 
• 保存命令

步骤 5：将输出传递给命令

此时，控制表迭代器已设置为向命令组的“组开始”中存在的任何命令提供值。我们将利用 Handlebars 命令作为占位符来显示检索到的值，这些值也可以在下游命令中迭代使用。

• 从 Handlebars 连接器向 Chain 画布添加 渲染文本模板 命令
• 连接 活动标志？向 渲染文本模板 命令
• 双击命令进行配置
  
  • 命令名称： 捕获控制表值
  • 在 模板 字段中，输入以下信息：
    • 第一行： 控制表信息
    • 第二行： 文件名：<JSON File Iteration>
      • 替换方括号 <JSON File Iteration>在 “选择变量 ”面板中，单击向下箭头展开 “分组迭代器” 。
      • 选择 <> JSON 文件迭代

• • • • 点击绿色的 JSON 文件迭代 图标来转换变量
        • 单击“选择转换”，然后选择 从 JSON 获取值
          
          
        • 按下绿色的 + 符号
        • 在值字段中输入 FileName ，确保与控制表中的内容完全一致，然后按 Enter 键。
        • 点击 接受

• • 对第三行、第四行和第五行重复上述步骤。
    • 替换方括号 <JSON File Iteration> 占位符，包含来自控制表的变量。
      • 表格 ID：<JSON File Iteration>
        • 按照之前的步骤操作，但使用 TableID 代替 FileName。
      • 表格 ID：<JSON File Iteration>
        • 按照之前的步骤操作，但使用 SpreadsheetID 代替 FileName。
      • 文件位置：<JSON File Iteration>
        • 按照之前的步骤操作，但使用 FileLocation 代替 FileName。
• 保存命令

注： 按照概述的步骤从控制表中提取任何标题并检索相应的行值。

步骤 6：测试练习

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

• 发布 链
• 点击 执行 ，然后选择 运行链
• 链式操作完成后，单击 “捕获控制表值 ”命令以验证是否成功。
  • 请在点击命令前，等待连锁反应完全完成。
• 会有一个字段显示 值 1
  • 单击此字段，将显示命令处理了三个不同的值，这些值是控制表中的三行数据。
• 单击每个值的 日志 字段，并验证其是否与控制表中的值匹配。

值 1：

值 2：

值 3：

要了解有关使用控制表的更多信息，请完成以下路径： 在控制表中运行流程和记录结果！