Build Your First Integration from Scratch | TEMPERATURE CONVERTER APPLICATION | ORACLE INTEGRATION GENERATION 3

In this article I have mentioned the steps to create, design, activate, run an integration completely from scratch in Oracle Integration Gen 3. This article helps you to understand the new Gen 3 UI (user interface) and some of its new features.

Use Case - Develop an Integration which will convert ℃ (Celsius) temperature into ℉ (Fahrenheit). 

Prerequisites Temperature Converter Service WSDL URL: 

http://webservices.daehosting.com/services/temperatureconversions.wso?WSDL

Click on Image for Better View

- Advertisement -

Let's Develop the Integration in Oracle Integration Generation 3 Instance:

STEP 1: Create a Project.

Knowledge:  👀 

Projects? It Enables you to manage the entire life cycle of an integration from within a project. Your project contains sections for creating, designing, deploying, and monitoring your integration resources (integrations, connections, lookups, and JavaScript libraries)

• Login to OIC Generation 3 Instance. In the navigation pane, click Projects.

• Click Add, then select Create

• In the Name field, enter 'My Temperature Converter Project' (you can enter any meaningful name). Leave all remaining fields as they are, then click Create.

The page for your project is displayed. 👇

 

- Advertisement -

STEP 2: Create an Integration. Let's now create an integration inside the project

• In the Integrations section, click Add. The Add integration panel opens.

• Click Create, then select Application

• In the Name field, enter 'Celsius to Fahrenheit' (you can enter any meaningful name). Leave all remaining fields as they are, then click Create.

• The integration canvas opens with an option for creating a trigger connection. The trigger connection enables your integration to receive inbound messages from an application.

Note: 🖉

As you design this integration, an error icon can appear on the right side of the page. Errors may occur due to mistakes you make in the mapper or Adapter Endpoint Configuration Wizard. Other errors that appear are resolved as you complete the design of all parts of this integration. Click the error icon to view details. To resolve the error, you can either follow the instructions in the Error panel or wait to see if your completed design resolves the issues. Click outside the Error panel to close it.

- Advertisement -

STEP 3: Create a Trigger Connection to Define a Celsius Parameter and the Content of the Temperature Converter Response (i.e. Fahrenheit).

Let's now create a trigger connection inside the integration canvas. The trigger (source) connection allows you to define a Celsius parameter and the content of the Temperature Converter Response to receive back from the Temperature Converter application (city, latitude, longitude, and other content).

• In the Connections panel of the integration canvas, click Add trigger.

  The Create connection panel opens. Enter REST in the search Filed

• Select REST as the adapter connection to use.

• The page for configuring the REST Adapter opens. Enter the below information
• Name - 'Temperature Converter' (you can enter any meaningful name)
• Role - Select Trigger 

Knowledge:  👀 

Roles perform the following tasks.

Trigger: Enables an inbound application (endpoint) to trigger (run) the integration.

Invoke: Enables your integration to invoke an outbound application (endpoint).

Trigger and Invoke: Enables you to create a connection that can be used as both a trigger and invoke. For example, you use the connection as a trigger in one integration and as an invoke in another integration.

• Leave all remaining fields as they are, then click Create. The page for configuring security and delivery methods for the REST Adapter trigger connection appears.
• Enter below details:
• Security - Select OAuth 2.0 to secure incoming messages.
• Access type - Ensure Public gateway is selected. This access type uses the public internet to receive messages.

Click Test to confirm that you configured the connection successfully. When testing completes, a success message is displayed. Configuration progress is now 100% complete. Click Save. Click Back  to return to the integration canvas. A menu shows that the newly created connection is available for selection

• Let's now configure the REST Adapter trigger connection in the integration. During configuration, you specify details such as the operation, the relative resource URI, the query parameters, and the message payload content.
• In the integration canvas, click the Temperature Converter connection shown in the menu. The Basic Info page of the Adapter Endpoint Configuration Wizard opens.
• In the What do you want to call your endpoint field, enter 'GetTemperatureInFahrenheit', then click Continu to access the Resource Configuration page.

• Enter below details:
• What is the endpoint's relative resource URI: Enter /CelsiusToFahrenheit
• What action do you want to perform on the endpoint: Select GET.
• Select any options that you want to configure, select the following options:

☑️Add and review parameters for this endpoint

☑️Configure this endpoint to receive the response

Leave all remaining fields as they are. The completed Resource Configuration page looks as below. Click Continue to access the Request Parameter Page.

 

 

• In the Specify Query Parameters section, click Add. Double-click the row in the Name column to enter a value.

 

• Enter Celsius, then select string from the Data Type list

 

- Advertisement -

Note 🖉

At runtime, you specify the Celsius on the Configure and run page to receive a Temperature in Fahrenheit.

• Click Continue to access the Response page. Enter the below Information
• Select the response payload format - Select JSON Sample.
• <<< inline >>> Click this field and enter the following content, then click OK.

{

             "CelsiusToFahrenheitResult": "124"

          }

• Element - Ensure response-wrapper is selected.
• What is the media-type of Response Body - Ensure JSON is selected.

• The completed Response page looks as follows. Click Continue to access the Summary page.

• Review your selections, then click Finish.

The REST Adapter trigger connection is now fully configured for use in the integration. A map action is also automatically created for mapping data between the trigger connection and the invoke connection that you create in the next section.

STEP4: Create an Invoke Connection to Call the Temperature Converter Application.

Let's now create an invoke connection inside the integration canvas to call the Temperature Converter Application and receive value of temperature in Fahrenheit.

• In the right pane, click Invokes . The Create connection panel opens.

• Click Create Connection  to create a new connection.

• The Create connection panel opens. Enter SOAP in the search field. Select SOAP as the adapter connection to use. This SOAP Adapter connection will invoke the Temperature Converter Application.

• Enter the following Information:
• Name - Enter Temperature Converter Service
• Role - Select Invoke. This role enables your integration to invoke the Temperature Converter Application

Leave all remaining fields as they are, then click Create.

The page for configuring security and delivery methods for the REST Adapter invoke connection appears.

 

•  Enter the following information
• Properties - Paste the Temperature Converter Application WSDL URL
• Security Policy - Select No security Policy
• Access Type - Select Public gateway. This access type uses the public internet to send messages.

• Click Test and then click Validate and test to confirm that you configured the connection successfully.

• Click Save.

• Click Back  to return to the integration canvas.

Let's now configure the SOAP Adapter invoke connection in the integration to Covert the Temperature in Celsius into Fahrenheit which you specify when running the integration. During configuration, you specify details such as the operation, the relative resource URI, the query parameters, and the message payload content.

• Drag your cursor along the line below the GetTemperatureInFahrenheit trigger until the Add  icon appears. Select Invokes, then select the Temperature converter Service connection.

• The Adapter Endpoint Configuration Wizard opens. Enter the following information
• What do you want to call your endpoint - Enter ConvertCelsiusToFahrenheit

Click Continue

 

• Edit Operations page appears. Enter the following information
• Select the Port - select TemperatureConversionSoap
• Select the Operation - select CelsiusToFahrenheit

Click Continue

 

 

• Configure Headers page appears. Leave the configuration as they are, click Continue. 

• Summary page appears. Review your selections, then click Done.

- Advertisement -

STEP 5:  We have successfully created and configure the REST Trigger and SOAP Invoke connection. Let's now configure the mappers.

• Double-click the First map i.e. ConvertCelsiusToFahrenheit or you can simply select the mapper, right click and click Edit.

• The mapper opens. In the Sources section, expand Query Parameters. In the Target section, expand CelsiusToFahrenheit.
• Drag the source Celsius element to the target nCelsius element. 
• Click Validate and wait for the Validation Successful message to popup.
• Click Back  to exit the mapper and return to the integration canvas. Your mappings are automatically saved.

• Now Let's Map the second Mapper i.e. GetTemperatureInFahreneit. select the mapper, right click and click Edit

• The mapper opens. In the Sources section, expand CelsiusToFahrenheitResponse. In the Target section, expand Response Wrapper.
• Drag the source CelsiusToFahrenheitResult element to the target Celsius To Fahrenheit Result element. 
• Click Validate and wait for the Validation Successful message to popup.
• Click Back  to exit the mapper and return to the integration canvas. Your mappings are automatically saved.

STEP 6: Define a Business Identifier
Let's now define the primary business identifier for the integration.

Knowledge:  👀 

Business Identifier? Business identifiers enable you to track payload fields in messages during runtime. Each integration requires a primary business identifier.

• Above the integration, click Business Identifier . Expand QueryParameters, and drag Celsius to the Business identifier field

• Click Save, then click outside the Business identifiers panel to close it. The business identifier you specify here is visible when you monitor your completed integration instance.
• Check for any red error icons (left hand side of integration canvas). If you see any, click the icon for details and resolve those errors.
  
• The complete integration design looks as follows.

•  Click Back  to exit the integration canvas and return to the project page.

- Advertisement -

STEP 7: Activate and Run the Integration

• In the Integrations section, click Actions , then select Activate

• Click Activate. Select the tracing level set to the Debug (Not recommended), Leave the other options as they are and then click Activate.

Knowledge:  👀 

Why to select Debug (Not recommended)?

If you receive runtime errors, the Debug (Not recommended) selection provides detailed information in the activity stream and is useful for testing and troubleshooting any runtime errors

• Click Refresh periodically. The integration status changes to Active. You are now ready to run the integration and send a message

• In the Integrations section, click Actions , then select Run

• In the Request section, specify Temperature Value in Celsius, and click Run to send your inbound message to the integration

• View the response message at the bottom of the Configure and run page. The converted temperature value in Fahrenheit is displayed 

Congratulation! 👏👏You have successfully created, designed, activated, run, and monitored your First integration. 

Thank You!  ta-ta 👋