获取表单任务

UiPath.Persistence.Activities.FormTask.GetFormTasks

描述

帮助您查询按特定条件（即操作的 DTO 属性）筛选的单个操作或一组操作：

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

“获取表单任务” 活动的 输出对象可用于任何其他暂留活动（例如“等待表单任务然后继续”） ，以涵盖需要另一个工作流等待操作的场景，该工作流与创建这些操作的工作流不同（例如，在当前作业失败时构建恢复工作流）。您还可以将输出对象作为输入传递给其他流程，这样就无需等待所有操作完成就可以在初始流程恢复之前完成。

备注：

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

项目兼容性

Windows - 旧版 | Windows | 跨平台

Windows、Windows - 旧版配置

设计器面板

• 任务目录名称- 使用创建表单任务活动设置的操作目录名称。
• “引用” - 使用“创建表单任务”活动设置的操作引用。
• 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"查询。此字段仅支持字符串和字符串变量。
• 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 秒）。

输入

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

其他

• “私有”- 选中后将不再以“Verbose”级别记录变量和参数的值。

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"查询。此字段仅支持字符串和字符串变量。
• 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 秒）。

输入

• “Orchestrator 文件夹路径” - 要用于此活动的 Orchestrator 文件夹的路径。如果留空，则使用当前的 Orchestrator 文件夹。此字段仅支持字符串和字符串变量。

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. 获取存储所有“ 未分配”和“ 中”优先级的表单任务的“ Actions 目录”，并按标题升序对这些任务进行排序。
   1. 筛选: "((Priority eq 'Medium') and (Status eq 'Unassigned'))"
   2. 排序依据: "Title asc"
   3. 选择： "Id, TaskCatalogName"