Oracle Integration Cloud Service (OICS) – Part 2 

Oracle Integration Cloud Service

In the previous blog on Oracle Integration Cloud Service, we guided you through building a basic integration, connecting with SOAP-based web services, and mapping data. Now, we’ll take it a step further by exploring advanced configurations to enhance your integration workflows. Now we will create an integration that utilises three generic SOAP web services for message transmission in Oracle Integration Cloud Service. You will configure WSDL files for each service, including: 

  • A request message 
  • A response message 
  • An enrichment response message 

Once the WSDL setup is complete, you will use the mapper to connect data fields by dragging and dropping them from the trigger/source structure of one web service to the invoke/target structure of another. After mapping the data, you will activate the integration and monitor message interactions. Additionally, you will create a cloned version of the integration, allowing for further customisation as needed. 

Cloning an Integration 

Now that you have created the Hello World integration, you can proceed with cloning it. This process duplicates the integration flow, preserving all connections and data mappings. While you will assign a new name and version number to the cloned integration, the rest of the configuration remains unchanged. Once the cloning is complete, you can modify and customise the integration as needed in Oracle Integration Cloud Service.

  1. Choose Clone from the menu. The Clone Integration dialog will appear. 
Cloning an Integration Step 1
  1. Enter a unique name and version number different from the original integration, then select Clone
FieldEnter
Integration NameHello_World_Enrichment_A2f49138
IdentifierAutomatically generated from the integration name
VersionEnter, a different version number. For example, if you enter 2, the value is automatically changed. Identifier  to 02.00.0000 to follow the required naming convention.
Package NameNothing to enter.
DescriptionThis test case will demonstrate how to clone a completed integration.

The following dialog appears: 

Cloning an Integration Step 2

The cloned integration is shown at the top, but it remains inactive. 

Cloning an Integration Step 2
  1. Select the integration to start making customisations. In this example, we will enhance the integration flow with response enrichment. 
Cloning an Integration Step 3

Take your expertise to the next level with our
Oracle Integration Cloud Service (OICS) Training

Add Enrichment to the Cloned Integration 

  1. If the Technologies palette is not visible on the right, click the Show Palette icon. 
Adding Enrichment to the Cloned Integration Step 1
  1. From the Technologies palette, drag the “SayHello_A2f_49_138” SOAP Connection onto the response arrow icon. A dialog will appear to create the enrichment response SOAP web service. 
Adding Enrichment to the Cloned Integration Step 2
  1. Enter the following details and click Next.
FieldEnter
What do you want to call your endpoint?AddVisitTimeDetails

Adding Enrichment to the Cloned Integration Step 3

Choose the “visitTimeStampDetails” operation, then click Next and Done

Adding Enrichment to the Cloned Integration Step 3
Adding Enrichment to the Cloned Integration Step 3
Adding Enrichment to the Cloned Integration Step 3

A prompt will appear: “This will delete any impacted mapping(s). Are you sure you want to continue?” 

Adding Enrichment to the Cloned Integration Step 3

Click Yes to proceed. The integration flow will look as follows: 

Adding Enrichment to the Cloned Integration Step 3

4. Click Save

Map Data Between Trigger/Source & Invoke/Target in Oracle Integration Cloud Service

  1. Select the Response Enrichment Mapping icon located between the trigger/source and invoke/target to open the mapper. 
Map Data Between Trigger/Source & Invoke/Target Step 1
  1. Map the relevant source field to the invoke/target field
Trigger/SourceField Invoke/Target Field
sayHelloResponse > SayHelloReturnvisitTimestampReq > reqMsg

Drag the trigger/source field onto the invoke/target field, ensuring the text of both fields aligns. If the mapping is successful, the UI will appear as shown: 

Map Data Between Trigger/Source & Invoke/Target Step 2
  1. Click Save, then select Exit Mapper. The Response Enrichment Mapping icon will turn green, indicating it has been configured. 
  1. Click the Response Mapping icon and remove the previous mapping (if it was not deleted in the earlier step).  
Map Data Between Trigger/Source & Invoke/Target Step 4
Map Data Between Trigger/Source & Invoke/Target Step 4

  1. Click the Response Mapping icon to open the mapper once more. This step is necessary due to the enrichment response mapping you applied earlier. 
Map Data Between Trigger/Source & Invoke/Target Step 5
  1. Map the specified trigger/source field to the invoke/target field.
Trigger/Source FieldInvoke/Target Field
$ResponseEnrichmentApplicationObject >visitTimestampResp > respMsgGreetResponse > Greeting

Drag the trigger/source field over the invoke/target field, ensuring both texts align. If the mapping is successful, the UI will appear as shown: 

Map Data Between Trigger/Source & Invoke/Target Step 6
  1. Click Save, then select Exit Mapper. The Response Mapping icon will turn green, indicating it has been successfully configured. 
Map Data Between Trigger/Source & Invoke/Target Step 7
  1. Select Exit Integration
  2. Click Activate to enable the integration. 
Map Data Between Trigger/Source & Invoke/Target Step 9
  1. When prompted, click Yes to confirm and choose Enable tracing, including payload into Activity Stream, as shown in the dialog below. 
Map Data Between Trigger/Source & Invoke/Target Step 10

The integration status will update to Active TRACE ENABLED, allowing visibility of message logs in the Monitoring screens as messages are processed through ICS. 

Map Data Between Trigger/Source & Invoke/Target Step 10
  1. Click the information icon to view integration details. The endpoint URL provided here is necessary for testing the integration. 
Map Data Between Trigger/Source & Invoke/Target Step 11

End Point URL : https://ics21-usoracle72468.integration.us2.oraclecloud.com/integration/flowsvc/soap/HELLO_WORLD_ENRICHME_A2F49138/v02/?wsdl 

Test Cloned Integration in Oracle Integration Cloud Service

Please refer to the detailed steps in Lab1. The high-level steps are outlined below: 

  1. Create a SOAPUI project using the ICS service endpoint URL provided above. 
Test Cloned Integration Step 1

a. Modify the payload by including a value for FirstName

Test Cloned Integration Step 1

b. Implement basic authentication with the credentials given to you. 

Test Cloned Integration Step 1

c. Add Timestamp Details

d. Test the service. 

The request-response sample from SOAP UI should appear as shown below: 

Test Cloned Integration Step 1

Monitoring Oracle Integration Cloud Service

  1. Navigate back to the Oracle Integration Cloud Service user interface. 
  1. Select Monitoring in the top-right corner. You will see details for the Hello World Enrichment Use Case integration, along with any other activated integrations. 
Monitoring Oracle Integration Cloud Service Step 2
  1. Click the Runtime Health tab to view activity stream details regarding the message flow. 
Monitoring Oracle Integration Cloud Service Step 3

Conclusion 

In this blog on Oracle Integration Cloud Service, we explored the process of cloning an integration, enriching a message with a SOAP web service, and mapping data between the respective web service data structures. We also covered how to activate and monitor the integration in Oracle Integration Cloud Service, ensuring that each step is seamlessly executed for efficient data management and integration monitoring.

Author: Kashif Baksh is a Senior Principal Consultant at Fusion Practices

Similar Posts

Leave a Reply

Your email address will not be published. Required fields are marked *