To access Salesforce using Oracle Integration and retrieve information about the status of Salesforce opportunities, you must perform certain configurations on your Salesforce instance.

1. Create an API-enabled custom role. You’ll assign this role to the user account you’ll subsequently create for Oracle Integration.
   1. On the Salesforce Setup page:
      1. Expand Manage Users under the Administer section in the left navigation pane.
      2. Click Profiles.
   2. On the Profiles page, click New Profile.
   3. On the resulting page:
      1. Select Standard User in the Existing Profile field.
      2. Enter a name for the new profile, for example, API Enabled, and click Save.

      The new profile is now saved, and the Profile Detail page of the new profile is displayed.

   4. Click Edit on the Profile Detail page.
   5. On the Profile Edit page:
      1. Scroll to the Administrative Permissions section and ensure that the API Enabled check box is selected.
      2. Scroll to the Standard Object Permissions section and perform the following actions.
         • In the Accounts row, leave the Read, Create, Edit, and Delete boxes checked. Additionally, select the ViewAll check box.
         • In the Contacts row, leave the Read, Create, Edit, and Delete boxes checked. Additionally, select the ViewAll check box.
         • In the Price Books row, leave the Read box checked. Additionally, select the Create, Edit, and Delete check boxes.
         • In the Products row, leave the Read box checked. Additionally, select the Create, Edit, and Delete check boxes.
      3. Scroll to the end of the page and click Save.
2. Create a user account for Oracle Integration and assign the custom role created previously to this account.

   Note:

   If you have already created a user account for Oracle Integration, you can assign the API-enabled custom role to the existing account.
   1. On the Profile Detail page of the API Enabled profile, click View Users.
   2. Click New User in the resulting page.
   3. On the New User page:
      1. Enter a first name and last name for the user, for example, Integration User05.

      2. In the Email field, enter a valid email address.

         The email address you enter is automatically populated in the Username field. Note this username.

      3. In the User License field, select Salesforce.
      4. In the Profile field, select the profile you created previously, that is, API Enabled.

      5. Scroll to the end of the page, ensure that the Generate new password and notify user immediately check box is selected, and click Save.

         The user account is now created, and a verification email is sent to the email address you provided for the account.

   4. Log in to the corresponding email account and click the Verify Account button in the email message from Salesforce.
      You’re redirected to the Salesforce instance to set a password for the new user account.
   5. Set a password and note the same.

      Subsequently, you’re signed in to the Salesforce instance with the new account.

      Note:

      If you’re shown the Lighting Experience UI, switch to the Salesforce Classic UI.
   6. Generate a security token for the new user account. You’ll need this security token along with the password to access Salesforce using Oracle Integration.
      1. Stay signed in as the new user and click the user name at the top of the page to open a menu.
      2. Click My Settings in the menu.
      3. On the My Settings page, in the Quick Links section, click Edit my personal information.
      4. On the resulting page, click Reset My Security Token in the left navigation pane.

      5. Click the Reset Security Token button.

         A new security token is sent to the email address associated with the account. Note the security token.

      6. On the Salesforce instance, click the user name again and select Logout from the menu. Log back in as the Administrator.
3. Identify your current Salesforce API version. See Find Your Current Salesforce API Version in Using the Salesforce Adapter with Oracle Integration 3.
4. Identify your Salesforce instance type. See Identify the Instance Type of Your Salesforce Organization in Using the Salesforce Adapter with Oracle Integration 3.
5. Create an outbound message. The outbound message triggers the integration flow of the recipe.
   1. On the Salesforce Setup page:
      1. Scroll to the Build section in the left navigation pane.
      2. Expand Create, then Workflow & Approvals, and then click Outbound Messages. If you’re shown the Understanding Workflow page, click Continue.
   2. Click New Outbound Message in the resulting page.
   3. On the New Outbound Message page:
      1. In the Object field, select Opportunity and click Next.
      2. Enter the following details for the new outbound message:

         • Enter a name for the outbound message.

           Note that the Unique Name field is automatically populated based on the name you enter.

         • Optionally, enter a description for the outbound message.

         • In the Endpoint URL field, enter the following URL:

           https://<OIC_FQDN:OIC_SSL_PORT>/ic/ws/integration/v1/flows/salesforce/ORCL-R-SFDC_ERP_OPPOR_TO_ORDER/1.0/

           Where OIC_FQDN and OIC_SSL_PORT are the fully-qualified domain name and port of your Oracle Integration instance. For example: oicinstance.example.com:443

         • In the User to send as field, select the user account using which you want to send the message.
         • Under Opportunity fields to send, select all the fields and click Add.

         • Click Save.

           The new outbound message is created and displayed on your browser.

6. Now, create a workflow rule to send the outbound message (created previously) when a Salesforce opportunity record closes with the status Closed Won.
   1. On the Salesforce Setup page:
      1. Scroll to the Build section in the left navigation pane.
      2. Expand Create, then Workflow & Approvals, and then click Workflow Rules.

      If you’re shown the Understanding Workflow page, click Continue.

   2. Click New Rule in the resulting page.
   3. On the New Workflow Rule page:
      1. Select Opportunity in the Object field, and click Next.
      2. Enter the following details for the new workflow rule:
         • Enter the rule’s name.
         • Optionally, enter a description for the rule.
         • In the Evaluation Criteria section, select the created, and every time it’s edited radio button.

         • In the Rule Criteria section, select the formula evaluates to true option, and define the following rule criteria:

           Opportunity: Stage EQUALS Closed Won

         • Click Save & Next.
      3. On the next page, click the Add Workflow Action button and choose Select Existing Action.
      4. On the Select Existing Actions page:
         • Select Outbound Message in the Search field.
         • In the Available Actions box, select the outbound message you created previously, for example, Outbound Message: <name of your outbound message>.
         • Click Add to move your selection to the Selected Actions box.
         • Click Save.

      5. Click Done.

         The new workflow rule is created and displayed on your browser.

   4. Click Activate to activate the rule.
7. Create a custom field for opportunity records.
   1. On the Salesforce Setup page:
      1. Scroll to the Build section in the left navigation pane.
      2. Expand Customize, then Opportunities, and then click Fields.
   2. On the Opportunity Fields page, scroll to the Opportunity Custom Fields & Relationships section and click New.
   3. On the New Custom Field page:
      1. Find and select the Text radio button, and click Next.
      2. Enter the following details for the new custom field:
         • Enter ERPCustomerId as the field label. Note that the field name is automatically populated based on the label you enter.
         • Enter 255 as the length.
         • Optionally, enter a description for the new field.
         • Click Next.
      3. On the Establish field-level security page, select the Visible check box in the header row to grant edit access to the new field for all profiles. Click Next.
      4. Leave all the layout check boxes selected and click Save.
   4. Create another custom field for Opportunity records by repeating Steps b and c, but enter a different label name, for example ERPOrderId.
   On the Opportunity Fields page, you can see the new fields added under the Opportunity Custom Fields & Relationships section.
8. Create a custom field for product records.
   1. On the Salesforce Setup page:
      1. Scroll to the Build section in the left navigation pane.
      2. Expand Customize, then Products, and then click Fields.
   2. On the Product Fields page, scroll to the Product Custom Fields & Relationships section and click New.
   3. On the New Custom Field page:
      1. Find and select the Text radio button, and click Next.
      2. Enter the following details for the new custom field:
         • Enter ERPID as the field label. Note that the field name is automatically populated based on the label you enter.
         • Enter 255 as the length.
         • Optionally, enter a description for the new field.
         • Click Next.
      3. On the Establish field-level security page, select the Visible check box in the header row to grant edit access to the new field for all profiles. Click Next.
      4. Leave all the layout check boxes selected and click Save.

      On the Product Fields page, you can see the new field added under the Product Custom Fields & Relationships section.

To access the Oracle ERP Cloud instance from Oracle Integration, you’ll require a separate user account on Oracle ERP Cloud.

1. Create a user account for Oracle Integration. Make a note of the user name and password you set for the account. You’ll use the credentials of this user account to connect to Oracle ERP Cloud from Oracle Integration.
2. Assign the following roles to the user account. For more information on these roles, see Assign Required Roles to an Integration User in Using the Oracle ERP Cloud Adapter with Oracle Integration 3.
   • Integration Specialist
   • Oracle ERP Cloud-specific data access to the integration user