CLP - 控制表中的故障日志记录 – 支持中心

如果链条失效会发生什么？最终用户必须充分了解可能出现的结果。在这个互联学习路径中，我们将通过添加额外的分支来增强我们的主要链，这些分支会将信息反馈到我们的控制表中，具体指出任何故障。扩展后的链将提供额外的透明度，使用户能够轻松识别命令的最后一次成功执行日期。此外，它还能清晰地显示该链条是否运行成功或遇到任何问题。这项改进确保用户能够充分掌握必要的信息，以便及时监控和解决任何潜在故障。

主要业务用例	从集中位置协调报告工作流程向最终用户提供工作流程状态方面的信息
主要学习目标	了解如何在链条控制表中添加故障跟踪功能学习链式分支学习命令复制
先决条件	完成 CLP \| 运行流程和记录结果到控制表中
支持模板	CLP \| 控制表中的故障日志记录

步骤 1：编辑现有链

导航至“链构建器”，并在“控制表”中找到“链 CLP | 运行过程和记录结果”
点击铅笔按钮编辑链条
点击右上角的 链设置
- 重命名链： CLP | 控制表中的日志故障
拯救链条

步骤 2：为上传数据流程添加失败分支

现在我们将添加用于生成和填充反馈到控制表中的值的命令，以指示上传数据过程失败。第一步是创建包含状态和时间的文件。

将 “创建文件 ”命令从 “文件实用工具连接器 ”添加到链画布
将 运行链 - 上传数据 链事件连接到 创建文件 命令
双击链接以编辑链接条件
- 点击失败选项
  
  选择失败选项后，链接将变为红色，表示仅当“运行链 - 上传数据”链事件失败时，链才会继续执行此分支
双击 创建文件 命令进行配置
- 命令名称： 填充数据上传失败及时间戳
- 在方括号文本字段中，输入以下信息：

数据上传失败，（*<System.DateTime> *)

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

步骤 3：将数据上传失败信息写入控制表

现在我们将使用“写入工作表数据”命令将上一个命令中填充的信息写回控制表。这将使我们的最终用户能够看到数据上传失败的情况以及失败日期。

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

保存命令

步骤 4：为刷新连接过程添加失败分支

现在我们将添加用于生成和填充反馈到控制表中的值的命令，以指示刷新连接过程失败。这次，我们将复制我们已经创建的两个命令，以简化流程。

点击 填充数据上传失败和时间戳 命令，然后点击复制按钮
将 运行链 - 刷新连接 链事件连接到刚刚复制的 填充数据上传失败和时间戳 - 复制 命令
双击链接以编辑链接条件
- 点击失败选项
双击 填充数据上传失败和时间戳 - 复制命令进行配置
- 命令名称： 填充刷新连接失败和时间戳
- 在文本字段中，更新以下信息：
```
刷新连接失败,(*<System.DateTime> *)
```
  - 您会注意到系统日期和时间变量无需更新或添加。
保存命令

步骤 5：将“刷新连接失败”写入控制表

现在我们将使用“写入工作表数据”命令将上一个命令中填充的信息写回控制表。这将使我们的最终用户能够看到刷新连接失败的情况以及失败日期。为了节省时间，我们将再次复制之前创建的命令。

点击 写入表格数据 - 数据上传失败命令，然后点击复制按钮
将 Populate Refresh Connection Failure & Time Stamp 命令连接到刚刚复制的 Write Sheet Data - Data Upload Failure- Copy 命令。
双击链接以编辑链接条件
- 点击失败选项
双击 写入工作表数据 - 数据上传失败 - 复制命令进行配置
- 命令名称：写入工作表数据 - 刷新连接 失败
- 单击“数据文件”字段并删除变量
  - 在 “选择变量 ”面板中，单击向下箭头展开 “填充刷新连接失败和时间戳”。
  - 选择 创建的文件 输出
    - 你会注意到，其他字段都已填充了与“写入工作表数据 - 数据上传失败”命令相同的信息，其他所有内容都将保持不变。
保存命令

步骤 6：测试练习

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

发布链
为了测试我们的新命令，我们将通过编辑控制表来强制造成失败。
- 导航至 Workiva 平台中的CLP 控制表 电子表格
- 删除其中一行中的 TableID 值
- 删除另一行中的 SpreadsheetID 值
返回到 CLP | 控制表 链中的故障日志记录，然后单击执行。选择 运行链
流程链完成后，请通过检查以下内容来验证工作流程是否已完成：