Install and Configure the Recipe

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

Install the recipe on your Oracle Integration instance. See Install a Recipe or Accelerator.

After you've installed the recipe, configure the following resources:

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

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

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

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

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

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

Update Integration Properties

Update integration property for the Oracle Get Emails integration flow.

  1. In the Integrations section, click Actions Actions icon 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.