Setting up Automation integration

Introduction

To enable business users to trigger automations, you must set up Automation integration. Below is an overview of the steps to set up an Automation integration for a Process Mining process app.

Send email example

You can download the Send_Email_example_files.zip file to easily set up an automation integration for sending an email yourself.

The Send_Email_example_files.zip file contains:

A SendEmail.zip file with an automation workflow project that you can import in Studio.
Note:
The automation workflow is built in UitPath Studio 2022.10.5.
A simpleschema.json file that you can use to set up the Orchestrator queue.

Step 1: Create an automation workflow

To set up Automation integration, first create an automation workflow in UiPath® Studio. For example, you can set up an automation for sending an email when an item is added to an Orchestrator queue. This automation can be used, for example, to send a reminder email for a late payment case detected in Process Mining. See the illustration below for an example automation workflow.

Define a Get Transaction Item activity in the automation workflow if you want to enable pulling items from queues. See the illustration below.

In the above example: Set Variable Value activities are used to set the arguments to variables that can be used in the email. The Microsoft Office 365: Send Email activity is used to send a notification email from the automation.

In Studio, publish the automation to make it available in UiPath® Orchestrator.

Step 2: Set up an Orchestrator queue

1. In Orchestrator, create a new queue using a Specific Data JSON Schema. The Data JSON Schema defines the input data that is required for the automation. Make sure the JSON schema matches the arguments defined in the automation.

Important:

Only queues containing a Specific Data JSON Schema file in Orchestrator are supported by Process Mining. Below is an example of a Specific Data JSON Schema that is used to set up integration with Process Mining.

{  "definitions": {},
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "http://example.com/root.json",
   "type": "object",
   "title": "The Root Schema", 
   "properties":{
           "CaseID":
            {  "type": "string"
        },
            "Supplier": 
            {  "type": "string"
        },
            "Value":
            {  "type": "number"
        },
            "Email": 
            {  "type": "string" 
        }
   }
 }{  "definitions": {},
   "$schema": "http://json-schema.org/draft-07/schema#",
   "$id": "http://example.com/root.json",
   "type": "object",
   "title": "The Root Schema", 
   "properties":{
           "CaseID":
            {  "type": "string"
        },
            "Supplier": 
            {  "type": "string"
        },
            "Value":
            {  "type": "number"
        },
            "Email": 
            {  "type": "string" 
        }
   }
 }

2. Add a Trigger for the queue and select the automation workflow you created in Studio as the process associated.

When you have created a queue in Orchestrator, you can reference that queue from a Process Mining process app.

Step 3. Configure the automation integration in Process Mining

In Process Mining open the process app for which you want to enable automation integration in the Dashboard editor. See Working with the dashboard editor.
In the Dashboard editor, select the Automation manager button to open the Automation manager. See Automation manager.
Add a new automation and select the Orchestrator queue.
- Click on +Add automation.
- In the Add queue dialog select the Orchestrator queue you want to use. The data schema defined in the Data JSON Schema file for the Orchestrator queue is loaded. Note that only queues containing a Specific Data JSON Schema file in Orchestrator are available for Process Mining.
- Map the automation input fields to the appropriate data fields available in your process app.
- Enter the Maximum number of cases sent at once to limit the number of cases that can be sent to Orchestrator.
  
  Note:
  As an analyst, it is important to consider limiting the number of cases a business user can send to Orchestrator based on the specific use case. By default, the system allows 50 cases to be sent to the queue, but the range can be adjusted from 1 to 100, providing flexibility for different scenarios.
  
  Important:
  Check out the data type of the queue input fields defined in the Specific data JSON schema and make sure to map the input fields to a Process Mining data field with the correct input type. See App Templates.
Instead of mapping to a specific data field, you can select the Custom text option for a text input field. This enables business users to enter a free text when triggering an automation. For example a description or an email address.
Publish the process app to make the automation available to business users.
- Select Publish.
The automation is now available in the process app. See Triggering an automation from a process app

The Trigger an automation option is available on most dashboards and charts. See the illustration below for an example.

When the user has selected cases that are candidate for automation the Trigger an automation option can be selected to enter the input data for the automation. See the illustration below for an example.