Skip to Content

Design and Test Your First Integration Flow

test
0 %
Design and Test Your First Integration Flow
Details

Design and Test Your First Integration Flow

2019-10-15
Beginner
15 min.
SAP Cloud Platform Integration for process services, SAP Cloud Platform, SAP Cloud Platform for the Cloud Foundry environment, SAP Cloud Platform Connectivity, Tutorial, Beginner
Design an integration flow to integrate an online webshop that exposes data via OData service, and test it using Postman client.

You will learn

  • How to design and deploy an integration flow using the web-based integration flow designer
  • How to design an integration flow to query data from an online web shop that is available as an OData service

Prerequisites

Step 1: Edit integration flow

  1. Access your integration package by choosing Design > (Integration package name).

    Access integration package

    If you have not created an integration package and integration flow, complete the tutorial Create your First Integration Package and Integration Flow first before proceeding.

  2. Access your integration flow by choosing Artifacts > (Integration flow name).

    Access integration flow

  3. Start editing the integration flow by choosing Edit.

    Start editing the integration flow
Done
Log on to answer question
Step 2: Connect sender channel with HTTPS adapter

  1. Create the sender channel by clicking the arrow icon on Sender and dragging it to the Start Message step.

    Create the sender channel

  2. In the Adapter Type prompt, select the HTTPS adapter.

    Select HTTPS adapter

  3. Select the Connection tab. In the Address field, enter /CloudIntegrationTrial.

    Optionally, you can enter any value of your choice, but ensure that you use the “/” symbol before specifying the endpoint name. Deselect the CSRF Protected checkbox (this will be selected by default).

    Link text e.g., Destination screen
Done
Log on to answer question
Step 3: Add JSON to XML converter

  1. From the palette (the grey sidebar containing integration flow steps), choose Message Transformers > Converter > JSON to XML Converter.

    You add this converter as the input to the integration flow is sent in JSON format. After it is converted into XML, the message is sent as header information to the OData service to fetch the required product details.

    Select JSON to XML converter from palette

  2. Connect the converter to the message path by clicking on the message path.

    TIP: When you place your cursor on the message processing path, you see it change to green color.

    Connect JSON to XML Converter to message path
Done
Log on to answer question
Step 4: Add and configure content modifier

  1. Choose Message Transformers > Content Modifier and add it to the message path, as you did for the JSON to XML Converter.

    Add Content Modifier

  2. Configure the Content Modifier by selecting the Message Header tab and entering the following parameters:

    Field Name Description
    Name productIdentifier
    Type Select XPath from the dropdown list
    Data Type java.lang.String
    Value //productIdentifier
    Configure Content Modifier
Done
Log on to answer question
Step 5: Add request reply step

From the palette, choose Call > External Call > Request Reply. Connect it to the message path, similar to the previous steps.

Connect request reply step
Done
Log on to answer question
Step 6: Connect request reply to receiver

  1. Move the Receiver step below the Request Reply step by selecting it and dragging it to the desired position on the palette. You do this to ensure that your integration flow is elegantly designed.

    TIP: Use the pan and zoom controls (highlighted in yellow) for resizing the canvas. Use the guidelines to ensure that Receiver is aligned with the Request Reply step.

    Move Receiver below Request Reply

  2. Connect the Request Reply to Receiver by dragging the arrow icon on Request Reply to the Receiver.

    Connect Request Reply to Receiver

  3. In the Adapter Type prompt, select OData. In the Message Protocol prompt, select OData V2.

    Select adapter and message protocol

  4. Select the Connection tab. In the Address field, enter https://espmrefapps.hana.ondemand.com/espm-cloud-web/espm.svc. This is the URL of the online web shop from which you will fetch the product details.

    Enter connection details for OData adapter

  5. Select the Processing tab and choose Select in the Resource Path field.

    OData processing resource path selection - 1

  6. Ensure the connection details are the same and choose Step 2.

    OData processing resource path selection - 2

  7. Click on the Select Entity field and choose Products from the dropdown list.

    OData processing resource path selection - 3

  8. Enable the Select All Fields checkbox and choose Step 3.

    OData processing resource path selection - 4

  9. Choose the Select Field icon.

    OData processing resource path selection - 5

  10. Select Product ID and choose OK.

    OData processing resource path selection - 6

  11. In the dropdown list, select Equal. In the value field, enter ${header.productIdentifier}. Choose Finish.

    OData processing resource path selection - 7

In this step, you have configured the OData adapter to fetch the details of the product based on the product ID that you send as input while making the HTTP call.

What is the protocol that the web shop uses to expose data?
×
Step 7: Deploy the integration flow

  1. Choose Deploy to deploy the integration flow. Choose Yes in the confirmation dialog for deployment. Once you see the deployment confirmation, choose the Monitor tab to access the monitoring view.

    Deploy iflow and access monitoring view

  2. In the Monitor view, under the Manage Integration Content section, choose All to access all the artifacts that you have deployed. You will also see the integration flow that you have deployed here.

    Access deployed integration content in monitoring view

  3. Please wait till the integration flow is in status Started. Then, select the integration flow and in the Endpoints tab, choose the Copy icon.

You will use this endpoint in the Postman client to test your integration flow.

Done
Log on to answer question
Step 8: Test integration flow using Postman
View Full Instructions

  1. Launch the Postman client that you have installed on your local machine. In the Enter request URL field, enter the integration flow endpoint that you copied after deploying the integration flow. Then, select the POST operation from the dropdown list.

    Create new postman request

  2. Select the Authorization tab and choose Basic Auth in the Type dropdown list. In the Username and Password field, enter the clientid and clientsecret that you copied from the service key that you created when you provisioned the SAP Cloud Platform Integration tenant.

    Provide Authorization details

  3. Select the Body tab and choose raw radio button. In the form below, enter

    {
  "productIdentifier": "HT-2000"
}

    Choose Send. This is the ID of the product that you are requesting from the web shop.

    TIP: If you would like to query a different product, access https://espmrefapps.hana.ondemand.com/espm-cloud-web/webshop/ and select a product of your choice. Copy its Product ID and use that ID in the Postman request.

    Enter payload details and send request.

  4. Observe the response that you receive in the Postman client. You can see the product details fetched from the web shop. You can also double-check these details by accessing the web shop directly and searching for the product ID that you sent as input in the Postman request.

    Observe response in Postman
Done
Log on to answer question

Next Steps

Navigate tutorial steps

QR Code

QR code
Back to top