Create SOAP and REST Connection in Oracle Integration Cloud Service

SOAP Connection:

Steps to create SOAP Connection in Oracle Integration Cloud Service using external WSDL file :

ICS provides a SOAP adapter that allows us to create a SOAP connection with an external WSDL file.

Prerequisites :

External WSDL file or sample WSDL file such as below ( The Schema should be part of the WSDL, OIC does not support separate schema file configuration).

<?xml version="1.0" encoding="UTF-8" ?>

<definitions targetNamespace="urn:HelloWorldWSDL" xmlns="http://schemas.xmlsoap.org/wsdl/" xmlns:tns="urn:HelloWorldWSDL"

             xmlns:soap12="http://schemas.xmlsoap.org/wsdl/soap12/" xmlns:mime="http://schemas.xmlsoap.org/wsdl/mime/"

             xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/wsdl/soap/"

             xmlns:ex="http://www.example.org">

  <types>

    <xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns="http://www.example.org"

            targetNamespace="http://www.example.org" elementFormDefault="qualified">

  <xsd:element name="request">

    <xsd:complexType>

      <xsd:sequence>

        <xsd:element name="request" type="xsd:string"/>

      </xsd:sequence>

    </xsd:complexType>

  </xsd:element>

  <xsd:element name="response">

    <xsd:complexType>

      <xsd:sequence>

        <xsd:element name="response" type="xsd:string"/>

      </xsd:sequence>

    </xsd:complexType>

  </xsd:element>

  <xsd:element name="fault">

    <xsd:complexType>

      <xsd:sequence>

        <xsd:element name="error" type="xsd:string"/>

      </xsd:sequence>

    </xsd:complexType>

  </xsd:element>

</xsd:schema>

  </types>

  <message name="HelloWorldServicePort_request">

    <part name="part" element="ex:request"/>

  </message>

  <message name="HelloWorldServicePort_response">

    <part name="part" element="ex:response"/>

  </message>

  <message name="HelloWorldServiceFault">

    <part name="part" element="ex:fault"/>

  </message>

  <portType name="HelloWorldServicePort">

    <operation name="HelloWorldOperation">

      <input message="tns:HelloWorldServicePort_request"/>

      <output message="tns:HelloWorldServicePort_response"/>

      <fault name="HelloWorldFault" message="tns:HelloWorldServiceFault"/>    

    </operation>

  </portType>

</definitions>

1. Click on Connections from Designer View in Oracle Integration Cloud Service.

2.Click on Create.

3. Search for SOAP Adapter -> and Select the SOAP Connection.

4. Enter below information and click on Create button

•                 Name: Any meaningful name of your choice
•                 Identifier: Identifier would be picked up automatically from                                        the  Name, however, we can update this
•                  Role: Select Trigger and Invoke
•                  Description: Optional description

5. Click on Configure Connectivity and upload the WSDL url file. ( Sample WSDL is attached above, save it as HelloWorldService.wsdl) and use it to upload.

6. Next, Click on Configure Security and enter the ICS login credentials ( username and password). Click OK after entering the credentials.

7. Next the Connection configuration page will show Progress as 85 % 

8. Click on Test -> Validate and Test . If the credentials and the WSDL file is valid, the connection configuration page will show that the test was successful and progress will be 100%

REST connection:

Below are the simple steps to create REST connection

• Login to the ICS console

• Move to the home page

• Click on Connection

• Click on the Create button from the upper right corner

• Search REST and select REST Adapter

• Enter Name as TEST_REST_Conn and select Trigger from Role type drop down. We have selected Trigger as we want to expose this REST connection as a REST service. Means this will work as an endpoint for the end user

• As this is the Trigger REST connection, you don’t need to configure anything in this. Leave all as it is. And click on Test button in the upper right corner. If everything goes fine, the progress bar will reach 100%

• Click Save and Close button from the upper right corner