工作流活动

上次更新日期 2025年10月31日

创建外部任务

UiPath.Persistence.Activities.ExternalTask.CreateExternalTask

描述

使用给定的数据、任务标题、任务优先级和任务目录创建外部操作。

项目兼容性

Windows - 旧版 | Windows | 跨平台

Windows、Windows - 旧版配置

设计器面板

“任务标题” - 要创建的操作的标题。此字段仅支持字符串和 String 变量。
“任务优先级” - 用于选择操作的优先级。默认情况下，此属性设置为 TaskPriority.Medium 提供以下选项： TaskPriority.Low、 TaskPriority.Medium、 TaskPriority.High、 TaskPriority.Critical。
TaskCatalog - 任务项目的可选业务分类。此字段仅支持字符串和 String 变量。
“任务 数据” - 要存储在给定操作中的业务数据集合，格式为 Dictionary<String,Argument>。完成操作后，修改 Out 和 In/Out 参数会将其映射回工作流。此字段仅支持 Dictionary<String,Argument> 对象。
任务对象（输出） - 创建 Actions 后从 Orchestrator 作为 ExternalTaskData 对象返回的任务对象。可以将此对象传递给“ 等待外部任务然后继续 ”活动，以便在 Actions 完成之前暂停工作流的执行。

属性面板

常见

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

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

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

输入

“外部标签 ” - 此标签可用于标识作为给定操作中数据来源的外部系统。此字段仅支持字符串和 String 变量。
标签 - 机器人将输入的标签添加到操作中，以允许将来进行筛选。此字段仅支持字符串值，并且具有命名限制。

注意：要允许通过“持久性”活动自动标记操作，执行工作流的机器人帐户需要对标签具有 “查看”、“ 创建”和“ 删除 ”权限。

“Orchestrator 文件夹路径 ” - Orchestrator 文件夹的路径，该文件夹与要在其中创建任务的当前流程所在的文件夹不同。要阅读有关 Orchestrator 文件夹的更多信息，请转到此处。对于传统文件夹，只有当当前用户在目标文件夹中具有正确的任务权限时，此属性才能与 浮动机器人 一起使用。对于新式文件夹， 不支持覆盖文件夹路径。此字段仅支持字符串和 String 变量。

注意： 仅当必须从与当前文件夹不同的文件夹创建或查询任务时，才 必须使用“文件夹路径”属性。如果执行此操作的用户不具备目标文件夹的所需权限，则任务创建将失败并引发严重错误。您可以在此处查看有关文件夹权限的更多信息。

TaskCatalog - 任务项目的可选业务分类。此字段仅支持字符串和 String 变量。

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

“任务 数据” - 要存储在给定操作中的业务数据集合，格式为 Dictionary<String,Argument>。完成操作后，修改 Out 和 In/Out 参数会将其映射回工作流。此字段仅支持 Dictionary<String,Argument> 对象。
“任务优先级” - 用于选择操作的优先级。默认情况下，此属性设置为 TaskPriority.Medium 提供以下选项： TaskPriority.Low、 TaskPriority.Medium、 TaskPriority.High、 TaskPriority.Critical。
“任务标题” - 要创建的操作的标题。此字段仅支持字符串和 String 变量。

其他

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

输出

任务对象（输出） - 创建 Actions 后从 Orchestrator 作为 ExternalTaskData 对象返回的任务对象。可以将此对象传递给“ 等待外部任务然后继续 ”活动，以便在 Actions 完成之前暂停工作流的执行。

跨平台配置

“任务标题” - 要创建的操作的标题。此字段仅支持字符串和 String 变量。
“任务优先级” - 用于选择操作的优先级。默认情况下，此属性设置为 TaskPriority.Medium 提供以下选项： TaskPriority.Low、 TaskPriority.Medium、 TaskPriority.High、 TaskPriority.Critical。
TaskCatalog - 任务项目的可选业务分类。此字段仅支持字符串和 String 变量。

“任务 数据” - 要存储在给定操作中的业务数据集合，格式为 Dictionary<String,Argument>。完成操作后，修改 Out 和 In/Out 参数会将其映射回工作流。此字段仅支持 Dictionary<String,Argument> 对象。
任务对象（输出） - 创建 Actions 后从 Orchestrator 作为 ExternalTaskData 对象返回的任务对象。可以将此对象传递给“ 等待外部任务然后继续 ”活动，以便在 Actions 完成之前暂停工作流的执行。

高级选项

常见

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

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

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

输入

标签 - 机器人将输入的标签添加到操作中，以允许将来进行筛选。此字段仅支持字符串值，并且具有命名限制。

注意：要允许通过“持久性”活动自动标记操作，执行工作流的机器人帐户需要对标签具有 “查看”、“ 创建”和“ 删除 ”权限。

“Orchestrator 文件夹路径 ” - Orchestrator 文件夹的路径，该文件夹与要在其中创建任务的当前流程所在的文件夹不同。要阅读有关 Orchestrator 文件夹的更多信息，请转到此处。对于传统文件夹，只有当当前用户在目标文件夹中具有正确的任务权限时，此属性才能与 浮动机器人 一起使用。对于新式文件夹， 不支持覆盖文件夹路径。此字段仅支持字符串和 String 变量。

“引用 ” - 一个标签，可用于标识作为给定操作中数据来源的外部系统。此字段仅支持字符串和 String 变量。

创建外部操作

要创建外部操作，请在以下过程中选择：

将“ 创建外部任务” 活动添加到您的工作流中，并提供以下属性字段的信息：
- 任务标题
- 任务优先级
- 任务数据 (集合)
- “外部标签 ” - 指定一个标签，以唯一标识要从第三方系统检索的外部任务批次。您可以使用此标签将外部任务与外部系统同步。此外，您可以使用此标签根据用户在第三方系统中执行的操作完成任务。
使用 API创建外部 Actions 。

将外部操作与第三方工具同步

要将外部操作与其他外部系统同步，您需要首先在外部系统内为其创建相应的对象，然后使用 API 调用检索第三方系统创建的任务或任务批次。

在外部系统内创建对象，例如：
- 在 Jira 中创建问题。
- 在 Salesforce 中创建联系人。
在 Swagger 中调用以下 API： GET /odata/Tasks/UiPath.Server.Configuration.OData.GetTasksAcrossFolders。

例如： GET <ORCH_URL>/odata/Tasks/UiPath.Server.Configuration.OData.GetTasksAcrossFolders?$filter=(Type eq 'ExternalTask') and (IsDeleted eq false) and (ExternalTag eq 'JiraTasks') and (Status ne 'Completed')&$count=true。