Configuring Eloqua for Access to the WebCenter Sites Content Service

Before marketers can embed existing WebCenter Sites content into Eloqua e-mails and landing pages, you must configure your Eloqua instance to communicate with the WebCenter Sites content service. The example URLs below assume the default servlet path of /cs/ContentServer - adjust your URLs as appropriate for your environment. Also, if you have not already done so, create a new provider in Eloqua to separate the WebCenter Sites content service from other services and applications.

Note:

Your WebCenter Sites instance must be configured to accept HTTPS connections. Only ports 443 and 8443 are supported. All URLs, property names, and their values are case-sensitive.

To configure Eloqua for accessing the WebCenter Sites Content Service, you must do the following:

1. Log into the target Eloqua site as its administrator.
2. In the top bar, click Settings and select AppCloud Developer.
3. Click Create New App and fill in the form that appears as follows:

   Table 24-1 Create New App Fields

   Field	Value
   Icon URL	https://wcs-instance.company.com/cs/images/eloqua/AppIcon.png
   Enable URL	https://wcs-instance.company.com/cs/ContentServer?pagename= EloquaIntegration/Enable&installId={InstallId}&appId={AppId}& callbackUrl={CallbackUrl}
   Status URL	https://wcs-instance.company.com/cs/ContentServer?pagename= EloquaIntegration/SitesStatus
   Callback URL	https://wcs-instance.company.com/cs/ContentServer?pagename= EloquaIntegration/Enable

4. Click Save App to save your changes.
5. In the App Details page that appears, click Show Secret in the OAuth section, copy the client secret value displayed in the pop-up, and save it to a text file. (You need this value to configure the authentication of Eloqua requests within WebCenter Sites later in this guide.)
6. In the Services section click Add Service, and then click Content in the pop-up that appears.
7. Fill in the fields in the Content Service Details form as follows:

   Table 24-2 Content Service Details Fields

   Field	Value
   Icon URL	https://wcs-instance.company.com/cs/images/eloqua/ ContentServiceIcon.png
   Create URL	https://wcs-instance.company.com/cs/ContentServer?pagename= EloquaIntegration/Instances/Add&instanceId={InstanceId}
   Configure URL	https://wcs-instance.company.com/cs/ContentServer?pagename= EloquaIntegration/ContentSearch&instanceId={InstanceId}& installId={InstallId}
   Delete URL	https://wcs-instance.company.com/cs/ContentServer?pagename= EloquaIntegration/Instances/Delete&instanceId={InstanceId}
   Copy URL	https://wcs-instance.company.com/cs/ContentServer?pagename= EloquaIntegration/Instances/Copy&instanceId={InstanceId}& originalInstanceId={OriginalInstanceId}
   Layout	Flow Flow layout mode allows the embedded content to be dynamically resized.
   Max-records	The maximum number of rendered assets passed from WebCenter Sites to Eloqua in a single call. Oracle recommends a value below 5000; however, if you experience issues with passing very large pieces of content, lower this value. For more information, consult Eloqua documentation.
   Content-type	application/json
   Landing Page Notification URL	(Optional) To make WebCenter Sites content available in Eloqua landing pages: https://wcs-instance.company.com/cs/ContentServer?pagename= EloquaIntegration/Processor/LandingPageNotification&instanceId= {InstanceId}&installId={InstallId}&executionId={ExecutionId}
   E-mail Page Notification URL	(Optional) To make WebCenter Sites content available in Eloqua e-mails: https://wcs-instance.company.com/cs/ContentServer?pagename= EloquaIntegration/Processor/EmailNotification&instanceId= {InstanceId}

   Fill in the remaining fields as appropriate for your environment, then click Save to commit your changes.
8. Save your changes and return to the WebCenter Sites content service properties page.
9. Click the link in the Catalog section to add the WebCenter Sites content service to your cloud service catalog. When prompted, click Accept.
10. Install the WebCenter Sites cloud service into your Eloqua instance.
    This makes it available within the Eloqua marketer interface for the target Eloqua instance only.
    1. In the Eloqua interface, click Settings, and then select Setup.
    2. Click AppCloud Catalog.
    3. Select the Catalog tab to display the list of available (but not installed) services.
    4. Locate your target application and click Install.

    Note:

    To maintain security within your Eloqua instance, do not publish the WebCenter Sites content service.