# Setup

> To successfully establish a connection and send requests to the [Oracle Integration REST API](https://docs.oracle.com/en/cloud/paas/integration-cloud/rest-api/index.html), the [Oracle Process Scope](https://docs.uipath.com/activities/other/latest/legacy-integrations/oracle-integration-cloud-process-oracle-process-scope) activity must provide the account credentials that enable access to the Oracle Integration instance.

## Overview

To successfully establish a connection and send requests to the [Oracle Integration REST API](https://docs.oracle.com/en/cloud/paas/integration-cloud/rest-api/index.html), the [Oracle Process Scope](https://docs.uipath.com/activities/other/latest/legacy-integrations/oracle-integration-cloud-process-oracle-process-scope) activity must provide the account credentials that enable access to the Oracle Integration instance.

To provide the **Oracle Process Scope** activity with your account credentials and enable the other activities to successfully send requests to the Oracle Integration REST API operations, you must complete the [Prerequisites](https://docs.uipath.com/activities/other/latest/legacy-integrations/oracle-integration-cloud-process-setup#setup) and following steps:

1. [API Role and Message Start](https://docs.uipath.com/activities/other/latest/legacy-integrations/oracle-integration-cloud-process-setup#setup)
2. [Build your project](https://docs.uipath.com/activities/other/latest/legacy-integrations/oracle-integration-cloud-process-setup#setup)

   ![docs image](https://dev-assets.cms.uipath.com/assets/images/activities/legacy-integrations-docs-image-178131-ac70dbfd-7d5f29ab.webp)

## Prerequisites

* Oracle Cloud account
  + For more information, see [Manage Oracle Cloud Accounts and Services](https://docs.oracle.com/en/cloud/get-started/subscriptions-cloud/index.html) in the Oracle documentation.
  + Your account **username** and **password** are required in the scope activity.
* Oracle Integration instance
  + For more information, see [Manage Oracle Cloud Accounts and Services](https://docs.oracle.com/en/cloud/get-started/subscriptions-cloud/index.html) in the Oracle documentation.
  + Your integration endpoint **URL** is required in the scope activity.

The OIC Process activities automate interactions with your integration processes and tasks. To enable the activities, you must have at least one of each of the following:

* Oracle Process Application
  + For more information, see [Create Your First Application](https://docs.oracle.com/en/cloud/paas/integration-cloud/user-processes/create-your-first-application-quick-start.html#%20GUID-67903E52-3F87-4767-980F-513EB5990C44) in the Oracle documentation.
* Oracle Business Process
  + For more information, see [About Business Processes](https://docs.oracle.com/en/cloud/paas/process-cloud/user/business-processes.html#%20GUID-2080743F-61AA-4D41-B5BA-B80E2F8F903A) in the Oracle documentation.

## Steps

### 1. API Role and Message Start Event

To enable the activity, your process must have an API role assigned to a **Message Start** event.

:::note
The API role and Message Start event are only required for the **Start Process** activity. The other activities are enabled after you complete the **Prerequisities**.
:::

1. To create your API role, follow the steps in the Oracle documentation to [Define Application Roles](https://docs.oracle.com/en/cloud/paas/integration-cloud/user-processes/define-application-roles.html).
2. After creating your API role, add it as a swimlane in your process.
   * For more information, see [Adding and Editing Swimlanes](https://docs.oracle.com/en/cloud/paas/process-cloud/user/working-process-roles-swimlanes.html#%20GUID-46480334-8D7E-4FB0-8B25-1286F2B93A37)
3. Add a **Message Start** event and assign it to the API role.
   * For more information, see [About the Message Start Events](https://docs.oracle.com/en/cloud/paas/process-cloud/user/defining-process-start-and-end.html#%20GUID-C6285DEC-1A38-4D27-8D36-D9E75DB1C000) in the Oracle documentation.
4. Publish and activate the new or updated process.
   * For more information, see [Activate Applications](https://docs.oracle.com/en/cloud/paas/integration-cloud/user-processes/activate-applications.html) in the Oracle documentation.

     ![docs image](https://dev-assets.cms.uipath.com/assets/images/activities/legacy-integrations-docs-image-179124-d5bd80d1-300412ac.webp)

### 2. Build your project

1. Create a new automation project.
   1. Open **UiPath Studio**.
   2. Under **New Project**, click **Process** (this opens a **New Blank Process** window).
   3. Enter a project **Name**, **Location**, and **Description**.
   4. Click **Create**.

      ![docs image](https://dev-assets.cms.uipath.com/assets/images/activities/legacy-integrations-docs-image-180152-64b6e32f-5c0b2db6.webp)
2. Install the **UiPath.OracleIntegrationCloudProcess.Activities** package.
   1. In the **Design** ribbon, click **Manage Packages** (this opens the **Manage Packages** window).
   2. Under **All Packages**, click **Official**.
   3. In the **Search** bar, enter *Oracle*.
   4. Click, install and accept the license for the **UiPath.OracleIntegrationCloudProcess.Activities**.
      * For more information about Uipath Studio packages, see [Managing Packages](https://docs.uipath.com/studio/docs/managing-activities-packages) in the Studio Guide.

        ![docs image](https://dev-assets.cms.uipath.com/assets/images/activities/legacy-integrations-docs-image-181228-37b7bff7-8b0cbc70.webp)

You're done!

Now that you have completed the setup, you can start adding the OIC Process activities to your project.

## Next steps

To learn more about the OIC Process activities (including example property inputs/outputs), see the [Activities](https://docs.uipath.com/activities/other/latest/legacy-integrations/oracle-integration-cloud-process-activities) page for a complete list of activities and links to the detail pages.