获取应用程序任务

UiPath.Persistence.Activities.UserAction.GetAppTasks

描述

检索单个应用程序任务或一组应用程序任务，并按特定条件（即任务的 DTO 属性）进行筛选：

• 状态
• 标题
• ID
• 优先级
• 任务目录名称
• AssignedToUser
• CreatorUser
• LastModifierUser
• 创建时间
• LastModificationTime
• OrganizationUnitID

获取应用程序任务活动的 输出对象可在任何其他持久性活动中使用，例如等待应用程序任务然后继续，以涵盖需要另一个工作流等待任务的场景，与创建这些任务的工作流不同（例如，在当前作业失败时构建恢复工作流）。您还可以将输出对象作为输入传递给其他流程，这样您就无需等待所有任务完成，直到初始流程恢复为止。

备注：

* 根据操作的元数据，使用OData语法筛选和查询操作。

项目兼容性

Windows | 跨平台

Windows 配置

设计器面板

• Task Objects (Output) - The list of output objects that match the criteria set in the activity. The output is returned from Orchestrator as a List<FormTaskData> object. Use this object to create a recovery workflow or to pass it as input to a different process.

属性面板

常见

• “显示名称”- 活动的显示名称。

输入

• “Orchestrator 文件夹路径” - 要用于此活动的 Orchestrator 文件夹的路径。如果留空，则使用当前的 Orchestrator 文件夹。此字段仅支持字符串和字符串变量。
• “引用” - 使用“创建应用程序任务”活动设置的操作引用。
• 任务目录名称- 使用“创建应用程序任务”活动设置的操作的目录名称。

其他

• “出错时继续”- 指定在活动引发错误时是否应继续自动化操作。该字段仅支持“布尔值”（True 和 False）。默认值为 False。因此，如果该字段为空且活动引发错误，系统将停止执行项目。如果该值设为“True”，则无论出现何种错误，系统都将继续执行项目。

备注：

如果“Try Catch 异常处理”中包含该活动且“出错时继续”属性的值为“True”，则系统在执行项目时不会捕获任何错误。

• “私有”- 选中后将不再以“Verbose”级别记录变量和参数的值。
• “超时(毫秒)”- 指定最长等待时间（以毫秒为单位），如果超出该时间后活动并未运行，系统便会抛出错误。默认值为 30000 毫秒（30 秒）。

OData 查询选项

OData 查询选项	描述	字段数据类型	示例
展开	OData expand 选项，用于显示条件的相关实体。	字符串	"AssignedUser"
筛选	OData filter 选项，用于按指定条件筛选检索到的操作。	字符串	Status in ('Pending', 'Unassigned') and Priority eq 'High'
排序依据	OData orderby 选项，用于按指定条件对检索到的操作进行升序 (asc) 或降序 (desc) 排序。	字符串	"Title asc" "ID desc"
选择	OData select 选项，用于检索操作属性的子集。	字符串	"ID, Status, TaskCatalogName"
跳过	OData skip 选项，用于跳过检索多个操作。	Int32	2
顶部	OData top 选项用于设置要检索的记录数，每次限制为 1000 条记录。 如果留空，则检索前 100 条记录。	Int32	20

备注：

还支持“AND” / “OR”运算符。

输出

• Task Objects (Output) - The list of output objects that match the criteria set in the activity. The output is returned from Orchestrator as a List<FormTaskData> object. Use this object to create a recovery workflow or to pass it as input to a different process.

跨平台配置

• Filter - The OData filter option, used to filter the retrieved actions by the specified criteria. This field supports only strings and String variables. For example, Status in ('Pending', 'Unassigned'), and Priority eq 'High'.
• “选择” - OData select选项，用于检索操作属性的子集。需要输入 ID 选项。因此，如果要检索操作目录，则可使用"Id, TaskCatalogName"查询。此字段仅支持字符串和字符串变量。
• “Orchestrator 文件夹路径” - 要用于此活动的 Orchestrator 文件夹的路径。如果留空，则使用当前的 Orchestrator 文件夹。此字段仅支持字符串和字符串变量。
• 任务目录名称- 使用“创建应用程序任务”活动设置的操作的目录名称。
• “引用” - 使用“创建应用程序任务”活动设置的操作引用。
• Task Objects (Output) - The list of output objects that match the criteria set in the activity. The output is returned from Orchestrator as a List<FormTaskData> object. Use this object to create a recovery workflow or to pass it as input to a different process.

高级选项

其他

• “出错时继续”- 指定在活动引发错误时是否应继续自动化操作。该字段仅支持“布尔值”（True 和 False）。默认值为 False。因此，如果该字段为空且活动引发错误，系统将停止执行项目。如果该值设为“True”，则无论出现何种错误，系统都将继续执行项目。

备注：

如果“Try Catch 异常处理”中包含该活动且“出错时继续”属性的值为“True”，则系统在执行项目时不会捕获任何错误。

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

OData 查询选项

OData 查询选项	描述	字段数据类型	示例
展开	OData expand 选项，用于显示条件的相关实体。	字符串	"AssignedUser"
排序依据	OData orderby 选项，用于按指定条件对检索到的操作进行升序 (asc) 或降序 (desc) 排序。	字符串	"Title asc" "ID desc"
跳过	OData skip 选项，用于跳过检索多个操作。	Int32	2
顶部	OData top 选项用于设置要检索的记录数，每次限制为 1000 条记录。 如果留空，则检索前 100 条记录。	Int32	20

OData 查询示例

使用以下示例获取应用程序任务，或作为其他查询的灵感：

1. 获取处于“待处理”状态的高优先级获取应用程序任务的 ID，并按其标题降序排列。
   1. 筛选: "((Priority eq 'High') and (Status eq 'Pending'))"
   2. 排序依据: "Title desc"
   3. 选择： "Id"
2. 获取存储了所有“未分配”且“中等”优先级的“获取应用程序任务”的操作目录，并按标题升序对它们进行排序。
   1. 筛选: "((Priority eq 'Medium') and (Status eq 'Unassigned'))"
   2. 排序依据: "Title asc"
   3. 选择： "Id, TaskCatalogName"