# Setting up Automation integration

> 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.

## 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.

![Steps to set up an Automation integration for a Process Mining process app](https://dev-assets.cms.uipath.com/assets/images/process-mining/process-mining-steps-to-set-up-an-automation-integration-for-a-process-mining-process-app-130153-cd701db8-e14de298.webp)

### Send email example

You can download the [Send_Email_example_files.zip](https://documentationpicturerepo.blob.core.windows.net/files/Process_Mining/Orchestrator_integration/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.

  ![docs image](https://dev-assets.cms.uipath.com/assets/images/process-mining/process-mining-example-automation-workflow-130161-b89335ac-70b36b31.webp)

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

  ![docs image](https://dev-assets.cms.uipath.com/assets/images/process-mining/process-mining-get-transaction-item-activity-130165-1931baf5-1d2f7b61.webp)

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.

1. 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**. The following code shows 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", "null"]
        },
            "Supplier": 
            {  "type": ["string", "null"]
        },
            "Value":
            {  "type": ["string", "null"]
        },
            "Email": 
            {  "type": ["string", "null"]
        }
   }
 }
```

:::note
For columns that should not contain `null` values, remove `,"null"` from the property definition.
:::

![Specify data JSON schema](https://dev-assets.cms.uipath.com/assets/images/process-mining/process-mining-specify-data-json-schema-130180-3e53506f-098c3d41.webp)

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

   ![Add trigger](https://dev-assets.cms.uipath.com/assets/images/process-mining/process-mining-add-trigger-130184-d1a57bc9-bcde853a.webp)

   ![Select automation workflow](https://dev-assets.cms.uipath.com/assets/images/process-mining/process-mining-select-automation-workflow-464964-8ac7ee06-e4848682.webp)

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

1. 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](https://docs.uipath.com/process-mining/automation-suite/2023.10/user-guide/working-with-the-dashboard-editor#working-with-the-dashboard-editor).
2. In the **Dashboard editor**, select the **Automation manager** button to open the **Automation manager**. See [Automation manager](https://docs.uipath.com/process-mining/automation-suite/2023.10/user-guide/automation-manager#automation-manager "Automation manager enables you to manage automations connected to Process Mining. With Automation manager you can select Orchestrator queues to be used for automations triggered by business users from the process app.Select the Automation manager button in the upper right corner of the dashboard editor to open Automation Manager. The Automation manager page is displayed, showing the automations defined for your process app.").
3. 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.
     :::

   ![docs image](https://dev-assets.cms.uipath.com/assets/images/process-mining/process-mining-docs-image-285010-150dc864-9d87ea53.webp)

     :::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](https://docs.uipath.com/process-mining/automation-suite/2023.10/user-guide/app-templates#app-templates). :::Instead of mapping to a specific **Case field**, you can select the **Business user input** 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. The **Analyst input** option enables you to enter a custom text which is displayed as read-only to the business user.

   ![docs image](https://dev-assets.cms.uipath.com/assets/images/process-mining/process-mining-docs-image-288885-e30a78be-b6374cb9.webp)
4. 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](https://docs.uipath.com/process-mining/automation-suite/2023.10/user-guide/triggering-an-automation-from-a-process-app#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.

   ![docs image](https://dev-assets.cms.uipath.com/assets/images/process-mining/process-mining-trigger-an-automation-option-on-a-chart-303189-2a7c31d5-416aaa4b.webp)

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.

   ![docs image](https://dev-assets.cms.uipath.com/assets/images/process-mining/process-mining-trigger-an-automation-panel-130119-e1bc9bef-61730cd3.webp)

This will create a Queue item for every case in the **Orchestrator** queue that will trigger the automation defined in **Studio**.

   ![docs image](https://dev-assets.cms.uipath.com/assets/images/process-mining/process-mining-queue-items-in-the-orchestrator-queue-130124-c28f4c5c-41a65a4d.webp)

## Step 4. Execute the automation

A robot will pick up the automation and perform the action defined in the automation.