创建应用程序任务

使用 Action 应用、任务属性、优先级、标签和可选的可操作通知，在 Action Center 中创建应用程序任务。

备注：

功能可用性取决于您使用的云平台。有关更多详细信息，请查看Action Center 功能可用性。

UiPath.Persistence.Activities.UserAction.CreateUserAction

描述

在 Action Center 中创建应用程序任务。 操作属性是通过在应用程序中添加定义输入字段的“操作”控件来创建的，而 Apps 则提供了用于在 Action Center 中呈现任务的可视界面。

备注：

应用程序任务在 Studio 2022.10 或更高版本中可用。

备注：

您选择的“操作”应用可以是在 UiPath App Studio 或 Studio Web 中使用应用程序设计器构建的应用程序，也可以是在您选择的 IDE 中构建为代码的编码 Action App 。

项目兼容性

Windows | 跨平台

Windows 配置

设计器面板

• 标题- 要创建的操作的标题。此字段仅支持字符串和String变量。
• “优先级” - 输入操作的优先级作为UiPath.Persistence.Activities.Model.Task.TaskPriority类型的参数。使用TaskPriority Enum值设置参数的“默认值”参数。提供以下选项： TaskPriority.Low 、 TaskPriority.Medium 、 TaskPriority.High 、 TaskPriority.Critical 。
• Apps - 选择您在使用 Studio 时在组织和租户的 Apps 实例中创建并部署的 Action 应用。选择操作应用程序后，操作属性将作为活动的属性进行访问。为每个字段相应地创建变量和输入变量。如果更新操作应用程序，则“操作定义名称”字段旁边会显示“刷新”属性，您可使用该属性来用最新更改更新活动。
  备注：

  “应用”下拉列表仅显示已部署或需要执行操作的应用。

• “Orchestrator 文件夹路径” - 要在其中创建任务以及部署相应应用程序的 Orchestrator 文件夹的路径。文件夹路径必须与先前选择的应用程序的部署路径相同。当您从“应用程序”下拉列表中选择一个选项时，系统会自动填充此字段，该选项与部署所选应用程序的文件夹相匹配。填充后，该字段将变为只读字段，并且无法更改。

属性面板

输入

• 任务目录- 任务项目的可选业务分类。此字段仅支持字符串和字符串变量。
  重要提示：

  在创建操作之前，请确保操作目录存在。否则，操作创建将失败，并显示以下错误消息：“不存在名称为 [action_catalog_name] 的任务目录。错误代码：2451。”

• 标签- 机器人将输入的标签添加到操作中，以便于将来进行筛选。该字段仅支持字符串值，并且有命名限制。
  备注：

  要允许通过“暂留”活动标记自动操作，执行工作流的机器人帐户需要对标签 的查看、创建和删除权限 。

其他

• “超时(毫秒)”- 指定最长等待时间（以毫秒为单位），如果超出该时间后活动并未运行，系统便会抛出错误。默认值为 30000 毫秒（30 秒）。

输出

• “任务对象(输出)” - 创建操作后从 Orchestrator 作为UserActionData对象返回的任务对象。可以将此对象传递给“等待应用程序任务然后继续”活动，以便在操作完成之前暂停工作流的执行。

可操作的通知

备注：

目前，Outlook 是唯一支持可操作通知的通知渠道。

先决条件：为使可操作通知按预期工作，您需要：

• 在与 Studio 自动化链接的租户中的 Integration Service 中启用Microsoft Outlook 365 连接。
• 验证分配给可操作通知的用户是否订阅了已分配操作的通知事件。

如果您希望任务受分配人收到可操作的通知，而不是普通电子邮件，请从活动属性面板中启用可操作通知。

要启用可操作通知，请执行以下步骤：

1. 在活动“属性”面板中，选择“显示其他选项” 。

2. 展开“可操作” 通知，然后通过切换按钮启用该选项。

3. 选择可操作通知的所需渠道。

4. 如有必要，通过添加新的“任务”字段或“可操作”按钮来配置通知内容。

   

Task timer

Set a service-level agreement (SLA) timer for the task in the Task timer section of the properties panel. A timer applies when Timer Duration has a value.

备注：

Studio Web 和 Studio STS 26.0.188 版本或更高版本提供配置任务计时器的功能。

• 启动条件- 启动计时器的事件：已创建的任务或已分配的任务。
• End criteria - The event that stops the timer: Task assigned or Task completed. New activities default to Task completed. Timers that end on Task assigned are not displayed in Action Center. They continue to run, and the configured outcome still triggers when they expire.
• Timer Duration - The timer duration, in the 0d 00h 00m format. This field also supports expressions. An empty duration means that no timer is set.
• Outcome - The action triggered when the timer elapses: Alert Assignee, Reassign, Unassign, or Auto Complete. A task carries no timer after it is reassigned, unassigned, or automatically completed.
• Assignment criteria on breach - How the task is assigned when the Outcome is Reassign: User (the default), All users in the group, Workload based, or Round robin.
• Reassign to user - The user that the task is reassigned to, when the Assignment criteria on breach is User. Search for a user, or provide a value or a variable.
• Reassign to group - The group that the task is reassigned to. This field is displayed when the Assignment criteria on breach is any option other than User, and it cannot be empty.

跨平台配置

设计器面板

• 标题- 要创建的操作的标题。此字段仅支持字符串和String变量。
• “优先级” - 输入操作的优先级作为UiPath.Persistence.Activities.Model.Task.TaskPriority类型的参数。使用TaskPriority Enum值设置参数的“默认值”参数。提供以下选项： TaskPriority.Low 、 TaskPriority.Medium 、 TaskPriority.High 、 TaskPriority.Critical 。
• Apps - 在使用 Studio 时，选择您在组织和租户的 Apps 实例中创建并部署的 Action 应用。选择操作应用程序后，操作属性将作为活动的属性进行访问。为每个字段相应地创建变量并输入值。如果更新操作应用程序，则“操作定义名称”字段旁边会显示“刷新”属性，您可使用该属性来用最新更改更新活动。
  • 如果您的活动是 Studio Web 中解决方案的一部分，请选择“+资源”以访问自动生成的 Action 应用。在这里，您可以建立 Action 架构并配置应用程序。
    备注：

    “应用程序”下拉列表仅显示已部署或需要执行操作的应用程序。但是，对于属于 Studio Web 中解决方案的工作流， “应用程序”下拉列表还会显示该解决方案中的本地操作应用程序，即使尚未部署这些应用程序。

• “Orchestrator 文件夹路径” - 要在其中创建任务以及部署相应应用程序的 Orchestrator 文件夹的路径。文件夹路径必须与先前选择的应用程序的部署路径相同。当您从“应用程序”下拉列表中选择一个选项时，系统会自动填充此字段，该选项与部署所选应用程序的文件夹相匹配。填充后，该字段将变为只读字段，并且无法更改。

属性面板

输入

• 任务目录- 任务项目的可选业务分类。此字段仅支持字符串和字符串变量。
  重要提示：

  在创建操作之前，请确保操作目录存在。否则，操作创建将失败，并显示以下错误消息：“不存在名称为 [action_catalog_name] 的任务目录。错误代码：2451。”

• 标签- 机器人将输入的标签添加到操作中，以便于将来进行筛选。该字段仅支持字符串值，并且有命名限制。
  备注：

  要允许通过“暂留”活动标记自动操作，执行工作流的机器人帐户需要对标签 的查看、创建和删除权限 。

其他

• “超时(毫秒)”- 指定最长等待时间（以毫秒为单位），如果超出该时间后活动并未运行，系统便会抛出错误。默认值为 30000 毫秒（30 秒）。

输出

• “任务对象(输出)” - 创建操作后从 Orchestrator 作为UserActionData对象返回的任务对象。可以将此对象传递给“等待应用程序任务然后继续”活动，以便在操作完成之前暂停工作流的执行。

可操作的通知

备注：

目前，Outlook 是唯一支持可操作通知的通知渠道。

先决条件：为使可操作通知按预期工作，您需要：

• 在与 Studio 自动化链接的租户中的 Integration Service 中启用Microsoft Outlook 365 连接。
• 验证分配给可操作通知的用户是否订阅了已分配操作的通知事件。

如果您希望任务受分配人收到可操作的通知，而不是普通电子邮件，请从活动属性面板中启用可操作通知。

要启用可操作通知，请执行以下步骤：

1. 在活动“属性”面板中，选择“显示其他选项” 。

2. 展开“可操作” 通知，然后通过切换按钮启用该选项。

3. 选择可操作通知的所需渠道。

4. 如有必要，通过添加新的“任务”字段或“可操作”按钮来配置通知内容。

   

Task timer

Set a service-level agreement (SLA) timer for the task in the Task timer section of the properties panel. A timer applies when Timer Duration has a value.

备注：

Studio Web 和 Studio STS 26.0.188 版本或更高版本提供配置任务计时器的功能。

• 启动条件- 启动计时器的事件：已创建的任务或已分配的任务。
• End criteria - The event that stops the timer: Task assigned or Task completed. New activities default to Task completed. Timers that end on Task assigned are not displayed in Action Center. They continue to run, and the configured outcome still triggers when they expire.
• Timer Duration - The timer duration, in the 0d 00h 00m format. This field also supports expressions. An empty duration means that no timer is set.
• Outcome - The action triggered when the timer elapses: Alert Assignee, Reassign, Unassign, or Auto Complete. A task carries no timer after it is reassigned, unassigned, or automatically completed.
• Assignment criteria on breach - How the task is assigned when the Outcome is Reassign: User (the default), All users in the group, Workload based, or Round robin.
• Reassign to user - The user that the task is reassigned to, when the Assignment criteria on breach is User. Search for a user, or provide a value or a variable.
• Reassign to group - The group that the task is reassigned to. This field is displayed when the Assignment criteria on breach is any option other than User, and it cannot be empty.

已知问题

In Studio Desktop, selecting Clear Value for Timer Duration leaves the previous value visible in the field, although the task runs with no timer attached. This affects Persistence activities V1.12.0. Studio Web is not affected.

To apply a timer again after clearing the value, delete the contents of Timer Duration and enter the duration again.