CLP - 在控制表中运行流程并记录结果 – 支持中心

现在是时候将所有内容整合到一个集中式报告工作流中了，我们将使用单个链来处理新数据并刷新依赖于该数据的连接。在本关联学习路径中，我们将使用控制表中的变量来运行工作流，这些工作流会准备我们的数据，同时使用状态更新控制表，从而为业务用户提供更多关于工作流最近完成时间的可见性。

主要业务用例	从集中位置协调报告工作流程简化最终用户的工作流程管理向最终用户提供有关工作流程完成情况的见解
主要学习目标	了解如何使用控制表中的值运行类似流程使用链式命令向控制表添加日志记录。
先决条件	完成 CLP \| 使用来自控制表路径的值配置以下连接器： - 文件实用工具 - 表格变换
支持模板	CLP \| 在控制表中运行流程并记录结果

步骤 1：更新控制表以包含日志记录

为了通知最终用户控制表运行的流程的状态和最新更新，我们需要一个地方来存储工作流运行时间和工作流状态的详细信息。我们将把这些信息保存在控制表中。

从 Workiva 平台，导航至 CLP 控制表 电子表格
在 FileLocation 列之后添加两列，列标题如下：
- 状态
- 时间戳
请勿在这些列标题下方添加任何值。

步骤 2：编辑现有链

导航至链式构建器并找到链式 CLP | 使用控制表中的值
点击铅笔按钮编辑链条
点击右上角的 链设置
- 重命名链： CLP | 在控制表中运行流程并记录结果
- 在“链式变量”下，单击两次加号 (+) 创建两个链式变量，并按如下方式配置它们：
  - 类型：链式变量（CV）
    - 姓名： 简历状态栏字母
    - 值：创建 “状态 ”标题的列字母。
      - 在提供的示例中，值为 F
  - 类型：链式变量（CV）
    - 名称： 简历时间戳列字母
    - 值：创建 时间戳 标题的列字母
      - 在提供的示例中，值为 G
- 现在该链应该有四个链变量。
拯救链条

步骤 3：添加行号命令

我们将使用 添加行号 命令自动向控制表添加行号。这将使我们能够确定日志记录应该在控制表中的哪个位置进行。

双击 “获取工作表数据 ”命令和 “将控制工作表转换为 JSON ”命令之间的链接
- 点击删除按钮断开链接
从 “表格变换 ”连接器向“链”画布添加 “添加行号 ”命令
将 “获取工作表数据 ”命令连接到 “添加行号 ”命令
将 “添加行号 ”命令连接到 “将控制表转换为 JSON ”命令
。
双击“ 添加行号 ”命令进行配置
- 点击 输入文件 字段
  - 在 “选择变量 ”面板中，单击向下箭头展开 “获取工作表数据”。
  - 从 “获取工作表数据 ”命令中选择 “数据 ”输出
保存命令

现在我们已经向数据集中添加了行号，我们需要更新后续命令以使用转换后的数据。在这种情况下，需要更新 CSV 转 JSON 命令。
- 双击“ 将控制表转换为 JSON 命令”进行更新
  - 单击 “输入文件 ”字段， 然后删除 “获取工作表数据输出”。
    - 在 “选择变量 ”面板中，单击向下箭头展开 “添加行号”。
    - 从 “添加行号 ”命令中选择 “添加行号”输出。
- 保存命令

步骤 4：运行流程将数据上传到 Wdata

现在我们将使用控制表中的变量来运行一个将数据上传到 Wdata 表的过程。我们将使用运行链事件来启动从上传数据到表路径的Wdata 链上传数据。

既然我们已经能够使用 Handlebars 将控制表中的变量可视化，我们就不再需要 Handlebars 命令了。
- 将鼠标悬停在 Handlebars 命令上，然后单击垃圾桶图标删除
  - 点击删除确认删除命令。
向链画布添加 运行链 事件
将 活动标志 条件命令连接到 运行链 事件
双击命令进行配置
- 命令名称： 运行链 - 将数据上传到 Wdata
- 点击 链下拉菜单 并选择链 CLP | 上传数据到表格
- 使用控制表中的变量配置运行时输入：
  - 单击 表 ID字段
    - 在 “选择变量 ”面板中，单击向下箭头展开 “分组迭代器”。
    - 选择 <> JSON 文件迭代
    - 点击绿色的 JSON 文件迭代 图标来转换变量
      - 单击“选择转换”，然后选择 从 JSON 获取值
      - 按下绿色的 + 符号
      - 在值字段中输入 TableID ，确保与控制表中的格式完全一致，然后按回车键。
      - 点击接受

- - 单击 “文件名”字段
    - 按照上述步骤，使用控制表中的变量，但使用 FileName 字段代替 TableID。
  - 单击 “文件位置 ”字段
    - 按照上述步骤，使用控制表中的变量，但使用 FileLocation 字段代替 TableID。
保存命令

步骤 5：运行进程以刷新连接

接下来，我们将使用控制表中的变量来运行一个流程，该流程会刷新报告电子表格中的数据，使最终用户能够访问新上传的数据。我们将使用运行链事件来启动从刷新连接列表路径开始的刷新连接列表链。

向链画布添加 运行链 事件
将 运行链 - 将数据上传到 Wdata 链事件连接到 运行链 事件
双击命令进行配置
- 命令名称： 运行链 - 刷新连接
- 点击 链下拉菜单 并选择链 CLP | 刷新连接列表
- 使用控制表中的变量配置运行时输入：
  - 点击 电子表格 ID字段
    - 在 “选择变量 ”面板中，单击向下箭头展开 “分组迭代器”。
    - 选择 <> JSON 文件迭代
    - 点击绿色的 JSON 文件迭代 图标来转换变量
      - 单击“选择转换”，然后选择 从 JSON 获取值
      - 按下绿色的 + 符号
      - 在值字段中输入 SpreadsheetID ，确保与控制表中的格式完全一致，然后按 Enter 键。
      - 点击接受

保存命令

步骤 6：填充状态和时间戳命令

现在我们将添加用于生成和填充值（这些值将反馈到控制表中）的命令，以表明工作流程已成功完成。实现这一目标的第一步是创建包含状态和时间的文件。

将 “创建文件 ”命令从 “文件实用工具连接器 ”添加到链画布
将 运行链 - 刷新连接 链事件连接到 创建文件 命令
双击命令进行配置
- 命令名称： 填充状态和时间戳
- 在方括号文本字段中，输入以下信息：

数据上传和刷新完成，（*<System.DateTime> *)

- - 将 (*System.DateTime*) 占位符替换为相应的运行时变量，这将以编程方式从 Chains 中提取日期和时间。
    - 从左侧的 “选择变量 ”面板中，展开“运行时”。
    - 选择 System.DateTime 值
保存命令

步骤 7：写回控制表

现在我们将使用“写入工作表数据”命令将上一个命令中填充的信息写回控制表。这将使我们的最终用户能够了解该过程，显示数据加载和刷新的状态以及更新日期。

从 Workiva连接器向链 画布添加 “写入工作表数据 ”命令
将 “填充状态和时间戳 ”命令链接到 “写入工作表数据”命令
双击命令进行配置
- 点击电子表格 ID 字段
  - 在“选择变量”面板中，单击向下箭头展开链
  - 选择 cv-Control 电子表格 ID 链变量
- 单击“工作表 ID/名称”字段
  - 在“选择变量”面板中，单击向下箭头展开链
  - 选择 cv-控制表名称链变量
- 点击“数据文件”字段
  - 在 “选择变量 ”面板中，单击向下箭头展开 “填充状态和时间戳”。
  - 选择 创建的文件 输出
- “区域”字段将填充链变量和 JSON 输出的组合，以告知链在当前迭代中要写入控制表中的特定单元格：
  - 点击区域字段，并填写以下内容：
  - cv-状态列字母 - 位于变量面板的“链式变量”下找到的变量
  - JSON 文件迭代 - 我们使用迭代的行号加 1 来指定要写入数据的区域，加 1 是为了包含标题行。
    - 在“选择变量”面板中，单击向下箭头展开 组迭代器
    - 选择 <> JSON 文件迭代
    - 点击绿色的 JSON 文件迭代 图标来转换变量
      - 单击“选择转换”，然后选择 从 JSON 获取值
      - 按下绿色的 + 符号
      - 在值字段中输入行号并按 Enter 键
      - 选择其他转换并选择 解析号
      - 点击绿色的 + 符号
      - 选择另一个变换并选择添加
      - 点击绿色的 + 符号
      - 在值字段中输入 1
      - 点击接受
  - 在第一个 JSON 文件迭代 :后输入冒号
  - cv-时间戳列字母 - 位于 “变量”面板“链式变量 ”下的变量
  - JSON 文件迭代 - 我们使用迭代的行号加 1 来指定要写入数据的区域，加 1 是为了包含标题行。
    - 对第二个 JSON 文件迭代执行与上述相同的步骤。