使用更新工作项 action

更新工作项 action 提供了灵活性，作为自动化执行的一部分，您可以根据队列名称和工作项 ID 更新工作项。

先决条件

  • 确保您已将工作项添加到队列，以便系统为该工作项生成 ID。 有关更多信息，请参阅 管理 Work Items。
  • 使用 bot 兼容版本 7 在 Record 属性值中使用变量表达式。 有关更多详情，请参阅 可用的兼容性版本。

注意事项

有关更新工作项 action 的使用，请查看以下注意事项：
  • 使用以下一个选项运行自动化：
    • 立即运行
    • 计划
    • 使用事件触发器运行
    注： 要更新工作项，Bot Runner 用户必须关联一个角色，该角色可以是队列所有者或参与者。
  • 使用更新工作项 action，通过从多个队列添加工作项来管理自动化中的复杂工作流。
  • 如果以下字段未正确更新，运行时将会显示错误，自动化将失败：
    • 在队列名称字段中输入了不正确的名称。
    • 对于记录选项卡：
      • 列的顺序不正确。

        例如，如果工作项结构是 ColumnA、ColumnB 和 ColumnC。 如果您在 记录选项卡中输入的列顺序为 ColumnA、ColumnC 和 ColumnB，自动化将失败。

      • 列的数据类型不正确。

        例如，如果工作项结构包含的数据类型为字符串；但输入记录结构为数字。

      • 如果记录结构中有列缺失。

        例如，如果工作项有 3 列，而您删除了其中一列。 但是，输入记录设置为 3 列。

      • 日期时间值未设置为未来的日期和时间。
        例如，如果系统日期和时间是 2024 年 5 月 10 日 14:00，请确保将日期时间设置为未来的日期和时间值。
        注： 当您将工作项暂停时，日期时间值未设置为未来的日期和时间。

要更新工作项，

过程

  1. 转到自动化页面，单击创建图标或单击现有的 Task Bot 以打开编辑器屏幕。
  2. 在操作面板中，双击或拖动 Workload 中可用的更新工作项 action。
  3. 在队列名称字段中，输入要更新工作项的队列名称。
    注： 确保您输入正确的名称，因为如果指定的队列不存在，在自动化运行时会显示错误。
    （可选）单击插入值图标，选择一个您可能用来存储队列名称的现有变量。
  4. 在工作项 ID字段中，输入要更新的工作项的 ID。
    (可选）单击插入值图标，选择一个您可能用来存储工作项 ID 值的现有变量。
  5. 使用工作项值字段选择以下一个选项：
    • 记录
      单击添加按钮，以添加一个记录并更新以下条目：
      • 索引： 自动生成字段，无法手动编辑。 但是，如果您已添加多个记录，将启用向上移动和向下移动箭头。 索引 字段中的值会根据您移动记录的位置发生变化。
      • 名称： 输入您正在添加的列的名称。
      • 类型： 单击下拉菜单以选择列的类型。
        注： 仅支持字符串、数字和日期时间作为工作项
      • 值： 根据您选择的类型输入该列的值。
      注： 确保您添加的记录与工作项结构具有相同数量的列。 例如，列的数量、名称和类型及其值。
    • Variable

      输入记录变量名称，或单击插入值图标，以选择包含更新工作项值的现有记录变量。

  6. 单击获取结构按钮。

    当您单击此按钮时，将显示整个工作项结构、密钥、类型和用于添加值的文本框。 工作项值中的预填充条目显示了与工作项结构对应的字段。 可以输入绝对值或插入变量以获取属性值。

    注：
    • 获取结构按钮仅在您没有手动添加任何属性时在记录选项中可用。 但是，如果您手动添加了属性，请单击获取结构按钮，以清除手动输入并加载名称、数据类型和空值等结构。 在获取工作项结构后，您可以添加或删除面板。
    • 确保不要添加队列名称的变量。
  7. 单击状态下拉菜单，以选择以下一个选项：
    • 重新处理（新）： 选择此选项，将选定的工作项重新处理为新工作项。
    • 搁置： 选择此选项，以暂停或搁置选定的工作项。 您可以进一步使用以下一个选项卡细化搁置状态：
      • 无限期搁置： 如果您想要在将来的某一天手动更改状态，请选择此选项。
      • 搁置截至日期： 选择此选项，以根据以下情况设置搁置状态：
        • 日期时间： 选择日期、时间和时区。
          注： EST、HST 或 MST 时区已被弃用。
        • 变量： 输入变量或单击 插入值图标，以选择现有变量。
  8. 单击保存。
    选定的工作项已根据您选择的设置进行更新。