How to create an RPA flow using Invoke Workflow to invoke a sub workflow

1

Open RPA Studio

Open RPA Studio on your machine and sign in, if required.

2

Create a New Project

On the Home page of RPA Studio, click Create New Project and specify the following properties in the popup window:

• Name: InvokeWorkflow
• Project Location:
• Description: Demonstrates how to invoke a subflow inside the main flow
• Language: VB (selected by default)

3

Define Assign Activity

We will start the flow by adding the Assign activity to the canvas. You can find the list of activities by clicking Activities in the left-hand sidebar or from the View menu in the top bar. Use search to find the activity you want.

The Assign activity allows us to assign a value to a particular variable. Let's create a variable that can later be referenced in the activity properties. We will call the new variable input, and it will have the type string with no default value.

• The To property contains the variable that we will assign the value to.
• For the Value property, we will simply use the string "Hello".

4

Add a SubSequence

Create a new sequence in a different file. Click +New from the action ribbon and select Sequence.

A popup window will appear to specify the name of the sequence as SubSequence.xaml. Make sure to save it under the InvokeWorkflow folder and click Save. A new sequence file will be created and visible in the Project panel and will be open on the main design canvas.

Next, add the Assign activity to the canvas of the new SubSequence. We will first create arguments that can be referenced in the activity properties.

• For the To property, create an argument called output of type string without a default value and direction OUT.
• For Value, create an argument called inputargument of type string with direction IN.

Click the Assign activity and fill in the To and Value properties:

• To: output
• Value: inputargument + " World"

The names of the arguments specified in the subsequence should be remembered, as you will use them in the "main flow" (the one marked as Main in the Project panel). It is important to specify the direction for the arguments. IN arguments are those coming from MainPage.xaml, and OUT arguments are the ones output from SubSequence.xaml. Arguments from the subflows will not be visible in the RPA Management Process Details for configuration.

5

Add and Configure Invoke Workflow

Next, go back to the MainPage.xaml project and add an Invoke Workflow activity. Configure it as follows:

• For the Workflow file property, which contains the actual file path of the SubSequence.xaml file, create a variable called filepath of type string with the default value of the file path (for example: C:\Users\nkostuch\AppData\Local\InforRPA\InvokeWorkflowExample\SubSequence.xaml).
• Note: To get the subsequence file path, right-click on the SubSequence.xaml file in the Project panel and select Open containing folder. This will open the folder where the .xaml file is stored. Right-click on the SubSequence.xaml and select Properties, where you will find the full file location prefixed with /<filename and extension> (e.g., /Subsequence.xaml).
• Ensure the file is saved within the open project, as only those files will be published when the project is published.

• For the Input Argument, specify the VB expression for the dictionary of the values to be passed to the subsequence in the following way: New Dictionary(Of String, Object) From {{"inputargument", input}} inputargument is the argument from the SubSequence.xaml file, and input is the variable from the MainPage.xaml whose value will be passed to the subsequence and assigned to the inputargument argument in SubSequence.xaml.

• For the Output Argument, which will hold the value of the argument passed from SubSequence.xaml, create a variable with the same name as the one in SubSequence.xaml, but with a different data type. Let's create another variable called output, with the variable type IDictionary(Of String, Object).

6

Add a Message Box

To verify if the values were passed between MainPage.xaml and SubSequence.xaml, add the Message Box activity. For the Input Text, specify the following VB expression to see the value of the output variable passed to the flow:

output("output").ToString

Note: output is a variable of type IDictionary, so it holds the dictionary of output values from the sub-sequence.

Save the flow and click Run to execute it.