Activities
latest
false
Banner background image
Workflow Activities
Last updated Apr 22, 2024

Invoke Workflow File

UiPath.Core.Activities.InvokeWorkflowFile

Description

Synchronously invokes a specified workflow, optionally passing it a list of input arguments. Arguments can be imported from a specified workflow with this activity by using the Import Arguments button in the body of the activity.

Note:
  • Importing arguments from a workflow auto-matches them to existing variables if they share the same name and data type.
  • Unserializable data types cannot be passed between isolated workflows (e.g. UIBrowser, UIElement, etc).
  • Antivirus policies that restrict PowerShell access may prevent the use of PowerShell-related activities. For example, you cannot use Invoke Workflow File and Invoke Power Shell when rule ID 6151 is enabled in McAfee Endpoint Security.
  • After running an invoked workflow that adds custom log fields, the log fields are restored to the configuration of the parent workflow.
Important:
  • Passing IN arguments to an Invoke Workflow File activity that is not isolated acts as if a reference is passed, which means any changes to the object inside the invoked workflow change the object in the main workflow.
  • Variables and arguments are not supported for workflow file names in Windows and cross-platform projects. This will trigger an Expressions are currently not supported error notification.
  • When invoking a workflow, make sure it does not contain persistence activities. These should only be used in the main workflow.

The workflow that is referenced in the WorkflowFileName property can be opened in the current project by using the Open Workflow button in the body of the activity.

Note: Every invoked .xaml file whose title contains a dot (.) has all the text that is before the dot (including the dot) replaced with an underscore (_).

Project compatibility

Windows - Legacy | Windows | Cross-platform

Cross-platform configuration

  • Workflow File Name - The file path of the .xaml file to be invoked. The file path is relative to the current project folder. This field accepts only strings or string variables. String variables are not supported in Windows and cross-platform projects, All strings must be placed between quotes.
  • Open Workflow - Opens the invoked workflow in a different tab of the same project.
Advanced options

Options

  • Isolated - If this check box is selected, the invoked workflow runs in a separate Windows process. This helps with isolating a faulty workflow from the main workflow.

Log

  • Log Entry - What type of information to automatically log when entering the invoked resource.
  • Log Exit - What type of information to automatically log when exiting the invoked resource.
  • LogLevel - The logging level applied to the messages generated by Log Entry and Log Exit.

Windows - Legacy, Windows configuration

Designer panel

You can find the following options in the body of the activity.

Importing Arguments

Clicking the Import Arguments button in the body of the activity opens an Arguments panel which features all of the arguments of the workflow referenced in the WorkflowFilePath property.



This panel enables you to choose which arguments you want to import from the invoked workflow by using the directional controls or the Delete button to reorganize the arguments. Clicking OK saves the changes.

Note:
  • Creating arguments in the panel causes them to be discarded, as they do not match the data in the invoked workflow.
  • Argument names are case sensitive in the panel.

Once the panel is closed, a counter next to the button shows how many arguments have been selected for importing. The counter is color coded, as follows:

  • orange - If there is a mismatch between the selected arguments and the ones that exist in the invoked workflow.
  • grey - If the selected arguments are found in the invoked workflow.

Open Workflow

The Open Workflow button In the body of the activity enables you to open the invoked workflow in a different tab of the same project.

Properties panel
Common
  • DisplayName - The display name of the activity.
  • 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.
    Note: If this activity is included in Try Catch and the value of the ContinueOnError property is True, no error is caught when the project is executed.
  • Timeout - Specifies the amount of time to wait for the activity to run before an error is thrown. This field supports only TimeSpan variables. By default, this field is empty.
Input
  • Arguments - The parameters that can be passed to the application at the time of invocation.
  • ArgumentsVariable - The parameters that can be passed dynamically to the workflow using a dictionary.
  • Isolated - If this check box is selected, the invoked workflow runs in a separate Windows process. This helps with isolating a faulty workflow from the main workflow.
  • WorkflowFileName - The file path of the .xaml file to be invoked. The file path is relative to the current project folder. This field accepts only strings or string variables. String variables are not supported in Windows and cross-platform projects, All strings must be placed between quotes.

    Note: When using 2021.10 and older robots, business Exceptions are not supported in an isolated workflow, all exceptions return as System Exceptions.

Log

  • Log Entry - What type of information to automatically log when entering the invoked resource.
  • Log Exit - What type of information to automatically log when exiting the invoked resource.
  • LogLevel - The logging level applied to the messages generated by Log Entry and Log Exit.
Misc
  • Private - If selected, the values of variables and arguments are no longer logged at Verbose level.
  • Target Session - Specifies the session in which the workflow is started. Only isolated workflows can be started in a different session from the parent. You can choose one of the following options:

    • Current - The child process opens in the same session as the parent one.
    • Main - The child process starts in the main session regardless to where the parent process runs.
    • Picture in Picture - The child process starts in the Picture in Picture session regardless to where the parent process runs.

      Note: When configuring the Target Session for the Invoke Workflow Activity, the Isolated parameter has to be enabled.

Was this page helpful?

Get The Help You Need
Learning RPA - Automation Courses
UiPath Community Forum
Uipath Logo White
Trust and Security
© 2005-2024 UiPath. All rights reserved.