Creating or editing an endpoint for Eloqua ReST API activity

Endpoints provide the configuration information that the Studio and the Integration Appliance use to connect to Eloqua platform. Eloqua ReST API uses OAuth 2.0 authentication mechanism so as to authorize users to perform operations.

Selecting or editing an Eloqua ReST API endpoint

To select or edit an Eloqua ReST API endpoint:

  1. In the Create Endpoint or Edit Endpoint pane, configure the Eloqua ReST API endpoint as described in the following table.
    Note: Changing the configuration properties of an endpoint affects all orchestrations that use that endpoint in the project. The edits are global, not local.
  2. Click Test Connection to confirm that the connection details are valid and you are able to connect to the Eloqua ReST API successfully.
  3. Click OK.
Table 1. Connection properties
Field Name Description
Login URL Login URL to connect with Eloqua endpoint.
OAuth Access Token OAuth access token generated from Eloqua ReST API for authentication.
OAuth Refresh Token OAuth refresh token generated from Eloqua ReST API while generating OAuth Access token.
Application Client ID The Client Identifier issued to the application during registration.
Application Client Secret The Client Secret issued to the application during registration.
Application Redirect URL The Redirect URL issued to the application during registration.
Note:
  • To generate the access token, refer to the Oracle Eloqua ReST API documentation relating to "OAuth2 Authentication Support in Eloqua ReST API".
  • The Login URL has default value as https://login.eloqua.com/id. It is editable and the URL format is – https://<host>:<port>/id - You can change the host, port and protocol (http/https) as needed if not using the default.
  • In the Map Input section of each activity, relevant fields of endpoint panel are available to override at runtime. You can provide data to various groups of parameters like Proxy Details, Connection Details or Authentication Details to override. Providing only partial field data in a selected group is not allowed to override.

Objects Supported by the Eloqua ReST API Connector

Eloqua ReST API connector supports the following Eloqua objects:

Table 2. Operations supported by the Eloqua objects
Eloqua Objects Create Retrieve Update Delete
Accounts Yes Yes Yes Yes
Campaigns Yes Yes Yes Yes
Contacts Yes Yes Yes Yes
Contact Lists Yes Yes Yes Yes
Contact Segments Yes Yes Yes Yes
Custom Object Data Yes Yes

Custom Objects/Custom Fields Support

Eloqua supports most of the special characters in the Name for the Custom Objects or its Fields. However, since the connector uses XML based input/output, only those Custom Objects would be supported whose names/fields contain following specific special characters:
  • . (Dot)
  • - (Hyphen)
  • _ (Underscore)
  • Space – in case of space it will be replaced by double underscore.
Note:
  • Eloqua ReST API Connector supports Custom objects/fields if names begin with a letter (alphabet) and can be followed by alphanumeric characters or followed by specific special characters Dot (.), Hyphen(-),Underscore( _ ), and Space ( ). Custom Objects having any other special characters in name/fields would be skipped in the Connector.
  • Eloqua ReST API Connector does not support Custom objects if their object/field names contains two consecutive underscore.



Feedback | Notices


Timestamp icon Last updated: Monday, 6 March 2017


http://pic.dhe.ibm.com/infocenter/wci/v7r0m0/topic/com.ibm.wci.doc/Eloq_REST_API_creating_or_editing_an_endpoin.html