3 Install and Configure the Recipe

On your Oracle Integration instance, install the recipe to deploy and configure the integration and associated resources.

1. On the Oracle Integration Home page, in the Get started section, click Browse store.
2. Find the recipe you want to install, then click Get.

   A message confirms that the recipe was successfully installed, and the recipe card shows In use.

3. Click Configure on the recipe to configure its resources.

   The project workspace opens, displaying all the resources of the recipe. Configure the following resources before you activate and run the recipe.

Configure the Microsoft Graph REST API Connection

1. In the Connections section, click the connection name.
2. In the Properties section, enter the following details:

   Field	Information to Enter
   Connection type	Select REST API Base URL.
   Connection URL	Enter the connection URL. For example: https://graph.microsoft.com/v1.0

3. In the Security section, enter the following details:

   Field	Information to Enter
   Security policy	Select OAuth Authorization Code.
   Client Id	Enter the client Id.
   Client Secret	Enter the client secret.
   Authorization Code URI	Enter https://login.microsoftonline.com/<tenantId>/oauth2/v2.0/authorize
   Access Token URI	Enter https://login.microsoftonline.com/<tenantId>/oauth2/v2.0/token

4. In the Scope field, enter the scope URL.

   For example:

   https://graph.microsoft.com/Mail.ReadWrite https://graph.microsoft.com/Mail.Send offline_access

5. Click Save. If prompted, click Save again.
6. Click Test to ensure that your connection is successfully configured. In the resulting dialog, click Test again.

   A message confirms if your test is successful.

7. To return to the project workspace, click Go back .

Configure the Microsoft Outlook Connection

1. In the Connections section, click the connection name.
2. In the Security section, enter the following details:

   Field	Information to Enter
   Client Id	Enter the client Id.
   Client Secret	Enter the client secret.
   Scope	Enter the scope URL. For example https://graph.microsoft.com/Mail.ReadWrite https://graph.microsoft.com/Mail.Send offline_access

3. Click Provide Consent. This enables Oracle Integration to interact with the Microsoft Office 365 Outlook account used to create the application at https://portal.azure.com/. If everything is correct, you are prompted for the Oracle Integration credentials.
   1. Enter the credentials and click OK. These are the same credentials you use to log in to Oracle Integration.
   2. Enter the Microsoft Office 365 Outlook account credentials.
      A page is displayed asking for permission to interact with the account.
   3. Click Yes.
      The Access Allowed! page is displayed.
4. Click Save. If prompted, click Save again.
5. Click Test to ensure that your connection is successfully configured. In the resulting dialog, click Test again.

   A message confirms if your test is successful.

6. To return to the project workspace, click Go back .

Configure the OCI Language AI REST API Connection

1. In the Connections section, click the connection name.
2. In the Properties section, enter the following details:

   Field	Information to Enter
   Connection type	Select REST API Base URL.
   Connection URL	Enter the Language AI Service API endpoint to use. For example: https://language.aiservice.us-ashburn-1.oci.oraclecloud.com/20221001

3. In the Security section, enter the following details:

   Field	Information to Enter
   Security policy	Select OCI Signature Version 1.
   Tenancy OCID	Enter your tenancy OCID. See Finding Your Tenancy OCID (Oracle Cloud Identifier)
   User OCID	Enter your user OCID. See Resource Identifiers.
   Private Key	Enter the private key. See How to Generate API Signing Key in Required Keys and OCIDs. Ensure that the key pair is in PEM format. Also, upload public key to the OCI console. See To upload or paste API key in Required Keys and OCIDs.
   Finger Print	Enter your finger print. See How to get the Key’s Fingerprint in Required Keys and OCIDs.

4. Click Save. If prompted, click Save again.
5. Click Test to ensure that your connection is successfully configured. In the resulting dialog, click Test again.

   A message confirms if your test is successful.

6. To return to the project workspace, click Go back .

Configure the OCI Generative AI REST API Connection

1. In the Connections section, click the connection name.
2. In the Properties section, enter the following details:

   Field	Information to Enter
   Connection type	Select REST API Base URL.
   Connection URL	Enter the Generative AI Service Inference API endpoint to use. For example: https://inference.generativeai.us-chicago-1.oci.oraclecloud.com/20231130

3. In the Security section, enter the following details:

   Field	Information to Enter
   Security policy	Select OCI Signature Version 1.
   Tenancy OCID	Enter your tenancy OCID. See Finding Your Tenancy OCID (Oracle Cloud Identifier)
   User OCID	Enter your user OCID. See Resource Identifiers.
   Private Key	Enter the private key. See How to Generate API Signing Key in Required Keys and OCIDs. Ensure that the key pair is in PEM format. Also, upload public key to the OCI console. See To upload or paste API key in Required Keys and OCIDs.
   Finger Print	Enter your finger print. See How to get the Key’s Fingerprint in Required Keys and OCIDs.

4. Click Save. If prompted, click Save again.
5. Click Test to ensure that your connection is successfully configured. In the resulting dialog, click Test again.

   A message confirms if your test is successful.

6. To return to the project workspace, click Go back .

Configure the Oracle REST Trigger Connection

1. In the Connections section, click the connection name.
2. Click Test to ensure that your connection is successfully configured. In the resulting dialog, click Test again.

   A message confirms if your test is successful.

3. Click Save. If prompted, click Save again.
4. To return to the project workspace, click Go back .

Configure the Lookup Table

Edit the values of the lookup keys as required in the recipe's lookup tables.

The recipe contains the following lookup tables:

• AILanguageParameters: This lookup table holds input parameters for Language AI Service.
• GenerativeAIParameters: This lookup table holds input parameters for Generative AI Service.

1. In the Lookups section, click the lookup name.
2. Edit the lookup table.
   • In the AILanguageParameters lookup table, enter required values to prepare request for BatchDetectLanguageEntities API in the Oracle MaskingPIIfromEmail integration flow.
   • In the GenerativeAIParameters lookup table, enter required values to prepare request for Generative AI API in the Oracle GenAI Quick ReplyToEmail integration flow.
3. Click Save. If prompted, click Save again.
4. To return to the project workspace, click Go back .

Update Integration Properties

Update integration property for the Oracle Get Emails integration flow.

1. In the Integrations section, click Actions on the integration flow, then select Update property values.
2. In the Update property values panel, enter the value for the MailSubjectToRead integration property. For example: Account Payment Dispute.
   This integration property holds the value for the email subject on the basis of which emails retrieved from the Outlook server are filtered.
3. Click Submit.

   A message confirms that the integration property has been updated successfully.