3 Install and Configure the Recipe

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

  1. On the Oracle Integration Home page, scroll to the Accelerators & Recipes section.
  2. Click Search All.

    The list of available recipes is displayed.

  3. Find and select the recipe package that you want to install, then click Install Install icon..

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

  4. After the package is installed, click Configure Configure icon on the recipe card.

    The Configuration Editor opens, displaying all the resources of the recipe package. Configure the following resources before you activate and run the recipe.

Configure the Oracle Salesforce Connection

  1. In the Configuration Editor, click the connection name.
  2. In the Connection Properties section, enter the following details:
    Field Information to Enter
    Select Salesforce.com Instance Type Select Production or Sandbox based on your Salesforce instance type.
    API Version Enter your current Salesforce API version. To obtain the API version, see Configure Salesforce.
  3. In the Security section, enter the following details:
    Field Information to Enter
    Security Policy Leave Salesforce Username Password Policy selected.
    Username Enter the username of the account created for Oracle Integration on Salesforce. See Configure Salesforce.
    Password

    Enter the password of the account created for Oracle Integration on Salesforce.

    Note: To the password, you must also append the security token generated for the same account.

  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 Configuration Editor, click Back Back icon . Click Save again if prompted.

Configure the Oracle Zendesk Connection

  1. In the Configuration Editor, click the connection name.
  2. In the Connection Properties section, enter the Zendesk host name. For example: https://your_domain_name.fa.DC.oraclecloud.com.
  3. In the Security section, enter the following details:
    Field Information to Enter
    Client Id Enter the client ID of the OAuth application created in Zendesk. See Configure Zendesk.
    Client Secret Enter the client secret of the OAuth application created in Zendesk.
    Scope Enter write.
  4. Click Save. If prompted, click Save again.
  5. Click Provide Consent.
  6. In the resulting Sign in dialog, enter your Oracle Integration user name and password, and click Sign in. You’ll be redirected to the Zendesk login page.
  7. Enter your Zendesk account credentials and click Sign in.
  8. After you see an access allowed message, switch back to the Zendesk Connection window of Oracle Integration to test your connection.
  9. 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.

  10. To return to the Configuration Editor, click Back Back icon . Click Save again if prompted.

Update the Integration Property for the App-Driven Flow

Update the integration property for the Oracle Salesforce Zendesk Contact2User Sync integration flow.

This integration flow contains the following property:
  • EmailTo: This integration property holds the email address to which run-time exception emails are sent. Enter an email address of your choice.

For the procedure to update the integration property, see Steps 7 to 9 in Override Design-Time Properties in an Integration in Using Integrations in Oracle Integration Generation 2.

Configure Data Mapping for the Scheduled Integration Flow

Edit the Oracle Zendesk Salesforce User2Contact Sync integration flow, and define the mapping for the Map to createContactInSalesforce element.
  1. In the Configuration Editor, select the Oracle Zendesk Salesforce User2Contact Sync integration flow, then click Edit Edit icon.
  2. On the integration canvas, click the Map to createContactInSalesforce element, and then click Edit Edit icon to open the mapper.
  3. In the Target pane, find the External ID Field Name element. Click the element to open the expression editor at the bottom.
  4. In the editor, click the Switch to Developer View icon, and enter the following expression: "Zendesk_User_Id__c".
  5. Click Save, then Validate.
  6. Click Close to return to the integration canvas, then click Close again to return to the Configuration Editor.