1. Loyalty Administration Guide
  2. Configure Oracle Integration Cloud

Configure Oracle Integration Cloud

The first step in integrating CrowdTwist with Siebel Loyalty is to configure Oracle Integration Cloud (OIC).

To configure OIC

On your Oracle Integration instance, install the accelerator 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 Business Accelerator (OIC BA package: orcl.ba.siebel_loy_crowdtwist_int.1_0_0) to install, then click Get. A message confirms that the accelerator was successfully installed, and the accelerator card shows In use.

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

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

    For more information on OIC, see https://docs.oracle.com/en/cloud/paas/integration-cloud/index.html.

    Configure Oracle CrowdtwistSFTP Connection

    1. In the Connections section, click Actions on the connection, then select Edit

    2. Ftp server host address: Provide ftp hostname to this field

    3. Ftp server port: Provide ftp port to this field

    4. In Optional properties, choose whether the SFTP is Yes or No

    5. Choose Security policy as FTP Server Access Policy

    6. User name: Enter user name which has access to the FTP

    7. Password: Enter password for the user

    8. Click on Test and Save

    9. For more information regarding FTP Adapter and/or Connection please visit: https://docs.oracle.com/en/cloud/paas/integration-cloud/ftp-adapter/index.html

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

    Configure Oracle REST Trigger Connection

    1. In the Connections section, click Actions

    2. On the connection, then select Edit

    3. Security : OAuth 2.0 Or Basic Authentication

    4. Click on Test and Save.

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

    Configure Oracle SiebelLoyRest Connection
    1. In the Connections section, click Actions
    2. on the connection, then select Edit.
    3. Connection Type: REST API Base URL
    4. Connection URL: <Enter the Siebel Base URL>
    5. Security : Basic Authentication
    6. Enter Username and Password
    7. Click Test and Save

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

    Configure Oracle CrowdtwistRest Connection
    1. In the Connections section, click Actions
    2. on the connection, then select Edit.
    3. Connection Type: REST API Base URL
    4. Connection URL: <Enter the Siebel Base URL>
    5. Security : API Key Based Authentication
    6. Enter API Key
    7. Click Test and Save

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

    Configure Oracle ReadObjectStorage Connection

    Connection Type REST API Base URL
    Connection URL

    https://objectstorage.%3Cregion%3E.oraclecloud.com
    Security OCI Signature Version 1
    Tenancy OCID https://docs.cloud.oracle.com/en-us/iaas/Content/API/Concepts/apisigningkey.htm#five
    User OCID https://docs.cloud.oracle.com/en-us/iaas/Content/API/Concepts/apisigningkey.htm#five
    Private Key The private key from the previous step
    Fingerprint https://docs.cloud.oracle.com/en-us/iaas/Content/API/Concepts/apisigningkey.htm#three

  4. Edit the ORCL-BRT-SIEBEL_LOY_CROWDTWIST_CONFIG_SETTINGS lookup to update the notification list in case of failures. The default OIC settings for this lookup are shown in the following table.

    Name Description Sample Value

    email

    Notification Email List in case of Errors in OIC flow.

    abc@oracle.com, def@oracle.com

    Default CT User Country Code

    Default Country code populated during CT User Creation if no Country is provided for Siebel Loyalty Member.

    IN

    Default CT User Postal Code

    Default Postal code populated during CT User Creation if no postal code is provided for US Siebel Loyalty Member citizen.

    99790

    Default CT User City ID

    Default City ID populated during CT User Creation if no city is provided for non-US Siebel Loyalty Member citizen.

    1157219

    Default CT Email Domain

    Email domain to be appended to Member Number as CT User Email if no email is provided for Siebel Loyalty Member.

    @oracle.com

  5. Edit ORCL-BRT-PRODUCT_TO_REWARD_LOOKUP to map the Siebel Product Id to the CrowdTwist Reward Variation ID.

  6. Use the ORCL-BRT-SIEBEL_LOY_CROWDTWIST_COUNTRY_CODES lookup to convert Siebel country codes to CrowdTwist country codes.

  7. If a non-US country code is used but no city is provided, the capital city of the input country is picked up by default as the city code for the CrowdTwist user create/update operation. The mapping for same is located in ORCL-BRT-SIEBEL_LOY_CROWDTWIST_COUNTRY_CAPITALS.

  8. Activate and Run the Accelerator

After you have configured the connections and other resources, activate the accelerator and run it.

  1. In the project workspace, click Activate. In the Activate project panel, with the default project deployment selected, choose an appropriate tracing option, then click Activate.

    A message confirms that the integration(s) has been activated. Refresh the page to view the updated status of the integration(s).

  2. Run the accelerator.

    Case 1 - For App-driven accelerators:

    • For app-driven accelerators, provide steps to trigger the accelerator’s integration flow from the external application.
  3. Monitor the running of the integration flow(s) in Oracle Integration.
    1. In the project workspace, click Observe. You can see the integration flow(s) being triggered and running successfully.
    2. To manage errors in your project, see Manage Errors in a Project.