调用工作流文件

UiPath.Core.Activities.InvokeWorkflowFile

描述

同步调用指定的工作流，可选择向其传递一个输入参数列表。

备注：

• 如果参数共享相同的名称和数据类型，则从工作流导入参数会使其与现有变量自动匹配。
• 不可序列化的数据类型不能在工作流之间传递 (例如UIBrowser、UIElement 等)。
• 限制 PowerShell 访问的防病毒策略可能会阻止使用 PowerShell 相关活动。例如，在迈克菲端点安全中启用规则 ID 6151 时，您不能使用“调用工作流文件”和“调用 Power Shell”。
• 运行添加自定义日志字段的已调用工作流后，日志字段将还原到父工作流的配置。

重要提示：

• 向非隔离的“调用工作流文件”活动传递输入参数就像传递了引用一样，这意味着对调用的工作流中的对象进行的任何更改都会更改主工作流中的对象。
• Windows 和跨平台项目中的工作流文件名不支持变量和参数。无视此通知将触发“当前不支持表达式”错误通知。
• 调用工作流时，请确保其不包含持久性活动。这些应仅在主工作流中使用。
• 调用触发器工作流（即以触发器活动开始的工作流）可能会导致意外自动导入参数。

可以使用活动主体中的“打开工作流”按钮，在当前项目中打开“工作流文件名称”属性中引用的工作流。

备注：

对于标题中包含点 (.) 的所有“.xaml”调用文件，其在点（包括点）之前的所有文本均已由下划线 (_) 替换。

项目兼容性

Windows - 旧版 | Windows | 跨平台

Windows、跨平台配置

• 工作流文件名- 要调用的 .xaml 文件的要调用的文件。文件路径相对于当前项目文件夹。该字段仅支持字符串和字符串变量。Windows 和跨平台项目不支持字符串变量。必须为所有字符串加上引号。要在同一项目的不同选项卡中打开工作流，请在字段右侧选择“打开工作流” 。
• 参数- 默认选项。打开参数字典，您可以在其中查看所调用工作流的参数。您还可以通过选择字段右侧的“使用表达式”来定义变量来保存参数字典。这会将“参数”字段转换为“参数”变量。要检索最新的工作流参数列表，请选择字段右侧的“刷新参数” 。
• 参数变量- 通过“参数”字段中的“使用表达式”选项激活。您可以使用预定义的变量，也可以通过使用 VB 表达式或提示 Autopilot 为您生成变量来创建新变量。使用此变量保存所调用工作流的参数字典。通过选择字段右侧的“使用静态名称”，切换回“参数”选项。要打开参数列表并编辑其属性，请选中“参数”字段复选框。
  备注：

  • 如果“参数”变量的值为 null，则活动将回退到“参数”属性。
  • 在“参数”和“参数变量”属性之间切换会显示上一个值。
  • 关闭“表达式编辑器”后，参数变量的值将丢失。

其他属性

常见

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

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

选项

• 目标会话（仅适用于 Windows 项目）- 指定启动工作流的会话。只有孤立的工作流可以在不同于父工作流的会话中启动，因此请确保将“孤立”属性设置为“True” 。您可以从以下选项中进行选择:
  • “当前”- 在与父流程相同的会话中打开子流程
  • “主要”- 子流程在主会话中启动，无论父流程在何处运行
  • “画中画”- 子流程在画中画会话中启动，无论父流程在何处运行
• “隔离” - 选择“True” ，以在单独的 Windows 进程中运行调用的工作流。这有助于将错误的工作流与主工作流隔离开。默认情况下为False 。

日志

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

  如要设置默认的“日志入口”和“日志出口”值，请转到“UiPath Studio” >“项目设置” >“系统” >“调用工作流文件” 。此处提供的值适用于您的整个项目。

Windows - 旧版配置

设计器面板

您可以在活动主体中找到以下属性：

• 工作流文件名- 要调用的 .xaml 文件的要调用的文件。文件路径相对于当前项目文件夹。该字段仅支持字符串和字符串变量。支持字符串变量。必须为所有字符串加上引号。
• “导入参数” -打开“参数”面板，其中包含“工作流文件名”属性中引用的工作流的所有参数。通过此面板，您可以使用方向控件或删除按钮重新组织参数，以便从调用的工作流中选择要导入的参数。单击确定可保存更改。
  备注：

  • 在该面板中创建参数会使参数遭到丢弃，因为这类参数与所调用工作流中的数据不相匹配。
  • 参数名称在面板中区分大小写。

关闭该面板后，按钮旁边的计数器会显示要导入的已选参数的数量。计数器采用颜色编码，具体如下：

• “橙色”- 表示所选参数与所调用工作流中存在的参数不匹配。
• “灰色”- 表示在调用的工作流中找到所选参数。

• 打开工作流 -用于在同一项目的不同选项卡中打开调用的工作流。

属性面板

常见

• Continue On Error - Specifies if the automation should continue even when the activity throws an error. This field only supports Boolean values (true, false). The default value is false. As a result, if the field is blank and an error is thrown, the execution of the project stops. If the value is set to True, the execution of the project continues regardless of any error.
  备注：

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

• “显示名称”- 活动的显示名称。
• “超时”- 指定最长等待时间，如果超出该时间后活动并未运行，系统便会抛出错误。该字段仅支持“TimeSpan”变量。默认情况下，该字段为空。

输入

• “参数”- 调用时可以传递给应用程序的参数。
• “参数变量”- 可以使用字典动态传递给工作流的参数。
• “隔离”- 如果选中该复选框，则调用的工作流将在单独的 Windows 进程中运行。这有助于将错误的工作流与主工作流隔离开。
• 工作流文件名- 要调用的 .xaml 文件的要调用的文件。文件路径相对于当前项目文件夹。该字段仅支持字符串和字符串变量。支持字符串变量。必须为所有字符串加上引号。
  备注：

  使用 2021.10 及更早版本的机器人时，隔离的工作流中不支持业务异常，所有异常都作为系统异常返回。

日志

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

重要提示：

如要设置默认的“日志入口”和“日志出口”值，请转到“UiPath Studio” >“项目设置” >“系统” >“调用工作流文件” 。此处提供的值适用于您的整个项目。

其他

• “私有”- 选中后将不再以“Verbose”级别记录变量和参数的值。
• “目标会话（仅适用于 Windows 项目）”- 指定启动工作流的会话。只有孤立的工作流可以在不同于父工作流的会话中启动，因此请确保将“孤立”属性设置为“True” 。您可以从以下选项中进行选择:
  • “当前”- 在与父流程相同的会话中打开子流程
  • “主要”- 子流程在主会话中启动，无论父流程在何处运行
  • “画中画”- 子流程在画中画会话中启动，无论父流程在何处运行