获取应用程序任务

UiPath.Persistence.Activities.UserAction.GetAppTasks

描述

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

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

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

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

项目兼容性

Windows | 跨平台

Windows 配置

设计器面板

• “任务对象（输出） ” - 与活动中设置的条件匹配的输出对象列表。 输出作为 List<FormTaskData> 对象从 Orchestrator 返回。 使用此对象可以创建恢复工作流，或将其作为输入传递给其他流程。

属性面板

常见

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

输入

• “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

备注： 还支持“与” /“或”运算符。

输出

• “任务对象（输出） ” - 与活动中设置的条件匹配的输出对象列表。 输出作为 List<FormTaskData> 对象从 Orchestrator 返回。 使用此对象可以创建恢复工作流，或将其作为输入传递给其他流程。

跨平台配置

• 筛选 - OData filter 选项，用于按指定条件筛选检索到的操作。 此字段仅支持字符串和字符串变量。 例如 Status in ('Pending', 'Unassigned'), and Priority eq 'High'。
• 选择 - OData select 选项，用于检索 Actions属性的子集。 您需要输入“ID”选项。 因此，如果要检索 Actions 目录，则应使用 "Id, TaskCatalogName"查询。 此字段仅支持字符串和字符串变量。
• “Orchestrator 文件夹路径 ” - 要用于此活动的 Orchestrator 文件夹的路径。 如果留空，则使用当前的 Orchestrator 文件夹。 此字段仅支持字符串和字符串变量。
• 任务目录名称- 使用创建应用程序任务活动设置的操作目录名称。
• “引用”- 使用“创建应用程序任务”活动设置的操作引用。
• “任务对象（输出） ” - 与活动中设置的条件匹配的输出对象列表。 输出作为 List<FormTaskData> 对象从 Orchestrator 返回。 使用此对象可以创建恢复工作流，或将其作为输入传递给其他流程。

高级选项

其他

• “出错时继续”- 指定在活动引发错误时是否应继续自动化操作。该字段仅支持“布尔值”(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"