获取表单任务

UiPath.Persistence.Activities.FormTask.GetFormTasks

描述

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

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

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

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

项目兼容性

Windows - 旧版 | Windows | 跨平台

Windows、Windows - 旧版配置

设计器面板

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

属性面板

常见

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

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

• “显示名称”- 活动的显示名称。
• “超时 (毫秒)”- 指定等待时间（以毫秒为单位），如果超出该时间活动未运行，就会引发错误。默认值为 30000 毫秒（30 秒）。

输入

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

其他

• “私有”- 选中后将不再以“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运算符。

输出

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

跨平台配置

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

高级选项

常见

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