Creating Connections

You define connections to the specific cloud applications that you want to integrate. The following topics describe how to define connections:

Creating a Connection

The first step in creating an integration is to create the connections to the applications with which you want to share data.

  1. In the Oracle Integration Cloud Service home page, click Connections.
  2. Click Create.
    The Create Connection — Select Adapter dialog is displayed.
  3. Select an adapter from the dialog. You can also search for the type of adapter to use by entering a partial or full name in the Search field, and clicking Search.
    The Create New Connection dialog is displayed.
  4. Enter the information to describe the connection.
    • Enter a meaningful name to help others find your connection when they begin to create their own integrations. The name you enter is automatically added in capital letters to the Identifier field. If you modify the identifier name, do not include a blank space (for example, Sales Opportunity).

    • Select the role (direction) in which to use this connection (trigger, invoke, or both). Only the roles supported by this adapter are displayed for selection. When you select a role, only the connection properties and security policies appropriate to that role are displayed on the Connections page. If you select an adapter that supports both invoke and trigger, but select only one of those roles, then try to drag the adapter into the section you did not select, you receive an error (for example, configure an Oracle RightNow Cloud Adapter as only an invoke, but drag the adapter to the trigger section).

    • Enter an optional description of the connection.


    Description of create_new_connection.png follows
    Description of the illustration create_new_connection.png
  5. Click Create.
    Your connection is created and you are now ready to configure connection details, such as email contact, connection properties, security policies, connection login credentials, and (for certain connections) agent group.

Adding a Contact Email

From the Connection Administrator section of the connection, you can add a contact email address for notifications.

  1. In the Email Address field, enter an email address to receive email notifications when problems occur.
  2. In the upper right corner, click Save.

Configuring Connection Properties

Enter connection information so your application can process requests.

  1. Click Configure Connectivity.
    The Connection Properties dialog is displayed.
  2. See the following sections for information about specifying connection properties.
    Adapter For Information
    Adobe eSign Adapter Using the Adobe eSign Adapter
    Concur Adapter Using the Concur Adapter

    DB2 Adapter

    Using the DB2 Adapter
    DocuSign Adapter Using the DocuSign Adapter
    Eventbrite Adapter Using the Eventbrite Adapter
    Evernote Adapter Using the Evernote Adapter
    Facebook Adapter Using the Facebook Adapter
    File Adapter Using the File Adapter
    FTP Adapter Using the FTP Adapter
    Gmail Adapter Using the Gmail Adapter
    Google Calendar Adapter Using the Google Calendar Adapter
    Google Task Adapter Using the Google Task Adapter
    JMS Adapter Using the JMS Adapter
    LinkedIn Adapter Using the LinkedIn Adapter
    Microsoft Calendar Adapter Using the Microsoft Calendar Adapter
    Microsoft Contact Adapter Using the Microsoft Contact Adapter
    Microsoft Email Adapter Using the Microsoft Email Adapter
    Microsoft SQL Server Adapter Using the Microsoft SQL Server Adapter
    MailChimp Adapter Using the MailChimp Adapter
    MySQL Adapter Using the MySQL Adapter
    Oracle Advanced Queuing (AQ) Adapter Using the Oracle Advanced Queuing (AQ) Adapter
    Oracle Commerce Cloud Adapter Using the Oracle Commerce Cloud Adapter
    Oracle CPQ Cloud Adapter Using the Oracle CPQ Adapter
    Oracle Database Adapter Using the Oracle Database Adapter
    Oracle E-Business Suite Adapter Using Oracle E-Business Suite Adapter
    Oracle Field Service Adapter Using Oracle Field Service Adapter
    Oracle Eloqua Cloud Adapter N/A
    Oracle ERP Cloud Adapter Using the Oracle ERP Cloud Adapter
    Oracle HCM Cloud Adapter Using the Oracle HCM Cloud Adapter
    Oracle JD Edwards EnterpriseOne Adapter Using the Oracle JD Edwards EnterpriseOne Adapter
    Oracle Logistics Adapter Using the Oracle Logistics Adapter
    Oracle NetSuite Adapter Using the Oracle NetSuite Adapter
    Oracle Messaging Cloud Service Adapter Using the Oracle Messaging Cloud Service Adapter
    Oracle Responsys Adapter Using the Oracle Responsys Adapter
    Oracle RightNow Cloud Adapter Using the Oracle RightNow Cloud Adapter
    Oracle Sales Cloud Adapter Using the Oracle Sales Cloud Adapter
    Oracle Siebel Adapter Using the Oracle Siebel Adapter
    Oracle Utilities Adapter Using the Oracle Utilities Adapter
    REST Adapter Using the REST Adapter
    Salesforce Adapter Using the Salesforce Adapter
    SAP Adapter Using the SAP Adapter
    SAP Ariba Adapter Using the SAP Ariba Adapter
    ServiceNow Adapter Using the ServiceNow Adapter
    Oracle SOAP Adapter Using the SOAP Adapter
    SuccessFactors Adapter Using the SuccessFactors Adapter
    SurveyMonkey Adapter Using the SurveyMonkey Adapter
    Trello Adapter Using the Trello Adapter
    Twilio Adapter Using the Twilio Adapter
    Twitter Adapter Using the Twitter Adapter
    Workday Adapter Using the Workday Adapter
  3. Click OK.
    You are now ready to configure connection security.

Configuring Connection Security

Configure security for your connection by selecting the security policy and specifying login credentials.

  1. Click Configure Security.
  2. See the following sections for information about selecting the security policy and entering your login credentials.
    Adapter For Information
    Adobe eSign Adapter Using the Adobe eSign Adapter
    Concur Adapter Using the Concur Adapter

    DB2 Adapter

    Using the DB2 Adapter
    DocuSign Adapter Using the DocuSign Adapter
    Eventbrite Adapter Using the Eventbrite Adapter
    Evernote Adapter Using the Evernote Adapter
    Facebook Adapter Using the Facebook Adapter
    File Adapter NA
    FTP Adapter Using the FTP Adapter
    Gmail Adapter Using the Gmail Adapter
    Google Calendar Adapter Using the Google Calendar Adapter
    Google Task Adapter Using the Google Task Adapter
    Oracle JD Edwards EnterpriseOne Adapter Using the JD Edwards EnterpriseOne Adapter
    JMS Adapter Using the JMS Adapter
    LinkedIn Adapter Using the LinkedIn Adapter
    Microsoft Calendar Adapter Using the Microsoft Calendar Adapter
    Microsoft Contact Adapter Using the Microsoft Contact Adapter
    Microsoft Email Adapter Using the Microsoft Email Adapter
    Microsoft SQL Server Adapter Using the Microsoft SQL Server Adapter
    MailChimp Adapter Using the MailChimp Adapter
    MySQL Adapter Using the MySQL Adapter
    Oracle Advanced Queuing (AQ) Adapter Using the Oracle Advanced Queuing (AQ) Adapter
    Oracle Commerce Cloud Adapter Using the Oracle Commerce Cloud Adapter
    Oracle CPQ Cloud Adapter Using the Oracle CPQ Adapter
    Oracle NetSuite Adapter Using the Oracle NetSuite Adapter
    Oracle Database Adapter Using the Oracle Database Adapter
    Oracle E-Business Suite Adapter Using Oracle E-Business Suite Adapter
    Oracle Field Service Adapter Using Oracle Field Service Adapter
    Oracle Eloqua Cloud Adapter Using the Oracle Eloqua Cloud Adapter
    Oracle ERP Cloud Adapter Using the Oracle ERP Cloud Adapter
    Oracle HCM Cloud Adapter Using the Oracle HCM Cloud Adapter
    Oracle Logistics Adapter Using the Oracle Logistics Adapter
    Oracle Messaging Cloud Service Adapter Using the Oracle Messaging Cloud Service Adapter
    Oracle Responsys Adapter Using the Oracle Responsys Adapter
    Oracle RightNow Cloud Adapter Using the Oracle RightNow Cloud Adapter
    Oracle Sales Cloud Adapter Using the Oracle Sales Cloud Adapter
    Oracle Siebel Adapter Using the Oracle Siebel Adapter
    REST Adapter Using the REST Adapter
    Salesforce Adapter Using the Salesforce Adapter
    SAP Adapter Using the SAP Adapter
    SAP Ariba Adapter Using the SAP Ariba Adapter
    ServiceNow Adapter Using the ServiceNow Adapter
    SuccessFactors Adapter Using the SuccessFactors Adapter
    Oracle SOAP Adapter Using the SOAP Adapter
    SurveyMonkey Adapter Using the SurveyMonkey Adapter
    Trello Adapter Using the Trello Adapter
    Twilio Adapter Using the Twilio Adapter
    Twitter Adapter Using the Twitter Adapter
    Workday Adapter Using the Workday Adapter
  3. Click OK.
    For most adapters, you are now ready to test your connection. For some adapters, you must first configure an agent group.

Testing the Connection

Test your connection to ensure that it is successfully configured.

  1. In the upper right corner of the page, click Test.
  2. Select the type of connection testing to perform:
    • Validate and Test: Performs a full validation of the WSDL, including processing of the imported schemas and WSDLs. Complete validation can take several minutes depending on the number of imported schemas and WSDLs. No requests are sent to the operations exposed in the WSDL.

    • Test: Connects to the WSDL URL and performs a syntax check on the WSDL. No requests are sent to the operations exposed in the WSDL.

    If successful, the following message is displayed and the progress indicator shows 100%.

    Connection connection_name was tested successfully.

  3. If your connection was unsuccessful, an error message is displayed with details. Verify that the configuration details you entered are correct.
  4. When complete, click Save, then click Close.

Editing a Connection

You can edit connection settings after creating a new connection.

  1. On the Oracle Integration Cloud Service home page, click Connections.
  2. On the Connections page, search for the connection name.
  3. Select Edit from the connection Actions menu or click the connection name.
    Description of conn_actions_menu.png follows
    Description of the illustration conn_actions_menu.png
    The Connection page is displayed.
  4. Make any necessary edits.
    If you edit a connection currently used by an active integration, a dialog is displayed indicating that you must re-activate the integration for the connection updates to take effect.
    Description of edit_connection.png follows
    Description of the illustration edit_connection.png

Cloning a Connection

You can clone a copy of an existing connection, even if the connection is locked. This provides a quick way to create a new connection.

  1. On the Oracle Integration Cloud Service home page, click Connections.
  2. On the Connections page, search for the connection name.
  3. Select Clone from the connection Actions menu.
    Description of conn_actions_menu.png follows
    Description of the illustration conn_actions_menu.png
    The Clone Connection dialog is displayed.
  4. Enter the connection information.
  5. Click Clone.
  6. Click Edit to configure the credentials of your cloned connection. Cloning a connection does not copy the credentials.
See Editing a Connection for instructions.

Deleting a Connection

You can delete a connection from the connection menu.

  1. On the Oracle Integration Cloud Service home page, click Connections.
  2. On the Connections page, search for the connection name.
  3. Click Delete from the connection Actions menu.
    Description of conn_actions_menu.png follows
    Description of the illustration conn_actions_menu.png
    The Delete Connection dialog is displayed if the connection is not used in an integration.
  4. Click Yes to confirm deletion.

Unlocking a Connection

When a connection is in edit mode and the browser crashes, the connection becomes locked, which prevents it from being edited.

To unlock the connection:

  1. Log in again as the same user who was editing the connection when the browser crashed, then log out.

    For example, if you were logged in as icsdeveloper when the browser crashed, log in again as icsdeveloper, and log out. This action unlocks the connection.

or

  1. Log in as a user with the Administrators role.

  2. On the Oracle Integration Cloud Service home page, click the Connections diagram.

  3. For the connection that is locked, click the hamburger menu menu at the far right, then select Unlock.

Refreshing Integration Metadata

You can manually refresh the currently-cached metadata available to adapters that have implemented metadata caching. Metadata changes typically relate to customizations of integrations, such as adding custom objects and attributes to integrations. There may also be cases in which integrations have been patched, which results in additional custom objects and attributes being added. This option is similar to clearing the cache in your browser. Without a manual refresh, a staleness check is only performed when you drag a connection into an integration. This is typically sufficient, but in some cases you may know that a refresh is required. For these cases, the Refresh Metadata menu option is provided.

To refresh integration metadata:

Note:

The Refresh Metadata menu option is only available with adapters that have implemented metadata caching.
  1. On the Oracle Integration Cloud Service home page, click Connections.
  2. Locate the connection to refresh.
  3. From the menu at the right, select Refresh Metadata.
    Description of conn_actions_menu.png follows
    Description of the illustration conn_actions_menu.png
    A message is displayed indicating that the refresh was successful.
    Metadata refresh for connection "connection_type" has been initiated successfully.