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

October 7, 2020
Created by
September 23, 2019
Design an integration flow to integrate an online webshop that exposes data via OData service and fetch the product details. Your request will be sent via Postman client.

You will learn

  • How to create service instance and key
  • 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: Create service instance and key

IMPORTANT: You should execute this step after the Cloud Platform Integration tenant is active. Please ensure that you can access your tenant. If you create a service instance and key before that it might lead to an issue.

  1. Navigate back to your SAP Cloud Platform’s subaccount and access your subaccount’s space by choosing Spaces > dev. If you have intentionally specified any other space name, you can choose the space of your choice.

    Access space

  2. Choose Services > Service Marketplace > Process Integration Runtime.

    Access PI Runtime

    TIP: If you do not see the Process Integration Runtime service in the list, at the subaccount level, choose Entitlements > Configure Entitlements > Add Service Plans. Choose Process Integration Runtime and select the integration-flow service plan checkbox and choose Add 1 Service Plan.

  3. Select Create Instance.

    Create new instance

  4. Select the following details and choose Next.

    Field Name Details
    Service Process Integration Runtime
    Service Plan Select integration-flow from the dropdown list
    Instance Name Enter Test or name of your choice
    New instance wizard
  5. In the Specify Parameters tab, enter the following JSON code snippet:

      {
       "roles":[
         "ESBMessaging.send"
       ]
      }
    
    Jsoncode

    Choose Next > Create Instance.

    finalstep
  6. Upon successful creation of an instance, a dialog opens. Choose View Instance.
    view instances

  7. Select the newly created service instance and choose Create Service Key to create a new service key.

    Select service key

    You create this service instance to enable inbound HTTP calls to your SAP Cloud Platform Integration tenant.

    TIP: This service key will provide you the credentials for making inbound HTTP calls to integration flows deployed on your SAP Cloud Platform Integration suite tenant. You use the credentials of the service key that is clientid and clientsecret to call an integration flow as an HTTP endpoint. For more information, see Setting Up Basic Inbound Authentication with clientId and clientsecret from a Service Key.

  8. Specify a name for the service key and choose Create.

    Enter service key name

  9. Copy the values of clientid and clientsecret parameters. These are the credentials that you use to make a request to your integration flow after you deploy it.

    Copy clientid and clientsecret

    Make a note of these credentials. You will use it when you make HTTP calls to integration flows deployed on your tenant with HTTP endpoints.

Log on to answer question
Step 2: Access your workspace

Click the Design tab (pencil icon) to access your workspace. This is where you will create your integration package and integration flow.

Access workspace

This is the space where you will work on your integration flows and where you can access all your integration projects.

Log on to answer question
Step 3: Create an integration package and integration flow
  1. Choose Create to create a new integration package.

    An integration flow should be associated with an integration package.

    Create integration package

    In the Header tab, provide a Name and Short Description for your integration package.

    The Technical Name gets populated automatically based on the name that you provide.

    Choose Save and then choose Artifacts to navigate to the artifacts tab. In this tab, you will create your first integration flow.

    Provide package details and navigate to artifacts

  2. Choose Add > Integration Flow.

    Add integration flow artifact

    Enter the Name for integration flow and choose OK.

    Enter integration flow details and confirm

  3. Save the integration package by choosing Save and open the integration flow by selecting it.

    You can then edit the integration flow to add the required steps to create your integration scenario.

    Save integration package and open integration flow

Log on to answer question
Step 4: Edit the integration flow
  1. Access your integration package by choosing Design > (Integration package name).

    Access integration package
  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
Log on to answer question
Step 5: 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 “/” symbol before specifying the endpoint name. Deselect the CSRF Protected checkbox (this will be selected by default).

    Link text e.g., Destination screen
Log on to answer question
Step 6: 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
Log on to answer question
Step 7: 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
Log on to answer question
Step 8: 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
Log on to answer question
Step 9: 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 10: 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.

Copy Endpoints

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

Log on to answer question
Step 11: Test integration flow using Postman
  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 Suite 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
Log on to answer question

Give us 55 seconds of your time to help us improve

Next Steps

Back to top