Referencing a Process From Orchestrator

UiPath^® Apps offers the the ability to connect an app to an automation process. Your app can be used as an interface for providing inputs to the process or as a visual canvas to display outputs to your users.

Note: When sending a DataTable from one process to a second process using Apps, the columns order in a row may not be same.

Referencing a Process From Orchestrator

Once a process has been published to Orchestrator, you can reference that process from an app.

The following example shows you how to add a published process to an app:

1. From an existing app in App Studio, expand the dropdown menu at the right of the Add control button.

2. Select Process.

   
   

   

   
   

3. A list of tenants for the current account is displayed. Select the tenant that hosts the process you need to reference, then click Next.

   
   

   

   
   
4. The Add process wizard opens, displaying the list of processes in the selected tenant, grouped by folders.
5. Select one or more processes. The right-hand panel displays the description, and the input and output arguments of the highlighted process.
   
   

   

   
   

6. Check the box next to the process you want to use in your app and click Add.

   Note: Process permissions are managed in Orchestrator. Make sure you have the right permissions for the process you want to add from Orchestrator.

   For specific setup instructions, check out Managing Roles in Orchestrator.

   Important:

   By default, App Studio does not recognize the fields of a .NET object used as an input/output argument for your process (for example, a DataTable object).

   To allow App Studio to identify these fields:

   • Run your process before adding it to your app. Apps checks the job history and automatically detects the schema/fields of the .NET object.
   • Manually specify object fields for process input/output. If your process has no job history, then after you add it to your app, you must manually specify its fields.

   Be aware that manually added parameters are removed when the process is refreshed.

Updating a referenced process

To update a referenced process whose workflow was changed, follow these steps:

1. From the Processes section in the tree view, select the process you want to update.

2. Click on the Refresh process icon.

Refreshing the process retrieves the most recent bindings. However, some of the new bindings may throw errors which need to be manually resolved.

Binding Process Inputs/Outputs Arguments

To bind an input or output argument to a control or rule using the Expression editor, use the following syntax:

Processes.[Process_name].[name_of_the_argument]

To identify the list of input and output arguments of a process, select it from the Processes list on the left-side panel:

Note: Make sure the process is referenced in your app.

Launching a Process

The following example shows how to start a process when a Button control is clicked. You can use the events of any control.

1. In your app, add a Button control.

2. Select the Button control, go to the Events tab, and click Create rule. The wizard for configuring rules opens.

   
   

   

   
   
3. From the dropdown, select the Start process rule.

   
   

   

   
   

4. Click the What process to start field. The Resources panel opens, displaying the list of available processes.

5. Select the process you want to start by double-clicking it.

Note: By default, processes run in the attended mode. To run the process unattended, select the Unattended option.

Important:

• For on-premises Orchestrator instances, the limitation of 100 unique unattended processes applies across all accounts.

Interim Process Result

To use a UiPath^® Studio Activity, the following environment must be set up:

• UiPath^® Studio v2022.4 + with UiPath^® Robot v2020.10+
• The UiPath.WorkflowEvents.Activities package is installed