调用流程

UiPath.Core.Activities.InvokeProcess

描述

执行本地计算机可用的 UiPath 流程。可用于运行本地包，以及Orchestrator 中的流程（若连接可用）。

有关如何查找计算机上可用流程列表的更多信息，请转到此处

“调用流程”活动在同步模式下运行，这意味着父流程在继续之前等待子流程完成。

子流程生成的日志仅包含执行结果和错误，并且会写入与父流程相同的位置，并且可以通过本地日志中的ProcessName字段和 Orchestrator 中的Process列进行区分。

当使用“调用流程”活动时，即使项目包含多个流程，系统也会创建一个用于运行这些流程的单个作业，这与“运行并行流程”活动不同，后者会为项目中的每个流程创建单独的作业。

如果添加了多个流程，则将使用当前文件夹中的活动版本。

备注：

不可序列化的数据类型不能在工作流之间传递 (例如UIBrowser、UIElement 等)。

如果调用了子流程但未找到，则会记录一个错误，其中包含子流程的名称、机器人搜索到的路径以及其他详细信息，例如WindowsIdentity和machineName 。

备注：

使用高于 v20.4 的 UiPath.System.Activities 版本时，“调用流程”支持多个入口点。如果使用此版本创建工作流，然后将 UiPath.System.Activities 包降级到仅支持单个入口点的较旧版本，则工作流中的“调用流程”活动会出现验证错误，必须手动替换才能正常工作。

项目兼容性

Windows - 旧版 | Windows | 跨平台

Windows、跨平台配置

• “Orchestrator 文件夹路径” - 指定流程所在 Orchestrator 文件夹的路径（如果与运行流程的文件夹不同）。此字段仅支持字符串值，并使用/作为分隔符来表示子文件夹。例如“财务/应付账款”。
• 调用方式- 指定是通过 Orchestrator 中配置的流程名称还是通过包名称调用流程。请注意，支持使用包名称，但已弃用。
• 流程名称/包名称- 要调用的流程或包的名称。下拉列表显示已连接的 Orchestrator 文件夹中的可用流程或包。此字段仅支持字符串或字符串变量。要管理可用流程列表，请选择字段右侧的“管理流程” 。
  备注：

  在“流程名称”和“包名称”选项之间切换不会自动更新名称。如果流程名称与包名称不同，请确保进行相应更新。

• 入口点- 如果您的流程有多个入口点，请指定要在流程启动后运行的工作流文件的路径。此路径应相对于根包。默认情况下，此字段留空，并使用在 Orchestrator 中配置的入口点。
• 参数- 默认选项。打开参数字典，在其中查看所调用流程的参数。您还可以通过选择字段右侧的“使用表达式”来定义变量来保存参数字典。这会将“参数”字段转换为“参数”变量。要检索最新的流程参数列表，请选择字段右侧的“刷新参数” 。要打开参数列表并编辑其属性，请选中“参数”字段复选框。
• 参数变量- 通过“参数”字段中的“使用表达式”选项激活。您可以使用预定义的变量，也可以通过使用 VB 表达式或提示 Autopilot 为您生成变量来创建新变量。使用此变量保存所调用工作流的参数字典。通过选择字段右侧的“使用静态名称”，切换回“参数”选项。

其他属性

常见

• 超时（以毫秒为单位） - 指定最长等待时间（以毫秒为单位），如果超出该时间后所调用的工作流未运行，就会引发错误并中止工作流。此字段仅支持TimeSpan变量。默认情况下，此字段为空。
• “出错时继续”- 指定在活动抛出错误时是否应继续自动化操作。该字段仅支持“布尔值”(True 和 False)。默认值为 FALSE。因此，如果该字段为空且活动引发错误，系统将停止执行项目。如果该值设为“True”，则无论出现何种错误，系统都将继续执行项目。
  备注：

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

执行

• “目标会话”- 指定启动子流程的会话:
  • “当前”- 在与父流程相同的会话中打开子流程
  • “流程默认值”- 子流程使用“流程设置”
  • “主要”- 子流程在主会话中启动，无论父流程在何处运行
  • “画中画”- 子流程在画中画会话中启动，无论父流程在何处运行

日志

• “日志条目” - 指定输入调用的资源时要自动记录的信息类型。
• 日志出口- 指定退出调用的资源时要自动记录的信息类型。
• “日志级别” - 指定应用于“日志入口”和“日志出口”生成的消息的日志记录级别。

Windows - 旧版配置

设计器面板

• Package name - The name of the package used to create the process you want to invoke. In Windows - Legacy projects, the robot identifies the process to invoke by its package name.
• Entry point - If your process has multiple entry points, specify the path of the workflow file to run once the process starts. This path should be relative to the root package. By default, this field is left empty and uses the Main.xaml as entry point.
• Edit arguments - Opens the arguments list, where you can see and manage the arguments of the invoked process.

属性面板

常见

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

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

• “显示名称”- 活动的显示名称。
• 超时（以毫秒为单位） - 指定最长等待时间（以毫秒为单位），如果超出该时间后所调用的工作流未运行，就会引发错误并中止工作流。此字段仅支持TimeSpan变量。默认情况下，此字段为空。

输入

• 参数- 输入参数的集合，可传递给要从 Orchestrator 运行的流程。如果参数的类型未知，则系统会将其转换为 JSON。
• “参数变量”- 传递给被调用流程的参数变量。
• 流程名称- 要调用的流程的名称。该字段仅接受字符串值。

日志

• “日志条目” - 指定输入调用的资源时要自动记录的信息类型。
• 日志出口- 指定退出调用的资源时要自动记录的信息类型。
• “日志级别” - 指定应用于“日志入口”和“日志出口”生成的消息的日志记录级别。

其他

• Entry point - If your process has multiple entry points, specify the path of the workflow file to run once the process starts. This path should be relative to the root package. By default, this field is left empty and uses the Main.xaml as entry point.
• “文件夹路径”- 指定流程所在 Orchestrator 文件夹的路径（如果与运行流程的文件夹不同）。此字段仅支持字符串值，并使用 / 作为分隔符来表示子文件夹。例如“财务/应付账款”。
• “私有”- 选中后将不再以“Verbose”级别记录变量和参数的值。
• “目标会话”- 指定启动子流程的会话:
  • “当前”- 在与父流程相同的会话中打开子流程
  • “流程默认值”- 子流程使用“流程设置”
  • “主要”- 子流程在主会话中启动，无论父流程在何处运行
  • “画中画”- 子流程在画中画会话中启动，无论父流程在何处运行
• “使用包”- 指示应通过包名称 (已选择) 还是流程名称 (未选择) 来标识流程。默认情况下，未选择此选项。