Category: Uncategorized

  • Steps to Upgrade syRotech Router Firmware | Router | Technology



    In this article I have mentioned the steps to upgrade the firmware of syRotech Router. Keeping the firmware upto date can help you with better internet speed, Enhance Functionality & Security. 


    Lets see the steps ➤

    Step 1 : Login to Your syRotech Router configuration page.

    [ Note : If you don’t have your Router Configuration Page access, connect to your Internet Service Provider. They can provide you the require details]


     

    – Advertisement –




    Step 2 : Click on Statics. This page contain your current firmware detail, like your Device Model, Version You have to refer these detail to download the latest firmware applicable for your router.



    Step 3: Now let’s download the latest Firmware. Before I proceed , just a disclaimer !!! , if you will find difficulty to choose the correct Firmware File for your router, Please ask your Internet Service Provider. They will download the file and share it with you. Then you can skip this step to download the file.


    To download the Upgraded Firmware File for your router, Open another tab in browser and open this URL → https://www.syrotech.com/firmwares ,You can see list of firmware files to download. But you have to download the latest version firmware file as per your router configuration. Just check the Type, Model and Hardware version, the one which matches with your router configuration, download that file and save it.


    Step 4: Now again move to your router page, click Management –> then click Device Manage –> then select Upgrade Image. Upload the file that you have downloaded in above step. Click Ok


    – Advertisement –





    Step 5: It will take some time to process. You have successfully updated your firmware :). You can re-login to your router configuration window and can cross check if firmware updated or not, just check your Firmware Version  🙂





  • Add Scope in Oracle Integration | SCOPE Action | INTEGRATION GENERATION 3

    Add Scope in Oracle Integration | SCOPE Action | INTEGRATION GENERATION 3

     In this article I have shared the steps to add scope action in Oracle Integration.


    Knowledge:  👀 
    SCOPE in Integration:
    You can manage a group of Integratron Actions with a Scope action. The concept of scope is essential for designing complex integration flows, managing transactions, and controlling error handling.

    • Error Handling: Each scope can have its own error handlers. If an error occurs within a specific scope, the associated error handler can be used to catch and handle the error.
    • Integration Flow Design : Within an OIC integration, you can organize integration components (such as activities, branches, and error handlers) into different scopes. Each scope represents a distinct section of the integration flow.




    Use case : Refer below image – let’s add scope in an existing integration and later will put the adapter inside the scope.


    Let’s see the steps….


      • Drag your cursor along the line below the trigger until the Add Add icon icon appears. Search for SCOPE action, select SCOPE




      • Click EDIT ICON 🖉 and then enter Scope Name “InvokeCalculatorServiceScope” (you can enter any meaningful name). Click 


      • Click Save. Scope have been added successfully. 

    Note: 🖉

    If your requirement is just to know how to add a SCOPE, you can leave the below steps. You are done. You can close this article. 😁





      • Now lets put the Invoke SOAP Connection & its Mapper inside the Scope. Click 𝩊 (rectangular icon) inside the Mapper, then select CUT ICON(Please refer below Image)


      • Drag your cursor to SCOPE. Click on  𝩊 (rectangular icon) and then select PASTE, Click Into🡇



      • Mapper moved successfully inside Scope. Now similarly lets move the Invoke inside the Scope.


      • Move your cursor to Invoke Connection. Click 𝩊 (rectangular icon) then select CUT ICON ✀.  
      • Now drag your cursor inside the SCOPE. Click on ➕ (plus icon), present below he mapper and then select PASTE.
    (Please refer below image)

     

    This way we have successfully added a SCOPE inside an existing integration flow and also have readjusted the flow by putting the scope connection & its mapper inside the SCOPE.

    Note: 🖉

    You may see a warning sign after putting the INVOKE Connection inside the SCOPE. This is because response of the INVOKE Connection moved inside the SCOPE which was earlier mapped with the Trigger Response, and you know that the elements defined in the parent scope have local visibility inside this scope. 

    So, to fix this issue we need to declare a Variable in the integration which will store the INVOKE Response and can be accessed out of the SCOPE. The very same variable can be mapped with the Trigger.

    If you want to implement this, you can follow NEXT ARTICLE…. 😇





  • Format XML in Notepad++

    Format XML in Notepad++

    In this article I have shared the steps to Format XML in Notepad++. By following these steps we can skip the use of any web-based XML Formatter tool which can put the data security on risk.
    Now lets see the steps to do it offline using Notepad++ : 

    STEP 1: Paste the XML data in Notepad++
    Click on Image to ZOOM OUT



    STEP 2: Open the Finder Window by clicking CTRL+F (keyword) and then put the value as mentioned in the below image. Then Click Replace All. Done. You have successfully format XML data in Notepad++ 😇

    Click on Image to ZOOM OUT

    Click on Image to ZOOM OUT

  • Build Your Second Integration from Scratch | Create a PROJECT | Create Calculator Application | Oracle Integration Generation 3

    Build Your Second Integration from Scratch | Create a PROJECT | Create Calculator Application | Oracle Integration Generation 3

     

    In this article I have share the steps to develop and test a Calculator Integration from scratch in Oracle Integration Generations 3 Instance | A complete Hands-on Practice.

    Use Case – Develop an Integration which will be able to perform basic calculator operations i.e. (i.e. Addition ➕, Subtraction ➖, Multiplication , Division ➗). 


    Prerequisite – 

    • OIC Generation 3 Instance Account
    • Calculator Service WSDL URL:  http://www.dneonline.com/calculator.asmx?WSDL

    – Advertisement –




    End Result 
    Once we complete the development of the Integration, final page looks as follow

    Click on Image for better view

    and the Testing Page looks as shown in below image, where we will have four different operations i.e. Add, Subtract, Multiply and Divide to select…

    Click on Image for better view

    The whole Article is divided into 3 Parts: 

      • Part 1 – I have mentioned the steps to Create Connection
      • Part 2 – mentioned the steps to develop the Integration
      • Part 3 – mentioned the steps to Test the Integration

    Now Let’s Start the development……..

    PART 1: Create Connection 


    STEP 1: Create REST Trigger Connection. Follow this Article to create the connection.

    STEP 2: Create the SOAP Connection for the Calculator Service. Please follow this article to create the connection.

    Once you have created the above two connections, Let’s moved to Part 2 i.e. Develop the Integration.



    PART 2: Create Integration 

    STEP 3: Create Integration.

    • STEP 3.1: In the navigation pane, Click on Integrations (at left hand top). Click Create, then select Application.

    Click on the Image for better view
    Click on the Image for better view

    • STEP 3.2: In the Name Filed, enter CalculatorApplication (you can enter any other meaningful name). Leave the other field as they are, click Create. 

    Click on the Image for better view

    💡
    The integration canvas opens with an option for creating a trigger connection. The trigger (source) connection allows your integration to receive inbound messages from an application.


    – Advertisement –




    • STEP 3.3:  Let’s configure the REST Trigger connection to define how the Trigger connection receives messages in the integration
      • Click on the ➕ icon and then search for REST Trigger Connection which we have created in Step 1. Select that connection.

      • Enter “Calculate” as the endpoint name, Enable the “☑️ select to configure multiple resources or verbs ” and then click Continue.

      • Resource configuration page will get open. Enter the below information as suggested:
        • Provide an Operation Name:  enter add
        • What is the endpoint’s relative resource URI:  enter /calculator/operation/add
        • What action do you want to perform on the endpoint:  select POST
        • Select any options that you want to configure:   select below options
     ☑️Configure a request payload for this endpoint
     ☑️ Configure this endpoint to receive the response

    Click Continue

     

     

      • In the Request Page enter the following details
        • Select the response payload format:  Select JSON Sample.
        • <<< inline >>>:  Click this field and enter the following content, then click Continue.
    {
      "Number_1": null,
      "Number_2": null
    }
        • Element:  Ensure response-wrapper is selected.
        • What is the media-type of Response Body:  Ensure JSON is selected.

    Click Continue

     



      • let’s configure the Response Page: 
        • Select the response payload format:  Select JSON Sample.
        • <<< inline >>>:  Click this field and enter the following content, then click Continue.

    {
    “AddResponse”: null 

    }

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

    Click Continue


    – Advertisement –




    📝Note: 
    We have successfully configured the Request – Response page for ADD ➕ operation. Similarly, we have to configure the Request-Response page for the other operations – SUBTRACT , MULTIPLY and DIVIDE. I will cover the detail steps with screenshots for one more operation i.e. for SUBTRACT ➖ and the rest two operations you can do it by yourself. Don’t worry will provide the configuration details but no screenshots 😁


      • Let’s Configure Request – Response page for SUBTRACT operation (➖). Select ☑️Add Another operation” and then click Continue

    Click on the Image for better view


      • Resource configuration page will get open. Enter the below information as suggested 
        • Provide an Operation Name:  enter subtract
        • What is the endpoint’s relative resource URI:  /calculator/operation/subtract
        • What action do you want to perform on the endpoint:  select POST
        • Select any options that you want to configure:  

     ☑️Configure a request payload for this endpoint

     ☑️ Configure this endpoint to receive the response

    Click Continue

      • In the Request Page enter the following details
        • Select the response payload format:  Select JSON Sample.
        • <<< inline >>>:  Click this field and enter the following content, then click Continue.
    { 
    “Number_1”: null, 
    “Number_2”: null 
    }

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

     

      • Configure the Response Page: 
        • Select the response payload format:  Select JSON Sample.
        • <<< inline >>>:  Click this field and enter the following content, then click Continue.

    “SubtractResponse”: null 

    }

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

    Click Continue

     

    Click on the Image for better view

      • We have successfully configured two operations –   ADD and SUBTRAT.  Now I request you to configure the left two operations by following the same steps after clicking ☑️Add Another operation”. Below I have provided the configuration details for both Multiply  and Divide ➗ that you need to enter during configuration 😇

    – Advertisement –




                   ——FOR Multiply—-

                                 RESOURCE CONFIGURATION PAGE DETAIL:

          • Provide an Operation Name: multiply
          • What is the endpoint’s relative resource URI: /calculator/operation/multiply
          • What action do you want to perform on the endpoint: POST
          • Select any options that you want to configure:  

     ☑️Configure a request payload for this endpoint

     ☑️Configure this endpoint to receive the response

     

    REQUEST CONFIGURATION PAGE DETAIL:

          • Select the response payload format: Select JSON Sample.
          • <<< inline >>>: Click this field and enter the following content, then click Continue.

    {

      “Number_1”: null,

      “Number_2”: null

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

     

    RESPONSE CONFIGURATION PAGE DETAIL:

          • Select the response payload format: Select JSON Sample.
          • <<< inline >>>: Click this field and enter the following content, then click Continue.

    {
    “MultiplyResponse”: null

    }

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

                  —–FOR Divide—–

     RESOURCE CONFIGURATION PAGE DETAIL:

          • Provide an Operation Name: divide
          • What is the endpoint’s relative resource URI: /calculator/operation/divide
          • What action do you want to perform on the endpoint: POST
          • Select any options that you want to configure:  

     ☑️Configure a request payload for this endpoint

     ☑️ Configure this endpoint to receive the response

     

    REQUEST CONFIGURATION PAGE DETAIL:

          • Select the response payload format: Select JSON Sample.
          • <<< inline >>>: Click this field and enter the following content, then click Continue.
    { 
    “Number_1”: null, 
    “Number_2”: null 
    }

     

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

     

    RESPONSE CONFIGURATION PAGE DETAIL:

          • Select the response payload format: Select JSON Sample.
          • <<< inline >>>: Click this field and enter the following content, then click Continue.

    {
    “DivideResponse”: null 

    }

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

      • Once you have configured the other 2 operations click Continue. Below summary page will get generated. Click Finish.

    Click on the Image for better view

    – Advertisement –




    STEP 3.4: We have successfully configured four operations in REST Trigger Adapter. Now let’s add the Calculator SOAP Connection to invoke calculator service.


      • Drag your cursor along the line until the Add Add icon icon appears. Select Invokes, then select the Calculator connection

      • Configure Basic Info page opens, enter following details:
        • What do you want to call your endpoint – Enter Addition

    Click continue

     

     

      • Configure Operations page appears. Enter the following information
        • Select the Port – select CalculatorSoap
        • Select the Operation – select Add

    Click Continue

     

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


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


    If you notice, by mistake, I have added the invoke connection at the end because of which the response mapper is present at the Top. We need to reposition the response mapper in the flow. So before moving forward lets first Reposition Response Mapper.

    1. Select the Add Map (i.e. Trigger Response) 
    2. and then click Cut ✀ (present at top left) and then Paste it at the End of the flow. Thats it. Now Flow is okay. We can move forward with our integration development.

    Please refer below screenshot. 



    – Advertisement –




    STEP 3.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. Map Addition (request mapper)

      • The mapper opens. In the Sources section, expand Add Request. In the Target section, expand Addition Request.
      • Drag the source Number 1 element to the target intA element. 
      • Similarly drag the source Number 2 element to the target intB element
      • Click Validate and wait for the Validation Successful message to popup.
      • Click Back Back icon to exit the mapper and return to the integration canvas. Your mappings are automatically saved.

      • Now Let’s Map the second Mapper i.e. Map add (response mapper). Double click the mapper or select the mapper, right click and click Edit


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

    STEP 3.6: Define a Business Identifier
    Let’s now define the primary business identifier for this Scope.



    Knowledge:  👀 

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



      • Click red error sign, then select Business Identifier Business identifiers iconExpand Request Wrapper and drag Number 1 to the Business identifier field.
      • Similarly drag Number 2 to the second Business identifier field.
    refer below images

      • 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.
      • We have successfully completed the configuration of ADDITION  Operation; design looks as follows.

    Now similarly we are going to configure the Invoke connection and Mapper for all the left 3 operations i.e. for Subtraction ➖, Multiplication , Division ➗


    STEP 3.7: Add the Calculator Invoke Connection


      • Enter Endpoint Name = Multiplication, click continue


      • Select Port = CalculatorSoap , Operation= Multiply and then click Continue

      • Configure Headers page opens. Leave this page as they are. Click Continue
      • Summary page appears. Review your selections, then click Finish.


    – Advertisement –




    STEP 3.8: We have successfully configured the SOAP Invoke connection, now let’s configure the mapper.

      • Select the first mapper (i.e. Map Multiplication), click edit

      • Drag and drop the source element to the target element (similar to above step 3.5)
      • Refer below image

      • Open the second mapper (i.e. Map Multiply) and complete the mapping (similar to above step 3.6)
      • Refer below image

    STEP 3.9: Define a Business Identifier (similar to above step 3.6)



      • This way we have successfully configured the Multiplication Operation also.
      • Now I request you to configure the left 2 operations i.e. SUBTRACT  AND DIVIDE ➗ by yourself. You just need to keep in mind to select the correct operation while configuring the SOAP Connections of the left 2 operations
      • Choose Subtract for subtract operation and Divide for Divide Operations.
      • Mapper will be similar to the above configured operations. 
      • Once you have completed the configuration of the left two operations (i.e. configured Invoke connection, Mapper and business identifier) Final Page looks like below image:

    PART 3: Test the Integration 

     Activate and Run the Integration

      • In Integrations section, click Power button Actions icon

      • Leave the tracing level set to the Production and the other options as they are and then click Activate.

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


      • Click Actions Actions icon, then select Run

      • Let’s check Add operation first. Select Add operations. Enter below payload in the body section and click Run

    { 

    “Number_1”: 1, 

    “Number_2”: 4 

    }



      • View the response message at the bottom of the Configure and run page. The addition operation value is displayed 


    Similarly, you can run and test the other 3 operations i.e. Subtraction ➖, Multiplication , Division ➗


    I have pasted the screenshots for your reference …


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


    Thank You!  ta-ta 👋

     


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

    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.

    The Error icon shows a value of 4.


    – 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 Back icon 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 AddDouble-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 Available invokes iconThe Create connection panel opens.

        • Click Create Connection Install icon 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 Back icon 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 Add icon 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 Back icon to exit the mapper and return to the integration canvas. Your mappings are automatically saved.


        • Now Let’s Map the second Mapper i.e. GetTemperatureInFahreneitselect 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 Back icon 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 Business identifiers iconExpand 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 Back icon 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 Actions icon, 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 Refresh iconperiodically. The integration status changes to Active. You are now ready to run the integration and send a message


        • In the Integrations section, click Actions Actions icon, 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 👋


    1. Create SOAP Connection in OIC Integration 3 | Calculator Service SOAP Connection | Oracle Integration Generation 3

      Create SOAP Connection in OIC Integration 3 | Calculator Service SOAP Connection | Oracle Integration Generation 3

       

      In this Article we will see the steps to create a SOAP connection in OIC Generation 3:

       

      Use Case – Lets create a SOAP connection using Calculator Service WSDL URL. This connection can be use in any integration to perform basic calculator operations (i.e. Addition ➕, Subtraction ➖, Multiplication , Division ➗)


      Calculator Service WSDL URL:  http://www.dneonline.com/calculator.asmx?WSDL


      STEP 1: On the Oracle Integration Cloud Service home page, click the Design and then click Connections



      STEP 2: Click the Create button




      STEP 3: Search for SOAP adapter and then select it




      STEP 4: Enter Integration Name = ‘Calculator’ (you can enter any meaningful name), select Role=Invoke & then click Create





      STEP 5:  Copy and Paste the WSDL URL and select Security = No Security Policy, Access Type = Public Gateway

      • WSDL URL:  http://www.dneonline.com/calculator.asmx?WSDL


      STEP 6: Click on Save then click Validate and Test and finally click Save. Your connection is ready to use inside the integration flow.




      Thank You!  ta-ta 👋





    2. Create REST Trigger Connection in OIC Integration 3 | Oracle Integration Generation 3

      Create REST Trigger Connection in OIC Integration 3 | Oracle Integration Generation 3

       

      STEP1: Login to OIC Generation 3 Instance. On the Home page click Design 🖉 (left hand top side) and then click Connections.


      CLICK ON IMAGE FOR BETTER VIEW



      STEP 2: Click Create (right hand top side) and then search for REST adapter in the search box. Select REST Adapter.


      STEP 3: Enter the Connection Name = RESTConnection (you can give any meaningful name) and then Select Role = Trigger. Click Create.



      STEP2: Select Security = Basic Authentication, Access Type = Public Gateway. Click Save and then Test the connection. Your connection is ready to use inside Integrations.



      Thank You!  ta-ta 👋

    3. Reposition activity in OIC Generation 3 | Cut Paste OIC Activity | Oracle Integration Generation 3

      Reposition activity in OIC Generation 3 | Cut Paste OIC Activity | Oracle Integration Generation 3

       

      In this article we will see the steps to move the activity from one place to another in the integration generation 3 flow:


      STEP 1: Select the activity which you want to reposition in the integration flow. Then Click the cut icon  (at left hand top)


      CLICK ON IMAGE FOR BETTER VIEW

      STEP 2: Select the place where you want to place it and then click paste. Click Save. Done you have successfully repositioned OIC activity in OIC Generation 3.




      Thank You!  ta-ta 👋

    4. Oracle Integration (OIC) to import data into HCM cloud using HDL Import Job | Oracle Integration Cloud

      Oracle Integration (OIC) to import data into HCM cloud using HDL Import Job | Oracle Integration Cloud

      Oracle HCM Data Loader (HDL) Process ❓ 🤔

        • Oracle HCM Data Loader (HDL) jobs, a powerful tool for bulk loading data through integrations. 
        • Using Oracle HDL, you can load business objects for most Oracle HCM Cloud products into Oracle Integration. For example, you can load new hires from Oracle Talent Acquisition Cloud (Taleo EE) as workers into Oracle HCM Cloud using an Oracle HDL job. 
        • Integration architect can generate the delimited data files in Oracle Integration using business object template files provided by Oracle HCM Cloud. The business object template file must be associated with a stage file action in Oracle Integration to generate the delimited data file .
        • – Advertisement –




            • To learn more about how to obtain the business-object template file from Oracle HCM Cloud and use the same for delimited data file generation, refer to this post on the Oracle Cloud Customer Connect portal.
              • ⭐At a high level, an Oracle HDL job pattern can be implemented in three steps:

              1) Generate the HCM HDL compliant delimited data (.dat) file.

              2) Submit the Oracle HDL job.

              3) Monitor the job status until completion.

              Hands-on  Practice : 



              Use Case :  
              In this article we will see the steps to develop an Integration which will load Person Email detail from OIC as Workers ( business object ) into Oracle HCM Cloud using an Oracle HDL job.  
              I have divided the complete article into two parts

              In PART -1 we will submit the HDL Process ( import and load ) directly in the HCM cloud application i.e. we will see the steps to submit the HDL process from front end  and  in PART – 2 we will develop an integration that will submit the same HDL process from OIC.

              PART – 1

              Create HCM HDL File of Worker Business Object :

              Save the below box data as ‘Worker.dat’ file. Then compress (zip) the Worker.dat into a file name of your choice, but it must have a .zip file extension. This file contains email details of two employees. Please cross check weather the below employee no exist in your HCM Application Instance or not. If not exist you can use any other employee no which exist in your HCM Application.
              METADATA|PersonEmail|DateFrom|DateTo|PersonNumber|EmailType|EmailAddress|PrimaryFlag
              MERGE|PersonEmail|1951/01/01|2022/06/22|69658|H1|test@gmail.com|Y
              MERGE|PersonEmail|1951/01/01|2022/06/22|65507|H1|test@gmail.com|Y
              
              We have the HCM Data Loader file ready for bulk Loading Person Email , now lets Follow the next step to import this into the HDL staging tables and load the data into the application tables ( i.e. Submit HDL Job – Import and Load )

              Knowledge :  👀 

              All files must include METADATA lines, to explain which attributes are included in the file and the order in which their values are supplied.

              All attribute names and values are delimited by the pipe ‘|’ character by default.

              The string immediately after the METADATA instruction identifies the record type the attributes are for, in our case ‘PersonEmail’. The values that follow are the names of the attributes available on the PersonEmail record, that you want to supply data for.


              The MERGE instruction tells HDL to create the grade if it doesn’t already exist, or update it if it does.


              IMPORTING AND LOADING YOUR FILE  ( HDL Job ) :

                • Login to HCM Cloud Application, on the home page , click My Client Groups > Data Exchange
                  • On the Data Exchange page, click Import and Load Data
                    • Click Import File (at top right)

                      • Click Choose File button and select the .zip file which we have saved above and then click Review Parameters. You can directly click on Submit Now button but I intentionally want you check the parameters also because these parameters name and its value we will Map while developing OIC Integration.

                        • You don’t need to change the parameters values. Just click Submit

                          • Click OK on the Submitted confirmation page
                            • Import and Load Data process will get starts. Click Refresh 🔄 until the Import and Load status completed. Once the Import and Load process completed successfully, you can verify the HDL process by checking the Employees records.
                            Knowledge :  👀 

                            The Import Status will indicate if the business object .dat files in your zip file imported into the staging tables correctly. Here you can see that import was successful.

                            The Load Status will indicate if the data is successfully loaded in the Oracle HCM Cloud application tables. The clock icon indicates that Load is still in progress.


                            Lets Verify the HDL process by checking the Employee Records :
                              • Go the HCM Application Home Page, click My Client Groups > Person Management
                                • Search with any of the employee number which you have uploaded above in .zip file. 
                                  • Then click Task Icon 🗉 and then select Person

                                    • You can see the Home email got updated with the ones which we have passed above in .zip file. This way we have successfully Load file with HCM Data Loader. Now we will develop the Integration that will be capable to do the same process which we have did manually. 

                                    PART – 2


                                    OIC INTEGRATION TO SUBMIT HCM DATA LOADER (HDL) JOB : 

                                    ⭐Prerequisite : FTP and HCM Connection. If you don’t have these connection available in your OIC instance, You can follow these blogs to know the configuration steps ( click to configure FTP Connection , click to configure HCM Connection )
                                    Lets create one Schedule Integration that will Trigger HCM Data Loader (HDL)  job for uploading Worker data file from OIC into the HCM Cloud.


                                    STEP 1 : 

                                    Before we start Integration development save the below box data as ‘Worker.dat’ file in your local system. Then compress (zip) the Worker.dat into a file name of your choice, but it must have a .zip file extension.

                                    METADATA|PersonEmail|DateFrom|DateTo|PersonNumber|EmailType|EmailAddress|PrimaryFlag
                                    MERGE|PersonEmail|1951/01/01|2022/06/22|69658|H1|oic_test@gmail.com|Y
                                    MERGE|PersonEmail|1951/01/01|2022/06/22|65507|H1|oic_test@gmail.com|Y
                                    

                                    Once you saved the above file, Login to OIC Instance and follow the below steps :

                                    STEP 2 : 
                                    • Create a Schedule Integration having some meaningful name.

                                    • Search for the FTP connection and select it. FTP adapter configuration wizard will get opened.  
                                      • Enter any meaningful name for the endpoint and then click Next
                                        • Select ‘Download File‘ operation , *Transfer Mode as Binary and enter the Download Directory path and then click Next
                                          • FTP Adapter configuration completed. Click Done.

                                          • Now search for the HCM Connection and select it. HCM adapter configuration window will get opened.
                                            • Enter any meaningful name for the endpoint and then click Next
                                              • Select Import Bulk Data using HCM Data Loader (HDL) and then click next
                                                • Select *Security Group = FAFusionImportExport and *Doc Account =hcm$/dataloader$/import$ and then click Next
                                                  • HCM Adapter configuration for HDL completed. Click Done.

                                                  • Now lets complete the Mapping :
                                                    • Open the FTP Adapter mapping
                                                      • Map the file Name , Directory and DownloadDirectory directory. Please make sure that for this Article please pass below details :
                                                          • File Name = Worker.zip (in current case we are uploading Person Email of Worker business object so we need to pass Worker.dat file name exactly)
                                                          • Directory = enter the FTP directory path where the Worker.dat file will be present while testing 
                                                          • DownloadDirectory = you can enter  ‘/’

                                                          Please take reference from below image

                                                           

                                                            • Now open the HCM Adapter Mapping
                                                              • Just map the columns as shown in below image and pass the required parameters ( below highlighted one )
                                                              concat(“ImportMaximumErrors=100,LoadMaximumErrors=100,LoadConcurrentThreads=”, 1, “, FileEncryption=NONE” )

                                                              STEP 3 :  Monitor the job status until completion :

                                                              • Add Assign action, enter some meaningful name and click create.

                                                               


                                                                • click on ➕ icon and declare one variable name ‘varHDLFlowStatus’ and  initialize its value as ” (empty string) by clicking on edit icon 🖉. Then click Validate and Close the assign window.
                                                                • Now we will add While action in the flow which will keep executing in a loop till the time submitted HDL process is completed :
                                                                  • Search for the While action and select it. Enter a meaningful name (ex- HDLFlowLoop) and then click create.

                                                                    • Click on ‘Expression Builder’ and build the expression like below and then click Validate and close the expression window.
                                                                    $varHDLFlowStatus !=’CANCELLED’ and $varHDLFlowStatus !=’COMPLETED’

                                                                    • Now lets configure HCM adapter to invoke operation which will query the status of the submitted HCM Data Loader Job :
                                                                      • Search for the HCM Connection and select it. Enter any meaningful name for the endpoint, click Next

                                                                        • Select Import Bulk Data using HCM Data Loader (HDL) and then click Next
                                                                          • Select query the status of an HCM Data Loader Job and then click Next.
                                                                            • Click Done.
                                                                              • Open the mapper by clicking on 🖉 icon and map the Process Id. Click Validate and click Close ( please take reference from below image )

                                                                              • Now we will add one more assign action in which we will update the variable value which we have declare before While action (in above step )
                                                                                • Search for Assign Action and select it. Enter any meaning name (like ‘updateHDLFlowStatus’ ) and click Create.

                                                                                  • Click on the ➕ icon, select the variable which we have declare before while loop from the drop down menu (in my case is ‘varHDLFlowStatus) and then click on edit 🖉icon
                                                                                    • Drag and drop the *STATUS element in the expression builder ( take reference from below image ). Then click Validate and Close.

                                                                                      • Again click Validate and Close.
                                                                                      • Now at the end of the development just add one WAIT Activity of 10 sec. So that the while loop execute after interval of 10 secs. Once the while condition is fulfil it will exit the While Loop.
                                                                                        • search for Wait action.
                                                                                          • Enter some meaningful name for the WAIT Action. In seconds column enter 10. Click Create. 
                                                                                          Knowledge :  👀 
                                                                                          Wait Action : Maximum wait time should be 6 hrs.

                                                                                          • Integration development is completed. Enable the Tracking by clicking on the hamburger sign ( top right )

                                                                                          Lets TEST the Integration :
                                                                                          • Upload the Worker.zip File ( which we have saved in PART 2 : STEP 1) in the FTP Folder ( make sure you upload the file in same directory path which you have entered in the FTP Mapping in PART 2 : STEP 2)

                                                                                          • Activate the Integration and Submit it.


                                                                                          • Wait for the Integration Run to get completed. You can check the status in Monitoring Page ( You can Navigate to Monitoring window by clicking on Home Icon (top left ), then click Monitoring –> Integrations –> Tracking

                                                                                          • Once the Integration run completed, you can login to HCM Cloud Application and can verify the PersonEmail of the Employees get updated successfully with the email details which we havwe pass in the Worker.zip file by following the same verification steps that we followed in PART 1 of this article.

                                                                                          TADA ! 👋

                                                                                          (more…)

                                                                                        • Develop an integration to get dynamic email notification | Oracle Integration Cloud

                                                                                          Develop an integration to get dynamic email notification | Oracle Integration Cloud

                                                                                          Knowledge :  👀 
                                                                                          Notification? : Enables you to send notification email to relevant users at specific points in the execution of an integration.



                                                                                          When we can use dynamic email notification ❓🤔

                                                                                          suppose you want to send email notification that contain DATA in TABEL FORMAT which ROWS is not FIXED i.e. body of email notification is not fixed. Sometime it contain 2 rows , in next run it may need 50 rows etc. so table structure needs to be dynamic —> to handle such use case we need code OF DYNAMIC EMAIL NOTIFICATION.

                                                                                          – Advertisement –






                                                                                          Now lets develop one end to end Integration to see how we can implement logic to get dynamic email notification :

                                                                                          Use Case :

                                                                                          Our requirement is to send the Input data (employee records) of the integration via Email Notification in Tabular Format.
                                                                                          Suppose we have one set of records the then the email table contain one row (as shown in below image)


                                                                                          Similarly if we pass two sets of record, we will get email notification having two sets of record.  
                                                                                                


                                                                                          – Advertisement –




                                                                                          Lets see the development steps in detail :
                                                                                          STEP 1 :  
                                                                                          Create a new App Driven Orchestration :
                                                                                          Enter the below details and click Create:

                                                                                          *What do you want to call your Integration? : Write a meaningful name
                                                                                            What does this Integration do? : write meaningful description
                                                                                                      

                                                                                          STEP 2 :  
                                                                                          Search for the REST Connection which we have created earlier and configure it as shown in below image
                                                                                          [ You can access this blog to know – how to Create REST Connection ]

                                                                                          – Advertisement –




                                                                                          Enter below details and click Next as shown in below image:

                                                                                          *What do you want to call your endpoint ? : write meaningful name
                                                                                          *What is the endpoint’s relative resource URI ? : 
                                                                                           You can give any meaningful word with “/” 
                                                                                           Example : /dynamicEmail

                                                                                          * What action do you want to perform on the endpoint ? : select POST 
                                                                                                      
                                                                                             &
                                                                                             select Configure a request payload for this endpoint

                                                                                          – Advertisement –






                                                                                             ***Save this below Schema as Email.xsd

                                                                                            download Email.xsd file from here – click to download

                                                                                          Choose the above saved schema ” Email.xsd ” in next window & click Next and then click done [as shown in below image]


                                                                                            
                                                                                          STEP 3: 
                                                                                          Now add one Assign action


                                                                                          Knowledge :  👀 
                                                                                          Assign ? Enables you to assign variables to integrations.


                                                                                          – Advertisement –




                                                                                                   
                                                                                          Enter below details & click Create:

                                                                                          *Name : write a meaningful name
                                                                                           Description : write small description
                                                                                                   
                                                                                          click on ” + ” icon to add variable 

                                                                                                
                                                                                          Write variable name as vEmail (you can give any meaningful name) and click Edit button 
                                                                                            

                                                                                          Write the below code in Expression box and click Validate & then click     
                                                                                          Close 

                                                                                                “<table>
                                                                                                   <tr>
                                                                                                   <th>Name</th>
                                                                                                   <th>City</th>
                                                                                                   </tr>”

                                                                                          – Advertisement –




                                                                                          STEP 4 : 
                                                                                          Now add one For Each action 



                                                                                          Knowledge :  👀 
                                                                                          ForEach ?  Enables you to loop over a repeating element and execute one more actions within the scope of the for-each action.



                                                                                          Enter the below details and click Create :

                                                                                          *Name : write one meaningful name
                                                                                          *Repeating Element : drag and drop the Employee tag from Source side as shown in below image 
                                                                                          *Current Element Name : Current  (you can give any meaningful name but make a note of it because you need it later in this integration)
                                                                                                       
                                                                                          STEP 5: 
                                                                                          Now add one Assign inside For Each 

                                                                                          Enter below details & click Create :

                                                                                          *Name : write one meaningful name 
                                                                                           Description : write some meaningful description

                                                                                          – Advertisement –




                                                                                          Click ” + “ Select the Existing Variable ” vEmail “ and then click Edit 

                                                                                                   

                                                                                          ***configure the Expression using Concat function and by dragging and   

                                                                                          dropping the required fields form Source as shown in below image and then click Validate 

                                                                                                       
                                                                                           use this HTML Code in Expression

                                                                                           style=’background-color:#C9CBCA;font-weight: lighter’
                                                                                                   

                                                                                          – Advertisement –




                                                                                               
                                                                                          STEP 6:  
                                                                                          Now add one assign outside of foreach to close the table

                                                                                          Write one meaningful name and click Create

                                                                                          Click the ” + ” icon and select the existing variable ” vEmail ” and click Edit
                                                                                             

                                                                                          Enter the below details inside Expression box to close the table and click Validate and then Click Close.

                                                                                                concat($vEmail, “</table>”)

                                                                                          – Advertisement –




                                                                                          STEP 7: 
                                                                                          Now the last part, add one Notification as shown in below image


                                                                                                              
                                                                                          Enter the below details and then click Create :

                                                                                          *Name :write one meaningful name
                                                                                           Description : write some description


                                                                                          Knowledge :  👀 
                                                                                          Notification? : You Enables you to send notification email to relevant users at specific points in the execution of an integration.


                                                                                               
                                                                                            Now configure the Notification Payload by entering below details :      

                                                                                                     1. Click on ” + ” icon and give 

                                                                                          ParameterName = body  (will use this in below HTML Body )& then click edit and provide the Parameter Value by dragging and dropping the vEmail variable form Source as shown in below images  

                                                                                                      2. Now enter the below details and click Validate and then click Close:

                                                                                                                 *From : Write from email address
                                                                                                                 *To : write the email address in which you want the Notifiaction

                                                                                                                 *Body : Enter the below HTML code as it is inside Body. This is 
                                                                                                                  a simple HTML code to define Email payload , you can use your  
                                                                                                                  own. 
                                                                                                                  **The important point is that inside the <div> tag ,the 
                                                                                                                  above defined parameter value {body} is added which contains 
                                                                                                                  our dynamic email values.


                                                                                          <html>
                                                                                          <head>
                                                                                          <style>
                                                                                          table, th, td {
                                                                                            border: 1px solid black;
                                                                                            border-collapse: collapse;
                                                                                          }
                                                                                          th, td {
                                                                                            padding: 5px;
                                                                                            text-align: left;
                                                                                          }

                                                                                          table th {
                                                                                            background-color:#154668;
                                                                                            color: white;
                                                                                          }
                                                                                            p{
                                                                                            margin : 0;
                                                                                            padding : 0;
                                                                                            }
                                                                                          </style>
                                                                                          </head>
                                                                                          <body>
                                                                                          <br>
                                                                                          <br>
                                                                                          <p>Hi There,</p>
                                                                                          <p> Below is the list of Employee details :</p>
                                                                                          <br>
                                                                                          <div>
                                                                                          {body}
                                                                                          </div>
                                                                                          <br>
                                                                                          <p>Thanks,</p>
                                                                                          <p>XYZ</p>
                                                                                          </body>
                                                                                          </html>
                                                                                           

                                                                                          – Advertisement –




                                                                                          STEP 8:  
                                                                                          Last but not the least , enable the tracking as shown in below image
                                                                                          drag and drop the Name column and then click save.

                                                                                          Knowledge :  👀 

                                                                                          Assigning Business Identifiers for Tracking Fields ? : Business identifiers enable you to track payload fields in messages during runtime.You must assign business identifiers before you can activate an integration.


                                                                                                         
                                                                                          Done, you have successfully created the dynamic email notification service. Click SAVE and CLOSE the Integration. Please see NEXT blog to TEST this service. Thank You !

                                                                                          – Advertisement –