Workflow activities

Overview​

• Build a project in UiPath Studio that consists of:

  • Main.Xaml - the main workflow used to execute the triggers
  • Several app-triggered workflows - used for basic arithmetic operations. These workflows are to be configured as entry points.

  Arithmetic operation	Studio workflow
  Addition	Sum.xaml
  Subtraction	Subtract.xaml
  Multiplication	Multiply.xaml
  Divison	Divide.xaml

  • The trigger workflow - this workflow is available as a template, but you can also create it and customize it to your business needs

• Build an app in UiPath Apps that consists of:

  • Two input controls - where you input your numbers
  • Four buttons controls - configured with the Trigger Workflow rule, to bind the button to a specific arithmetic operation, which is represented by a Studio workflow
  • Four text boxes controls - where the result from the arithmetic operations are sent

Building the UiPath Studio project​

Building the trigger workflow (template)​

1. Open UiPath Studio and create a new process.

   1. Select the Language.
   2. Select Windows as the Compatibility.

2. Ensure you have following activity package versions:

   • UiPath.WorkflowEvents.Activities 2.0
   • UiPath.System.Activities 23.4+

3. Start from the template called Apps-Workflow communication/ In the Project panel, add a new workflow. This will contain the activities that enable the communication channel between UiPath Apps and UiPath Robot: Apps Request Trigger and Handle Apps Request activities.

   If you use the Apps-Workflow communication template, skip to Building the calculator workflows.

4. Add the Apps Request Trigger activity. This must be the first activity in the workflow.

   When you add the Apps Request Trigger activity to your workflow, the TriggerEventArgs argument is automatically created. Use it in the Handle Apps Request activity to access data from the response payload received after the workflow execution.

5. Add an If activity to catch the case of losing the connection with the Apps client. When the user closes the Apps client, all triggers should be stopped.

   1. In the Condition field, write the following expression: ConditionTriggerEventArgs.ConnectionWithAppLost = true
   2. In the Then section, add the Stop Local Triggers activity.
   3. In the Else section, add the Handle Apps Request activity.
   4. In the Arguments fields of the Handle Apps Request activity, use the TriggerEventArgs argument that was automatically created by the Apps Request Trigger activity. This argument contains the workflow payload received from the Apps Request Trigger activity, and passes it on to the Handle Apps Request activity. While executing the workflow, the Handle Apps Request activity uses the information in the payload to invoke the workflow, then sends back the workflow output results when the workflow completes.
      Note:

      The Handle Apps Request activity must be used inside the Else section of the condition for connection lost. This guarantees that the activity is invoked during an active connection between UiPath Apps and UiPath Robot. Therefore, when the connection is lost, the process execution terminates.

Building the calculator workflows​

1. Create a folder in your project and name it "Calculator". This is where you store the calculator workflows.

2. Inside the folder, create a workflow for each arithmetic operation:

   Arithmetic operation	Studio workflow
   Addition	Sum.xaml
   Subtraction	Subtract.xaml
   Multiplication	Multiply.xaml
   Division	Divide.xaml

3. In all previously created workflows, define the following arguments:

   Argument Name	Direction	Argument type
   number1	In	Int32
   number2	In	Int32
   result	Out	Int32 Double - for the division

   Arguments "number1" and "number2" are the data your Apps user inputs.

   Argument "result" is the output received after the execution of the workflow.

4. In all previously created workflows, add the Assign activity. Configure it as follows:

   Workflow	Save to field	Value to save field
   Sum.xaml	result	number1 + number2
   Subtract.xaml	result	number1 - number2
   Multiply.xaml	result	number1 * number2
   Divide.xaml	Result	Cint(Math.Truncate(Decimal.Divide(number1,number2)))

5. Save your workflows.

6. Mark the calculator workflows as entry points: right-click on each workflow, then select the Enable Entry Point option. Doing this ensures your XAMLs are displayed in your app.

Building the Main workflow​

Managing the project in Orchestrator​

1. In Studio, publish your project package to an Orchestrator folder.
   Note:

   If you publish the project to a personal workspace, the corresponding process is automatically created. Skip to Building the Apps project.

2. In your Orchestrator tenant, go to the folder where you have published the Studio package.
3. Navigate to Automation > Processes, and click Add process.
4. From the Package Source Name dropdown, select the Studio project.
5. From the Entry point dropdown, select Main.xaml.
6. On the next pages, configure your process as desired, and then click Create. Your Studio project is now available as an Orchestrator process.

Building the Apps project​

Adding the controls​

1. On the UiPath Apps home page > Build tab, click Create new app.

2. Enter the Name for your app. For example, "Real-time calculator".

3. For Expression Language, select VB.

4. On the MainPage, add the following controls with the following General properties:

   Control	General property : value	Description
   1. Label	Text: "Real-time calculator"	Adds a title to your app.
   2. Textbox (Number) - rename it to "number1"	Label: "First number" Hint text: "Input the first integer number"	Allows users to input their data.
   3. Textbox (Number) - rename it to "number2"	Label: "Second number" Hint text: "Input the second integer number"	Allows users to input their data.
   4. Button - rename it to "sum"	Text: "Sum"	Triggers the execution of the Sum.xaml file.
   5. Texbox - rename it to "sum_result"	NA	Outputs the response of the Sum.xaml file.
   6. Button - rename it to "subtract"	Text: "Subtract"	Triggers the execution of the Subtract.xaml file.
   7. Texbox - rename it to "subtract_result"	NA	Outputs the response of the Subtract.xaml file.
   8. Button - rename it to "multiply"	Text: "Multiply"	Triggers the execution of the Multiply.xaml file.
   9. Texbox - rename it to "multiply_result"	NA	Outputs the response of the Multiply.xaml file.
   10. Button - rename it to "Divide"	Text: "Divide"	Triggers the execution of the Divide.xaml file.
   11. Texbox - rename it to "divide_result"	NA	Outputs the response of the Divide.xaml file.

Adding the process​

1. In your app, expand the Add control dropdown and select Process.
2. A list of tenants for the current account is displayed. Choose the one that hosts the processes you need, then click Next.
3. From the left-hand side panel, expand the Orchestrator folder where you created your process, select the process, then click Add. For example, select the "Calculator" process.

Adding rules to Button controls​

1. Select the button control.

2. On the right-hand side, in the Events panel, click Create rule. The Configure rule wizard opens.

3. Search for the TriggerWorkflow rule and select it.

4. In the Workflow file field, expand the previously added process ("Calculator") and select the corresponding workflow (.xaml file). For example, the Sum button must reference the "calculator_Sum_xaml" file.

5. Click on the Input Override field, then expand the previously selected workflow.

   1. Double-click "number1" to select it as the first input argument.

   2. For the Enter value field, click the "tune" icon to Open the expression editor, and write the following VB expression: MainPage.number1.Value

   3. Double-click "number2" to select as the second input argument.

   4. For the Enter value field, click the "tune" icon to Open the expression editor, and write the following VB expression: MainPage.number2.Value

      Note:

      "number1" and "number2" in the expression reference the Textbox(number) controls, which were renamed to "number1" and "number2" respectively. By setting the value of these controls as the values for the input arguments, you pass the user inputs from Apps to the Studio workflow.

   

6. Expand the When completed field and add the Set Value rule.

   1. For the Item To Set field, click the "tune" icon to Open the expression editor, and reference the result control. For example, for the sum result, write the following VB expression: MainPage.sum_result.Value

   2. For the Value field, click the "tune" icon to Open the expression editor, and reference the workflow result. For example, for the sum operation, write the following VB expression: Processes.Calculator.calculator_Sum_xaml.result.ToString.

      Note:

      Adding the Set Value rule in the When completed field ensures the value used to bind the workflow result to the corresponding result control is correct, as it uses the values returned as output after the workflow execution completes.

      

7. Repeat the previous steps for the remaining buttons:

   Button control	Workflow file
   Subtract	calculator_Subtract_xaml
   Multiply	calculator_Multiply_xaml
   Divide	calculator_Divide_xaml

Publishing and deploying your app in Orchestrator​

1. In Apps, click Publish on the top navigation bar.
2. Switch to Orchestrator and navigate to the desired folder.
3. Go to Automations > Apps and click Deploy app. The Deploy app wizard opens.
4. From the App dropdown, select the previously published app.
5. Click Deploy. Now your app is available in your Orchestrator folder to run.

Running your app​

1. In UiPath Assistant, on the Home panel, search for your app under the Apps category.
2. Click Run. You are prompted to grant UiPath Robot Assistant access.
3. Input two numbers.
4. Click a button for the desired arithmetic operation.