调用工作流文件

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 中，并且 ContinueOnError 属性的值为 True，则执行项目时不会捕获任何错误。

选项

• “目标会话”（仅适用于 Windows 项目）- 指定启动工作流的会话。 只有孤立的工作流可以在与父工作流不同的会话中启动，因此请确保将“孤立” 属性设置为True 。 您可以选择以下选项之一：

  • 当前 - 在与父流程相同的会话中打开子流程
  • 主要 - 子流程在主会话中启动，无论父流程在何处运行。

  • 画中画 - 子流程在画中画会话中启动，无论父流程在何处运行。

• “隔离”- 选择“True”可在单独的 Windows 进程中运行调用的工作流。 这有助于将错误的工作流与主工作流隔离开。 默认情况下为False 。

日志

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

Windows - 旧版配置

设计器面板

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

• 工作流文件名- .xaml 文件的文件路径 要调用的文件。 文件路径相对于当前项目文件夹。 此字段仅接受字符串或字符串变量。 支持字符串变量。 必须为所有字符串加上引号。

• “导入参数” -打开“参数” 面板，其中包含“工作流文件名” 属性中引用的工作流的所有参数。

  通过此面板，您可以使用方向控件或删除按钮重新组织参数，以便从调用的工作流中选择要导入的参数。单击“确定”可保存更改。单击确定可保存更改。

  备注：

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

  关闭该面板后，按钮旁边的计数器会显示要导入的已选参数的数量。计数器采用颜色编码，具体如下：
  • 橙色 - 表示所选参数与所调用工作流中存在的参数不匹配。
  • 灰色 - 表示在调用的工作流中找到所选参数。

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

属性面板

常见

• 出错时继续 - 指定在活动抛出错误时是否应继续自动化操作。该字段仅支持“布尔值”（true 和 false）。默认值为 false。因此，如果该字段为空且活动引发错误，系统将停止执行项目。如果该值设为“True”，则无论出现何种错误，系统都将继续执行项目。
  注意：如果 Try Catch 异常处理中包含该活动且出错时继续属性的值为 True，则系统在执行项目时不会捕获任何错误。

• “显示名称”- 活动的显示名称。

• 超时 - 指定等待时间（以毫秒为单位），如果超出该时间活动未运行，就会引发错误。此字段仅支持 TimeSpan 变量。默认情况下，此字段为空。

输入

• 参数 - 调用时可以传递给应用程序的参数。
• 参数变量 - 可以使用字典动态传递给工作流的参数。
• 隔离 - 如果选中该复选框，则调用的工作流将在单独的 Windows 进程中运行。这有助于将错误的工作流与主工作流隔离开。

• 工作流文件名- .xaml 文件的文件路径 要调用的文件。 文件路径相对于当前项目文件夹。 此字段仅接受字符串或字符串变量。 支持字符串变量。 必须为所有字符串加上引号。

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

日志

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

其他

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

• “目标会话” （仅适用于 Windows 项目）- 指定启动工作流的会话。 只有孤立的工作流可以在与父工作流不同的会话中启动，因此请确保将“孤立” 属性设置为True 。 您可以选择以下选项之一：

  • 当前 - 在与父流程相同的会话中打开子流程
  • 主要 - 子流程在主会话中启动，无论父流程在何处运行。

  • 画中画 - 子流程在画中画会话中启动，无论父流程在何处运行。