Configure the Integration Connections

Complete the integration between Oracle Fusion Service and your third-party survey supplier in the following order. The steps in this procedure use SurveyMonkey as the example.

1. Import the package into Oracle Integration

2. Configure a connection to the Oracle Fusion Service Instance

3. Configure the Connection. In this example, the connection is configured for SurveyMonkey.

   Note: If you're using SurveyMonkey, be sure to review the SurveyMonkey API information at the end of this chapter.

4. Configure the Survey Oracle Integration connection

Import the Package

The Oracle Integration administrator imports the package.

1. Sign in to Oracle Integration.

2. On the home page, click Integrations.

3. Click Packages.

4. On the Packages page, click the Import button.

5. On the Import Package window, browse for the .par file that you downloaded from Oracle Marketplace.

6. Click the Import button.

7. The .par file is now listed on the Packages page.

   To view what's in the package, click the package in the Name column.

8. Click Close.

   Note: The files in the package are specific examples for using SurveyMonkey as a third-party survey supplier. If you use another supplier, you can use the files as a reference example to create your own.

Configure the REST Connections

REST connections allow Oracle Integration to connect to the Survey Integration connection for your third-party survey supplier using API calls. Your supplier must have public APIs.

1. From the Oracle Integration home page, navigate to the Integrations page.

2. Click Connections.

3. Enter "Survey" in the Search field to narrow the search results.

4. On the Connections page, find and click the REST connection. In this example, we use SurveyMonkey. Find the REST connection Survey Integration SurveyMonkey Connection.

5. Click on Configure Connectivity and enter the value for Connection URL that's appropriate for your site. For example, https://api.surveymonkey.com.

6. Click OK.

7. On the Detail page, enter the required values for Security .

   Note: You need your Client ID and Client Secret values to continue. These values are provided by your third-party supplier. In this example, SurveyMonkey.In the Settings tab in SurveyMonkey, change the OAuth Redirect URL to:This is the OIC URL you got from the browser. Here's how you get it.For the supplier SurveyMonkey, you must have the following scopes selected in SurveyMonkey under the settings tab:
   Tip: You can find your SurveyMonkey Client ID and Client Secret values by viewing the details of your SurveyMonkey Private App at https://developer.surveymonkey.com/apps.

   Continuing from the previous step, enter the required values for Security. The following table shows the values.

   Required Security Property	Value
   Security Policy	Select OAuth Custom Three Legged Flow from the drop-down list
   Authorization Request	Enter the Authorization Request that's appropriate for your site. For example,https://api.surveymonkey.com/oauth/authorize?response_type=code&redirect_uri=${redirect_uri}&client_id=xxx Where xxx is the Client ID you received from SurveyMonkey.
   Access Token Request	Enter the Access Token Request that's appropriate for your site. For example,-X POST -H "Content-Type: application/x-www-form-urlencoded" -d "code=${auth_code}&redirect_uri=${redirect_uri}&grant_type=authorization_code&client_id=xxx&client_secret=yyy" https://api.surveymonkey.com/oauth/token Where xxx is Client ID and yyy is Client Secret

8. Click Provide Consent. For more information, see the FAQs in this chapter.

   Before continuing, make sure you receive a success message (access allowed).

9. When you're prompted, enter your Oracle Integration User Name and Password.

   Note: If you encounter the error "The authorization request failed: Invalid redirect uri," copy the redirect_uri parameter value from the browser URL and update the same OAuth Redirect URL as you did in the previous note.

10. Enter your SurveyMonkey User Name and Password.

11. Click Save on the Provide Consent window.

12. Click Test.

    You see a message saying the test was successful.

13. Click Save.

    You see a window listing the integrations that are using the connection.

14. Click Save on window.

15. Click Close on the Survey Integration Oracle Integration Connection page.

Caution: For the integration to access the API for specific functionality of the survey, you must have active scope requirements in your SurveyMonkey Private App.

Configure the Oracle Fusion Service Instance Connection

This connection is used by Oracle Integration to get survey details from Fusion Service

1. On the Oracle Integration home page, click Connections.

2. On the Connections page, find Survey Integration Engagement Cloud Connection.

3. Go to the Survey Integration Engagement Cloud Connection Detail page.

4. In the Connection Properties window, enter the values as shown in the following table.

   The values in the tables in the following steps are located in the email you receive when Oracle Integration in provisioned.

   Property Name	Property Value
   OSC Service Catalog	Enter the service catalog URL for your Oracle Fusion Service instance. For example: https://<CRM domain WSDL URL host>/fndAppCoreServices/ServiceCatalogService?wsdl
   OSC Event Catalog URL	Optionally, enter the event catalog URL for your Oracle Fusion Service instance. For example: https://<CRM domain host>/soa-infra
   Interface Catalog URL	Enter the interface catalog URL for your Oracle Fusion Service instance. For example: https://<CRM domain host>/helpPortalApi/otherResources/latest/interfaceCatalogs

5. In the Security region, enter the values as shown in the following table.

   Property Name	Property Value
   User Name	<FUSION SERVICE USER NAME>
   Password	Enter the password.
   Confirm Password	Reenter the password.

6. Click the Test button.

   It may take some time for the user <FUSION SERVICE USER NAME> to synchronize with the directory.

   A message appears saying the test was successful.

7. Click Save.

   A window appears listing the integrations that are using the connection.

8. Click Save.

9. Click Close on the Survey Integration Oracle Integration Connection page.

Configure the Survey Integration Oracle Integration Connection

This connection is used by Fusion Service to connect to Oracle Integration.

1. On the Oracle Integration home page, click Connections.

2. On the Connections page, find Survey OIC Connection.

3. Click Survey OIC Connection.

4. Enter the values as shown in the following table.

   Connection Property	Property Value
   Connection Type	REST API Base URL
   Connection URL	Enter the Oracle Integration host name URL shown in your browser's address bar. For example: https://oicapps-oicdevqa.integration.ocp.oraclecloud.com

5. In the Security region, enter your Oracle Integration User Name and Password values.

6. Verify your password is correct and click Test.

   A message appears saying the test was successful.

7. Click Save.

   A window appears listing the integrations that are using the connection.

8. Click Save on the window.

9. Click Close on the Survey Integration Oracle Integration Connection page.