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 Integration Cloud Service toolbar, click Designer.
    Description of GUID-7557A237-0437-4506-B9B6-62B88DC0C8D7-default.png follows
    Description of the illustration GUID-7557A237-0437-4506-B9B6-62B88DC0C8D7-default.png

  2. On the Designer Portal, click Connections.
    Description of GUID-DE718BE5-071A-4E11-AD6E-AA6F48EA01AC-default.png follows
    Description of the illustration GUID-DE718BE5-071A-4E11-AD6E-AA6F48EA01AC-default.png

  3. Click Create New Connection.
    Description of GUID-8CBFC9BE-8EE5-44B3-8EDC-DB4B6FB5698C-default.png follows
    Description of the illustration GUID-8CBFC9BE-8EE5-44B3-8EDC-DB4B6FB5698C-default.png
    The Create Connection — Select Adapter dialog is displayed.
  4. 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 New Connection — Information dialog is displayed.
  5. Enter the information to describe the connection. Use a meaningful name to help others find your connection when they begin to create their own integrations.
    Description of GUID-E8AD2A83-4A18-45A6-B178-505A5DA95E0E-default.png follows
    Description of the illustration GUID-E8AD2A83-4A18-45A6-B178-505A5DA95E0E-default.png

  6. Click Create.
    Your connection is created and you are now ready to configure connection details, such as email contact, connection properties, security policies, and connection login credentials.

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. In the FTP Server Host Address field, enter the host address of the FTP server.
  3. In the FTP Server Port field, enter the FTP server port number.
  4. If you are using an FTP over OpenSSL certificate, select the SSL Certificate checkbox, then click Upload to upload a .p12 format certificate.
  5. If you plan to specify a processing delay value of greater than zero when configuring the trigger FTP Adapter in the Adapter Endpoint Configuration Wizard, select your FTP server time zone from the FTP Server Time Zone dropdown list. This is because the server checks the difference in the time stamp of the file. If you do not select a time zone, the default value is that of the Oracle Integration Cloud Service server. This can delay the processing of files for up to 12 hours. For more information about specifying a processing delay, see What You See on the FTP Adapter Configure File Read Page.
  6. Click OK.
    You are now ready to configure connection security.

Configuring Connection Security

Configure security for your FTP connection by selecting the security policy and setting login credentials. An FTP connection is only allowed for publicly accessible FTP servers.

  1. Click Configure Credentials.
  2. Enter your login credentials.
    1. Note that only the FTP Server Access Policy is supported and cannot be deselected.
    2. Enter a username and password to connect to the FTP server.
    3. Reenter the password a second time.
      The FTP Adapter supports a nonmanaged connection factory.
    4. If you uploaded an FTP over OpenSSL certificate, enter the password for the .p12 format certificate.
    5. Reenter the password a second time.
  3. Click OK.
    You are now ready to test your connection.

Testing the Connection

Test your connection to ensure that it is successfully configured.

  1. In the upper right corner of the page, click Test.
    If successful, the following message is displayed and the progress indicator shows 100%.

    The connection test was successful!

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