PUBLIC

2019-12-06

Get Started with Integration Flow Development

(Cloud Foundry Environment)
© 2019 SAP SE or an SAP affiliate company. All rights reserved.

THE BEST RUN

Content

1 Get Started with Integration Flow Development. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3

1.1 Overview of the SAP Cloud Platform Integration Web UI. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
1.2 Create an Integration Package. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 8
1.3 Create the Integration Flow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 9
1.4 Smoke Test Scenario. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 11
Add a Timer Start Event. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 12
Create a Content Modifier to Define the Message Body. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 14
Create a Script Step to Log the Payload. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 15
Save and Deploy the Integration Flow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 17
Monitor Message Processing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .19
1.5 Smoke Test Scenario with External Data Source. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 20
Create a Content Modifier to Define the Message Body. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 22
Create a Content Modifier to Add a Header. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Create the Outbound OData Channel . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 23
Create the Script Step to Log the Payload. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 28
Run the Integration Flow and Monitor the Message Processing. . . . . . . . . . . . . . . . . . . . . . . . . .29
1.6 Timer-Initiated Scenario with a Mail Receiver. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . .32
Update the Tenant Keystore with the Certificates Required by the Mail Server. . . . . . . . . . . . . . . 34
Create and Deploy a User Credentials Artifact for the E-Mail Account. . . . . . . . . . . . . . . . . . . . . 36
Create the Mail Receiver Channel. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 37
Monitor Message Processing. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 40
1.7 Sender-Initiated Scenario (with HTTPS Sender Adapter). . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 41
Authorize the HTTP Client to Call the Integration Flow Endpoint in the Cloud Foundry
Environment. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 42
Create the HTTPS Sender Channel. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 45
Add the JSON to XML Converter. . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 46
Send the HTTP Request and Process the Integration Flow. . . . . . . . . . . . . . . . . . . . . . . . . . . . . 47

Get Started with Integration Flow Development (Cloud Foundry Environment)

2 PUBLIC Content
1 Get Started with Integration Flow
Development

Learn how to develop and run your first integration flow.

 Note

These exercises apply for both cases when you use SAP Cloud Platform Integration in the Neo and in the
Cloud Foundry environment.

However, note that at certain steps there are specific things to consider depending on the environment.
Whenever this is the case, it is indicated in this documentation.

A key part of an SAP Cloud Platform Integration project is to develop integration flows. An integration flow
allows you to specify how a message is processed on a tenant. The SAP Cloud Platform Integration Web UI
provides a modeling environment that allows you to design the details of message processing (its senders and
receivers as well as the individual processing steps) with a graphical user interface.

This section shows you step-by-step how to develop and run your first, simple integration flows. In other words,
it gives you an introduction to the tasks of an integration developer. We show you the design of four integration
flows, with increasing complexity.

 Note

The first three integration flows are initiated by a timer and don't have a sender. This means that all tasks
related to setting up a sender system to SAP Cloud Platform Integration can be omitted.

The fourth integration flow is initiated by a request from a sender system which is simulated by an HTTP
client.

To complete the tasks, you use the SAP Cloud Platform Integration Web UI.

Before designing any integration flow of this section, you need to create an integration package first and, within
this integration package, create an integration flow. When you have created the integration flow, you add the
steps as described for the specific integration flow exercise.

● The first exercise shows you how to perform a simple smoke test to check whether your tenant cluster is
working correctly and that it processes messages in the expected way. A simple message is created with
the text Hello World! in the message body. The integration flow has no receiver. To check if the message
has been processed successfully, you can go to the monitoring application and check for the message
content there.
More information: Smoke Test Scenario [page 11]
● The second exercise shows you how to extend the smoke test scenario by adding an outbound call to an
external data source. The integration flow requests data exposed by the external component through an
OData application programming interface (API). The message body is created based on that data and, like
in the first exercise, can be displayed by the monitoring application.
More information: Smoke Test Scenario with External Data Source [page 20]

Get Started with Integration Flow Development (Cloud Foundry Environment)

Get Started with Integration Flow Development PUBLIC 3
● The third exercise is a simple enhancement and modification of second integration flow. It has an e-mail
receiver so that you receive the message (processed by SAP Cloud Platform Integration) in an e-mail
account of your choice.
More information: Timer-Initiated Scenario with a Mail Receiver [page 32]
● The last exercise is a simple integration flow which also has a sender component. The sender in this
example is simulated by an HTTP client installed on your computer.
More information: Sender-Initiated Scenario (with HTTPS Sender Adapter) [page 41]

The exercises are designed so that you can do all four of them independently. All steps are described one-by-
one. But you can also start with the first one and, successively, enhance it to derive the second and the thirs
scenario out of the first one.

 Note

Prerequisites:

● You have been given access to an SAP Cloud Platform Integration tenant and have integration
developer permissions assigned to your user (authorization group
AuthGroup_IntegrationDeveloper).
● Authorization group AuthGroup_BusinessExpert has been assigned to your user (to allow to assess
message processing log attachments).
● You have set up an e-mail account that you can use as the receiver system for the integration flow (only
required for third exercise with the Mail adapter).
● You have opened the SAP Cloud Platform Integration Web UI (the Web UI URL ends with /itspaces).

Related Information

Overview of the SAP Cloud Platform Integration Web UI [page 4]

Smoke Test Scenario [page 11]
Smoke Test Scenario with External Data Source [page 20]
Timer-Initiated Scenario with a Mail Receiver [page 32]

1.1 Overview of the SAP Cloud Platform Integration Web UI

The SAP Cloud Platform Integration Web UI is your one-stop shop for integration development.

Note that the URL to access the Web UI ends with /itspaces.

When you open the Web UI, the following page is displayed.

Get Started with Integration Flow Development (Cloud Foundry Environment)

4 PUBLIC Get Started with Integration Flow Development
The Web UI comprises the following sections:

● Discover
Here, you can find predefined integration content provided by SAP that you can use out of the box and
adapt to your requirements. As the Getting Started documentation focuses on how to design your own
integration content, we do not go into any more detail on this section.
● Design
This is where you design your integration content. As you progress through the exercise in the Getting
Started documentation, you will spend most of your time in this section. It contains the graphical
integration flow modeling environment.
● Monitor
This is where you can monitor your integration flow. You also use this section to manage additional artifacts
that you need to deploy on your tenant to complement your integration flows (for example, User Credential
artifacts to configure connections using basic authentication).

Design Section

When you go to the Design section, you find a list of integration packages defined for the tenant.

When you select an integration package, you can find the integration flows (and other artifacts) defined for the
package (on the Artifacts tab).

In this Getting Started documentation, we assume that you have not yet defined an integration package for
your integration content. Therefore, the first step is to define an integration package.

Monitor Section

The Monitor section (also referred to as Operations view) has several subsections, each one containing several
tiles. These subsections allow you to perform various tasks that are required for an integration project in
addition to integration content design.

Get Started with Integration Flow Development (Cloud Foundry Environment)

Get Started with Integration Flow Development PUBLIC 5
When you work in the Neo environment, the SAP Cloud Platform Integration section has the following
appearance:

Get Started with Integration Flow Development (Cloud Foundry Environment)

6 PUBLIC Get Started with Integration Flow Development
When you work in the Cloud Foundry environment, the SAP Cloud Platform Integration section has the
following appearance:

● Monitor Message Processing

When you select a tile in this section, you find all messages that have been processed by all integration
flows deployed on the tenant. You can find out whether messages have been processed successfully for
your integration flow and analyze the situation if not.
● Manage Integration Content
When you select a tile in this section, you find all deployed integration flows and can check whether
deployment was successful. You can also find the endpoint address for your integration flow (which you
need if you want to configure the endpoint in the connected sender system).
● Manage Security

Get Started with Integration Flow Development (Cloud Foundry Environment)

Get Started with Integration Flow Development PUBLIC 7
 ○ The Security Material tile contains security-related artifacts that are required on the tenant in addition
to the security-relevant settings in your integration flow. In the course of the following exercise, you will
create and deploy a User Credentials artifact to define the user name and password for the mail
account that is addressed by the Mail receiver adapter of the integration flow.
○ The Keystore tile shows the content of the tenant keystore, which contains key pairs and certificates
required to set up connections that are protected using certificate-based authentication. In the
exercise, we need to add certificates when setting up the connection to the e-mail receiver.
○ The Connectivity Tests (only available in the Neo environment) tile allows you to test outbound
connections (from SAP Cloud Platform Integration to a receiver system). We use the connectivity test
tool to retrieve the certificates of the e-mail receiver that need to be imported into the tenant keystore.

There are other sections and tiles that are required for additional tasks, but these are not required in the
Getting Started exercise, so we will not look at them in any more detail here.

1.2 Create an Integration Package

Create an integration package that contains your integration flows.

An integration package is used like a folder for your integration content (integration flows, value mappings, and
OData services). You can transport an integration package, for example, if you want to design your integration
content on a test tenant first and then transport it to a production tenant.

1. Open the Web UI using the hyperlink provided to you in the mail from SAP (the links ends with /
itspaces).
2. Go to the Design section of the Web UI.

3. Choose Create.

4. Enter a name and description for your integration package and choose Save.

Get Started with Integration Flow Development (Cloud Foundry Environment)

8 PUBLIC Get Started with Integration Flow Development
1.3 Create the Integration Flow
Create the integration flow as part of your integration package.

1. Open the Web UI, go to the Design section.

2. Select the integration package and choose Edit.
3. Go to the Artifacts tab and choose Add Integration Flow .

Get Started with Integration Flow Development (Cloud Foundry Environment)

Get Started with Integration Flow Development PUBLIC 9
4. Provide a name and description for the integration flow and choose OK.

The integration flow is added to the list of artifacts for the selected integration package.
5. Select the integration flow from the list.
An integration flow template opens that contains the following shapes: Sender (this represents your
sender system), Receiver (this represents a receiver system), Integration Process (this will later contain all
the processing steps that define how a message is processed on the tenant). The Integration Process
shape contains a Start and an End event.

Get Started with Integration Flow Development (Cloud Foundry Environment)

10 PUBLIC Get Started with Integration Flow Development
If you select a shape in the integration flow modeling area, the properties of the selected shape are displayed in
the section below the modeling area. If you click the area outside of the shapes, the properties are displayed
that are related to the integration flow as a whole (as shown in the figure above).

To start modeling, choose Edit. Notice that a palette appears to the left of the integration flow model. This
palette provides access to all integration flow step shapes that you can add to the model.

1.4 Smoke Test Scenario

This is a very simple test to verify that your SAP Cloud Platform Integration is working as expected. You do not
need any receiver system to perform this test.

In this scenario, you create a Hello World text and write it into the message body (scheduled on deployment of
the integration flow). The result is written into the message processing log which you can directly inspect with
the message monitoring application.

 Caution

This integration scenario is designed to show how to quickly (without much effort) set up and run an
integration flow without the need to configure and connect to any receiver system. It uses a Script step to
store the message payload in the message processing log (to enable you to easily check in the message
monitoring application if the message was processed without any errors).

Note that this is not according to standard best practice. When designing productive scenarios, don't store
the message payload in the message processing log. This can cause severe issues with memory
consumption. The reason is that tasks such as message processing and message monitoring share the
same memory and CPU which are available on your tenant.

In the course of this exercise, you develop the following integration flow.

To make it as easy as possible for you to develop this first integration flow, you don't need to configure any
sender system. That saves the effort for you to set up a dedicated sender system and to connect it to SAP
Cloud Platform Integration. Instead of this, message processing is triggered by a Timer event, and the inbound
message payload is created within the integration flow, in a dedicated Content Modifier step.

Furthermore, it is also not required that you set up any receiver system. To enable you to check if the message
has been processed correctly, you will configure the integration so that the message payload is written into the
message processing log (where you can easily inspect it using the Monitor application of the Web UI).

Get Started with Integration Flow Development (Cloud Foundry Environment)

Get Started with Integration Flow Development PUBLIC 11
This is how the integration flow will process the message at runtime:

1. The Timer event triggers the processing of the message (according to the settings of the Timer's
scheduler).
2. The Content Modifier step creates a message with a simple text content (Hello World!).
3. The Groovy Script step logs the payload of the message (that means, it writes the message content into
the message processing log).

When you have finished the integration flow design, you save and deploy the integration flow.

You can then monitor message processing.

Related Information

Create a Content Modifier to Define the Message Body [page 14]

Create a Script Step to Log the Payload [page 15]
Save and Deploy the Integration Flow [page 17]
Monitor Message Processing [page 19]

1.4.1 Add a Timer Start Event

1. Open the integration flow model (Edit mode), select the Sender shape, and choose the recycle bin icon (to
remove the Sender shape).

2. In the same way, remove the Start event.

3. In the palette, select the Events entry, and then select the Timer shape.

Get Started with Integration Flow Development (Cloud Foundry Environment)

12 PUBLIC Get Started with Integration Flow Development
 4. Place the Timer shape in the Integration Process shape (at the point where the Start event was previously
located).
5. In the properties section of the Timer event (displayed below the integration flow model when the Timer
event is selected in the model), go to the Scheduler tab.

6. Make sure that the option Run Once is selected.

 Note

You can, of course, try out the other settings, which enable the Timer to start message processing
periodically. However, take care when selecting these options and you have added a receiver to your
scenario. For example, in another demo scenario provided in this documentation, the receiver of the
message is an e-mail account, and you don't want your e-mail account to be inundated with
periodically generated e-mails.

Get Started with Integration Flow Development (Cloud Foundry Environment)

Get Started with Integration Flow Development PUBLIC 13
1.4.2 Create a Content Modifier to Define the Message Body
Add a Content Modifier step to create the message body.

As the integration flow has no sender, we use a Content Modifier to create a message from scratch.

1. To add a Content Modifier, go to the palette, choose the Message Transformers icon, and select the Content
Modifier icon.

2. Place the Content Modifier in the model after the Timer Start event.

3. In the Content Modifier properties section, go to the Message Body tab and enter the following string
sequence in the entry field:
Hello World!

This simulates the inbound XML message.

4. Connect the Timer event with the Content Modifier. To do this, select the Timer event.

Get Started with Integration Flow Development (Cloud Foundry Environment)

14 PUBLIC Get Started with Integration Flow Development
 5. Click the arrow icon, and drag and drop the cursor to the Content Modifier.

1.4.3 Create a Script Step to Log the Payload

Add a Script step to log the message payload.

With a Groovy Script step, you can configure the integration in such a way that the payload of the message is
written to the message processing log as attachment.

1. To add a Script step (containing a Groovy script), go to the palette and choose the Message Transformers
icon and select the Script icon.

2. In the Script submenu, select Groovy Script.

3. Place the Script step shape after the Content Modifier step and connect both shapes.
4. Select the Script step.
The context icons are displayed.

Get Started with Integration Flow Development (Cloud Foundry Environment)

Get Started with Integration Flow Development PUBLIC 15
5. Choose the + icon.
6. The default script coding of the step is displayed.

7. Replace this content by the script provided in the coding example below.

import com.sap.gateway.ip.core.customdev.util.Message;
import java.util.HashMap;
def Message processData(Message message)
{
def body = message.getBody(java.lang.String) as String;
def messageLog = messageLogFactory.getMessageLog(message);
if(messageLog != null)
{
messageLog.addAttachmentAsString("Log current Payload:", body, "text/
plain");
}
return message;
}

8. Choose OK.
The integration flow model is again displayed.

Get Started with Integration Flow Development (Cloud Foundry Environment)

16 PUBLIC Get Started with Integration Flow Development
1.4.4 Save and Deploy the Integration Flow

Save and deploy the integration flow on the tenant to be able to process it.

1. When you have finished modeling, click Save.

On successful save, a corresponding status message is displayed.

2. Click Deploy.
A message is displayed that asks you to confirm this action.

Another message is displayed when the validation has been performed and the integration flow
deployment has been triggered.

After successful deployment, a status message is displayed.

 Note

In case of a modeling error, instead of this message a Validation Failed message is displayed.
Only when you have fixed the error, deployment of the integration flow is triggered.

3. Chose the Operations view to check the status of the deployment.

Get Started with Integration Flow Development (Cloud Foundry Environment)

Get Started with Integration Flow Development PUBLIC 17
4. Click a tile in section Manage Integration Content.

You can check the deployment status of your integration flow.

It will change from Starting to Started.

There is an alternative approach to deploy an integration flow.

Open the integration package that contains the integration flow to deploy. Go to the Artifacts tab, click the
Actions button (next to the name of the integration flow which you like to deploy) and select Deploy.

Get Started with Integration Flow Development (Cloud Foundry Environment)

18 PUBLIC Get Started with Integration Flow Development
1.4.5 Monitor Message Processing

Run the integration flow and check the result of message processing.

When the integration flow has been deployed successfully, the message is processed without any further
trigger (based on the settings of the timer).

1. Go to the Operations view and select a tile under Monitor Message Processing.
If your integration flow has been processed successfully, the status Completed should be shown.

2. Select the integration flow and analyze the details area to the right of the integration flow list.

Get Started with Integration Flow Development (Cloud Foundry Environment)

Get Started with Integration Flow Development PUBLIC 19
3. Under Attachments, click Log current Payload.
You should see the message content, which consists of the following text:
Hello World!

This shows you that the message has been processed correctly.

1.5 Smoke Test Scenario with External Data Source

This is a very simple test to verify that your SAP Cloud Platform Integration is working as expected. You do not
need any receiver system to perform this test.

In this scenario, you access an OData service and get information about a product (for a specific product ID).
The result is written into the message processing log which you can directly inspect with the message
monitoring application.

 Caution

This integration scenario is designed to show how to quickly (without much effort) set up and run an
integration flow without the need to configure and connect to any receiver system. It uses a Script step to
store the message payload in the message processing log (to enable you to easily check in the message
monitoring application if the message was processed without any errors).

Note that this is not according to standard best practice. When designing productive scenarios, don't store
the message payload in the message processing log. This can cause severe issues with memory
consumption. The reason is that tasks such as message processing and message monitoring share the
same memory and CPU which are available on your tenant.

In the course of this exercise, you develop the following integration flow.

Get Started with Integration Flow Development (Cloud Foundry Environment)

20 PUBLIC Get Started with Integration Flow Development
To make it as easy as possible for you to develop this first integration flow, you don't need to configure any
sender system. That saves the effort for you to set up a dedicated sender system and to connect it to SAP
Cloud Platform Integration. Instead of this, message processing is triggered by a Timer event, and the inbound
message payload is created within the integration flow, in a dedicated Content Modifier step.

Furthermore, it is also not required that you set up any receiver system. To enable you to check if the message
has been processed correctly, you will configure the integration so that the message payload is written into the
message processing log (where you can easily inspect it using the Monitor application of the Web UI).

This is how the integration flow will process the message at runtime:

1. The Timer event triggers the processing of the message (according to the settings of the Timer's
scheduler).
2. The first Content Modifier step creates a message with only one element, a productIdentifier (to
identify a product from the product catalog).
The actual value of the productIdentifier is hard-coded in this step. If you like to process the
integration flow with another product identifier, you need to change the value in this step and re-deploy the
integration flow again. This is the drawback which results from abstaining from a dedicated sender system.
3. The second Content Modifier creates a message header (which we also call productIdentifier) and
writes the actual value of the productIdentifier element into it. This header will be used in the
subsequent step.
4. The Request Reply step passes over the message to an external data source and retrieves data (about
products) from there.
The external data source is represented by the lower WebShop shape.
The external data source supports the Open DataProtocol (OData). For our scenario, we use the ESPM
WebShop, which is based on the Enterprise Sales and Procurement Model (ESPM) provided by SAP. The
demo application can be accessed at the following address: https://espmrefapps.hana.ondemand.com/
espm-cloud-web/webshop/
For the connection to the WebShop, an OData receiver channel is used. To query for exactly one product
(for the product identifier provided with the inbound message), the header that has been created in the
preceding Content Modifier is used.
5. The OData service provides the details of one specific product (according to the product identifier provided
with the inbound message).
6. The Groovy Script step logs the payload of the message (that means, it writes the message content into
the message processing log).

You can then run the integration flow and monitor message processing as described under: Run the Integration
Flow and Monitor the Message Processing [page 29].

Related Information

Create the Script Step to Log the Payload [page 28]

Run the Integration Flow and Monitor the Message Processing [page 29]

Get Started with Integration Flow Development (Cloud Foundry Environment)

Get Started with Integration Flow Development PUBLIC 21
1.5.1 Create a Content Modifier to Define the Message Body

Add a Content Modifier step to create the message body.

As the integration flow has no sender, we use a Content Modifier to create a message from scratch.

1. To add a Content Modifier, go to the palette, choose the Message Transformers icon, and select the Content
Modifier icon.

2. Place the Content Modifier in the model after the Timer Start event.
3. In the Content Modifier properties section, go to the Message Body tab and enter the following string
sequence in the entry field:

 Sample Code

<root>
<productIdentifier>HT-1080</productIdentifier>
</root>

This simulates the inbound XML message.

4. Connect the Timer event with the Content Modifier. To do this, select the Timer event, click the arrow icon,
and drag and drop the cursor to the Content Modifier.

Get Started with Integration Flow Development (Cloud Foundry Environment)

22 PUBLIC Get Started with Integration Flow Development
1.5.2 Create a Content Modifier to Add a Header

Add a Content Modifier to your model to define a header, which will be used in a later step to filter data from the
external source.

If you remember, our input message has only one field: productIdentifier. This field will contain a product
identifier that we want to use to filter the results from the WebShop application.

To make this number available to the integration framework during message processing, SAP Cloud Platform
Integration provides the option to store the value of productIdentifier from the incoming message either
in the message header or in a data container referred to as an exchange property.

We use the first option, and to prepare the message accordingly we use a Content Modifier.

1. Add a second Content Modifier (after the first one) to the integration flow model.
2. In the properties section of the second Content Modifier, go to the Message Header tab and choose Add.
3. Specify the following parameters:
○ Name: Enter any name, for example, productIdentifier. This is the name of the header that will be
created by the Content Modifier step.
○ Type: Select XPath.

 Tip

In this example, you use an XML Path Language (XPath) expression to address a dedicated
element of your inbound message. XPath allows you to address any element in an XML structure
by using a well-defined syntax. The expression //<element name> addresses all elements with
name <element name> in the XML document.

○ Data Type: Enter java.lang.String.

○ Value: Enter //productIdentifier (which is the XPath expression that points to the
productIdentifier field in the inbound message).

4. Connect the first Content Modifier (which defines the message body) with the second one.

In other words, the Content Modifier creates a header with the name productIdentifier, which will contain
the value of the productIdentifier field of the incoming message.

1.5.3 Create the Outbound OData Channel

To call the external data source, add a Request Reply step to the integration flow model and connect this step
with the external system using an OData channel.

 Note

Follow this procedure in case you use SAP Cloud Platform Integration in the Neo environment.

Get Started with Integration Flow Development (Cloud Foundry Environment)

Get Started with Integration Flow Development PUBLIC 23
To configure SAP Cloud Platform Integration to send a request message to the external OData service (to
retrieve the required data), you need to do the following:

● Create a Request Reply step.

● Connect the Request Reply step to a Receiver shape and select the OData adapter type.
● Configure the OData adapter to specify how the OData API of the external service should be called (to
define query options, for example).

 Remember

There are currently certain limitations when working in the Cloud Foundry environment. For more
information on the limitations, refer to SAP Note 2752867 .

1. Go to the palette and select the Call entry.

2. Select External Call and in the submenu choose Request Reply.

3. Place the Request Reply shape between the second Content Modifier and the End event in the model.
Furthermore, connect the second Content Modifier with the Request Reply step and the Request Reply
step with the End event.
4. Move the Receiver shape closer to the Request Reply shape (below the Request Reply shape but outside
the Integration Process shape, as shown in the overall integration flow model under Smoke Test Scenario
with External Data Source [page 20]).
5. Connect the Request Reply shape to the Receiver shape (by selecting the Request Reply shape, clicking
the arrow icon, and dragging and dropping the cursor on the Receiver shape).
6. In the next dialog, choose adapter type OData.

Get Started with Integration Flow Development (Cloud Foundry Environment)

24 PUBLIC Get Started with Integration Flow Development
 7. In the next dialo, as Message Protocol select OData V2.

 Note

This adapter supports different versions of the OData protocol. We select version 2.0.

8. Go to the Connection tab of the OData adapter and enter the following as the Address:
https://espmrefapps.hana.ondemand.com/espm-cloud-web/espm.svc

 Tip

This is the endpoint address of the ESPM WebShop's OData application programming interface.

9. Go to the Processing tab.

10. Next to Resource Path, choose Select.

The Query Editor opens, where you can conveniently define the OData query.
The Address field is already populated with the value you just entered
11. Make sure that Remote is selected as the Connection Source, and choose Step 2.
The system connects to the WebShop service and retrieves the metadata from its OData API.
12. Choose the Search icon in the Select Entity field.

Get Started with Integration Flow Development (Cloud Foundry Environment)

Get Started with Integration Flow Development PUBLIC 25
 Select Products.
13. A list of the available elements is provided, using the information from the OData API..
Choose a set of elements for which you want to retrieve data (for example, all elements, as shown in the
next figure) and choose Step 3.

Get Started with Integration Flow Development (Cloud Foundry Environment)

26 PUBLIC Get Started with Integration Flow Development
 14. Choose the copy icon in the Filter By field and select ProductId.
15. In the next field, select Equal.
16. In the third field, enter an expression that allows the integration framework to access the message header
productIdentifier that you created in the preceding Content Modifier step.
${header.productIdentifier}

 Tip

The dollar sign and the curled brackets indicate that we are dealing with Apache's Simple Expression
Language, which is often used in SAP Cloud Platform Integration. In particular, here you see a dynamic
parameter, which has the following effect: The value of the header productIdentifier (which is
identical to the value of the productIdentifier field of the incoming message) is used dynamically
at runtime to define the OData query.

17. Choose Finish.

Get Started with Integration Flow Development (Cloud Foundry Environment)

Get Started with Integration Flow Development PUBLIC 27
1.5.4 Create the Script Step to Log the Payload

Add a Script step to log the message payload.

With a Groovy Script step, you can configure the integration in such a way that the payload of the message is
written to the message processing log.

1. To add a Script step (containing a Groovy script), go to the palette and choose the Message Transformers
icon and select the Script icon.

2. In the Script submenu, select Groovy Script.

3. Place the Script Step shape after the Request Reply step and connect both shapes.
4. Select the Script step.
The context icons are displayed.

5. Choose the + icon.

6. The default script coding of the step is displayed.

Get Started with Integration Flow Development (Cloud Foundry Environment)

28 PUBLIC Get Started with Integration Flow Development
 7. Replace this content by the script provided in the coding example below.

import com.sap.gateway.ip.core.customdev.util.Message;
import java.util.HashMap;
def Message processData(Message message)
{
def body = message.getBody(java.lang.String) as String;
def messageLog = messageLogFactory.getMessageLog(message);
if(messageLog != null)
{
messageLog.addAttachmentAsString("Log current Payload:", body, "text/
plain");
}
return message;
}

8. Choose OK.
The integration flow model is again displayed.
9. Save and deploy the integration flow.

1.5.5 Run the Integration Flow and Monitor the Message

Processing

Run the integration flow and check the result of message processing.

When the integration flow has been deployed successfully, the message is processed without any further
trigger (based on the settings of the timer).

1. When you have saved and deployed your integration flow, check the deployment status. Go to the Monitor
section of the Web UI and select a tile under Manage Integration Content.

Get Started with Integration Flow Development (Cloud Foundry Environment)

Get Started with Integration Flow Development PUBLIC 29
2. As soon as deployment has finished, the status Started should be displayed for your integration flow.

3. Go back to the overview page of the Web UI Monitor section and select a tile under Monitor Message
Processing.
If your integration flow has been processed successfully, the status Completed should be shown.

Get Started with Integration Flow Development (Cloud Foundry Environment)

30 PUBLIC Get Started with Integration Flow Development
 4. Select the integration flow and analyze the details area to the right of the integration flow list.

5. Under Attachments, click Log current Payload.

You should see the message content, which consists of the details of the product associated with the value
of productIdentifier entered in the first Content Modifier.

Get Started with Integration Flow Development (Cloud Foundry Environment)

Get Started with Integration Flow Development PUBLIC 31
This shows you that the message has been processed correctly.

1.6 Timer-Initiated Scenario with a Mail Receiver

Create a simple integration scenario that is initiated by a timer, retrieves data from an external source, and
sends the result to an e-mail account (as the receiver system).

A typical challenge addressed by an integration scenario is to retrieve data from a certain source (for example,
product details from a product catalog on a vendor's site) using certain filter criteria. We use the integration
flow described in this section to address such a use case.

In the course of this exercise, you develop the following integration flow:

To make it as easy as possible for you to develop this integration flow, you don't need to configure a sender
system. This saves you the effort of setting up a dedicated sender system and connecting it to SAP Cloud
Platform Integration. Instead, message processing is triggered by a Timer event, and the inbound message is
created within the integration flow, in a dedicated Content Modifier step.

Get Started with Integration Flow Development (Cloud Foundry Environment)

32 PUBLIC Get Started with Integration Flow Development
As a prerequisite to use the Mail adapter, you need to take care of the following things.

● Update the tenant keystore with the certificates required by the mail server.
● Create and deploy a User Credentials artifact that contains the credentials of the mail account.

This is how the integration flow processes the message at runtime:

1. The Timer event triggers the processing of the message (according to the settings of the Timer's
scheduler).
2. The first Content Modifier step creates a message with only one element: a productIdentifier (to
identify a product from the product catalog).
The actual value of the productIdentifier is hard-coded in this step. If you want to process the
integration flow with another product identifier, you need to change the value in this step and redeploy the
integration flow. This is the drawback of not having a dedicated sender system.
3. The second Content Modifier step creates a message header (which we also call productIdentifier)
and writes the actual value of the productIdentifier element into it. This header is used in the
subsequent step.
4. The Request Reply step passes the message to an external data source from which it retrieves data (about
products).
The external data source is represented by the lower WebShop shape.
The external data source supports the Open DataProtocol (OData). For our scenario, we use the ESPM
WebShop, which is based on the Enterprise Sales and Procurement Model (ESPM) provided by SAP. The
demo application can be accessed at the following address: https://espmrefapps.hana.ondemand.com/
espm-cloud-web/webshop/
An OData receiver channel is used to connect to the WebShop. The header that was created in the
preceding Content Modifier is used to query exactly one product (using the product identifier provided with
the inbound message).
5. The OData service provides the details of this product.
6. Finally, the result of the request is forwarded to an e-mail account using the Mail receiver adapter (the e-
mail server is represented by the Mail_Ser … shape on the right in the integration flow model).

When you have finished integration flow design, you can monitor message processing.

This integration flow introduces you to a number of important aspects of integration development, such as
defining an OData query and using a message header to dynamically query an OData source.

Related Information

Update the Tenant Keystore with the Certificates Required by the Mail Server [page 34]
Create and Deploy a User Credentials Artifact for the E-Mail Account [page 36]
Create the Mail Receiver Channel [page 37]
Monitor Message Processing [page 40]

Get Started with Integration Flow Development (Cloud Foundry Environment)

Get Started with Integration Flow Development PUBLIC 33
1.6.1 Update the Tenant Keystore with the Certificates
Required by the Mail Server
Add the required server root certificates (required by the e-mail provider) to the tenant keystore.

The tenant keystore contains the key pairs and certificates that are required (on the tenant side) to establish
trusted communication with the connected systems.

When establishing the connection to the SAP Cloud Platform Integration tenant, the e-mail server needs to
authenticate itself against SAP Cloud Platform Integration using a digital server certificate. For this purpose,
the tenant keystore must contain a root certificate that is also trusted by the e-mail server.

You can download the required certificates usually on a dedicated section of the email provider's website. You
might search for server certificate to get more information. However, note that the procedure might differ
depending on the email provider.

Get the E-Mail Servers' Certificate

To get the e-mail servers' root certificate, you can do the following:

1. Open the website that hosts the mail account you like to address with the Mail adapter.
2. In the browser address field, click the lock icon and select Certificate (Valid) (example for using Google
Chrome).

3. In tab Certification Path doubleclick the uppermost node (which is the root certificate).

Get Started with Integration Flow Development (Cloud Foundry Environment)

34 PUBLIC Get Started with Integration Flow Development
 4. Click Details and select Copy to File ....

5. In the wizard, click Next.

6. On the next screen, keep the setting DER encoded binary X.509 (.CER) and click Next.
7. Choose a directory on your computer where to store the certificate file and a name.
8. Click Next and then Finish.

The root certificate is stored as file with extension .cer on your computer.

Finally, you need to import the downloaded certificates to the tenant keystore. To do this, open the Keystore
monitor.

1. Go to the Monitor section of the Web UI and select the Keystore tile under Manage Security.
All certificates that are already included in the keystore are displayed. If you have only recently started
working with SAP Cloud Platform Integration, these are the certificates provided by SAP initially when
providing the tenant for you.
2. Choose Add Certificate .

Get Started with Integration Flow Development (Cloud Foundry Environment)

Get Started with Integration Flow Development PUBLIC 35
3. Browse to the certificate stored on your computer, provide an alias (to identify the certificate in the
keystore) and choose Deploy.
The certificate is added (under the alias name) to the list of keystore entries.
4. Repeat this task for all certificates that you have downloaded.

 Note

You might also need to change the settings of your e-mail account so that the mail server accepts
connections to remote applications with a lower security level (for example, for Yahoo mail, this is the Less
Secure Apps setting). If you don't do this, the integration flow might raise an error during processing.

 Note

If you don't upload the required root certificate to the tenant keystore and try to execute the integration
flow (when having finished its design), message processing will fail with the following error message
starting with:

 Sample Code

javax.mail.MessagingException: Could not connect to SMTP host:

smtp.mail.yahoo.com, port: 465;
nested exception is:
javax.net.ssl.SSLHandshakeException ...

1.6.2 Create and Deploy a User Credentials Artifact for the E-

Mail Account

Deploy a User Credentials artifact that contains the user name and password for your receiver mail account.

1. Go to the Monitor section of the Web UI and select the Security Material tile under Manage Security.

Get Started with Integration Flow Development (Cloud Foundry Environment)

36 PUBLIC Get Started with Integration Flow Development
 2. Choose Add User Credentials .

3. As Name, enter the User Credentials name that you specified in the Mail receiver adapter, and as User
enter the e-mail account user name (also specified in the fields From and To in the Mail receiver adapter).
Also provide the password of the mail account.

 Note

Storing the user name and password in a separate artifact increases the security level of integration
development.

4. Choose Deploy.

1.6.3 Create the Mail Receiver Channel

Add a Mail receiver channel to enable the integration flow to send messages to an e-mail account.

1. First, add a second receiver to represent the e-mail account. In the integration flow model (in Edit mode),
select the Participants entry from the palette and select Receiver.

2. Place the Receiver shape on the right side of the model, outside the Integration Process shape.
You can rename the shape to Mail_Receiver (for example).

Get Started with Integration Flow Development (Cloud Foundry Environment)

Get Started with Integration Flow Development PUBLIC 37
3. Select the End event, click the arrow button and drag and drop the cursor on the Receiver shape.

4. Select Mail as the Adapter Type.

5. In the Mail adapter properties section (below the model), go to the Connection tab and specify the
following Mail adapter parameters.
The figure shows example settings, which are explained further below.

Get Started with Integration Flow Development (Cloud Foundry Environment)

38 PUBLIC Get Started with Integration Flow Development
 ○ Address: Enter the address of your mail provider, followed by a colon and the port number. The
example in the figure shows the address for Yahoo Mail (smtp.mail.yahoo.com:465) and SMTP
protocol.
○ Protection: Select SMTPS.
○ Authentication: Select Plain User/Password.
○ Credential Name: Enter a name for a User Credentials artifact that you will create in a subsequent step,
for example, MyCredentials.
The User Credentials artifact will contain the user name and password for the e-mail account to which
the message is to be sent.
○ From and To: Enter the mail address of the e-mail account that should receive the message.
○ Subject: Enter a meaningful text.
Keep the default settings for the other parameters.
6. Save and deploy the integration flow.

Get Started with Integration Flow Development (Cloud Foundry Environment)

Get Started with Integration Flow Development PUBLIC 39
1.6.4 Monitor Message Processing

As you use a Timer event to trigger the message processing, the integration flow is processed as soon as it is
deployed.

1. To check whether the processing has been executed correctly, go to your e-mail account. You should find a
mail with the following content:

2. Finally, check how the message was processed by opening the Monitor section of the Web UI.
3. Choose a tile under Monitor Message Processing and you should find your message with the integration
flow name.

4. Open the integration flow in Edit mode, click the first Content Modifier and on the Message Body tab
change the value of the productIdentifier to HT-2001 and redeploy the integration flow.
5. Once the integration flow has been deployed successfully, you should receive an e-mail with details about
another product.

Get Started with Integration Flow Development (Cloud Foundry Environment)

40 PUBLIC Get Started with Integration Flow Development
1.7 Sender-Initiated Scenario (with HTTPS Sender
Adapter)

Create a simple integration scenario that is initiated by a sender (using the HTTPS sender adapter).

With the following steps, you can easily modify and extend the previously built integration flow with the email
receiver (Timer-Initiated Scenario with a Mail Receiver).

The figure shows the integration flow model that you get as a result of this exercise.

In the modified integration flow, an HTTP client instead of a Timer event triggers message processing.

Furthermore (to simplify the design), we have merged the steps processed by two different Content Modifier
steps in the previously built integration flow into one Content Modifier step.

 Note

As a prerequisite to execute this integration flow in the Cloud Foundry environment, you need to authorize
the sender system (HTTP client) to call the integration flow endpoint. For that purpose, you create a service
instance on SAP Cloud Platform and generate service key credentials (which can then be used by the HTTP
client to call the integration flow endpoint).

This is how the integration flow processes the message at runtime:

1. The HTTP client (represented by the Sender shape) sends an HTTP request to SAP Cloud Platform
Integration through an HTTPS sender channel. The HTTPS request body, which is in JavaScript Object
Notation (JSON) format, contains a product identifier.
2. The JSON-to-XML converter transforms the request body into XML format (which can be processed in the
following step, the Content Modifier).
3. The Content Modifier creates a message header (which we also call productIdentifier) and writes the
actual value of the productIdentifier element into it. This header is used in the subsequent step.
In this exercise, you use one Content Modifier to create the header and to write the message body.
4. The Request Reply step passes the message to an external data source and retrieves data (about orders)
from there.
The external data source supports the Open DataProtocol (OData). For our scenario, we use the ESPM
WebShop, which is based on the Enterprise Sales and Procurement Model (ESPM) provided by SAP. The

Get Started with Integration Flow Development (Cloud Foundry Environment)

Get Started with Integration Flow Development PUBLIC 41
 demo application can be accessed at the following address: https://espmrefapps.hana.ondemand.com/
espm-cloud-web/webshop/
5. An OData receiver channel is used for the connection to the OData source. To query for exactly one
product (for the product identifier provided with the inbound message), the header that was created in the
preceding Content Modifier is used.
6. The OData service provides the details of one specific product, which is identified by the actual value of the
productIdentifier field (provided with the inbound HTTP request).
7. Finally, the result of the request is forwarded to an e-mail account using the Mail receiver adapter (the e-
mail server is represented by the right Mail … shape in the integration flow model).

When you have finished the integration flow design, you can send the message through the HTTP client.

Related Information

Timer-Initiated Scenario with a Mail Receiver [page 32]

Authorize the HTTP Client to Call the Integration Flow Endpoint in the Cloud Foundry Environment [page 42]
Create the HTTPS Sender Channel [page 45]
Add the JSON to XML Converter [page 46]
Create the Mail Receiver Channel [page 37]
Send the HTTP Request and Process the Integration Flow [page 47]

1.7.1 Authorize the HTTP Client to Call the Integration Flow

Endpoint in the Cloud Foundry Environment

You perform these steps to authorize the sender (HTTP client) to call the SAP Cloud Platform Integration
integration flow endpoint.

 Note

You need to perform these steps only in case you use SAP Cloud Platform Integration in the Cloud Foundry
environment.

These steps imply that you create a service instance on SAP Cloud Platform and generte a service key for it.
The credentials which you get as a result can be used by the HTTP client to call the integration flow endpoint.

Create Service Instance

In the context of this scenario, you can think of the service instance as a technical user that can be associated
with the sending system's (HTTP client's) request.

You perform the following steps using SAP Cloud Platform Cockpit.

Get Started with Integration Flow Development (Cloud Foundry Environment)

42 PUBLIC Get Started with Integration Flow Development
 1. Choose your space and navigate to Services Service Marketplace and select the tile Process
Integration Runtime.
2. In case a service instance is not available yet, create a new one.
Select Instances New Instance .

3. Choose Next.
4. Enter the below command in the entry field.

 Sample Code

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

With this command, you associate the service instance with the role ESBMessaging.send which is
required to call an integration flow endoint.

5. Choose Next and on the next screen again choose Next.

Get Started with Integration Flow Development (Cloud Foundry Environment)

Get Started with Integration Flow Development PUBLIC 43
6. Enter an instance name and choose Finish.

Create Service Key

With this step, you generate credentials to communicate with a service instance.

The sender application (HTTP client) uses these credentials (clientid and clientsecret) to access the
SAP Cloud Platform Integration integration flow endpoint.

1. Select the instance.

2. Choose Service Keys.

3. Choose Create Service Key.

4. Enter a name for the service key.
5. Choose Save.
The service key is created.

You need to copy the values of clientid and clientsecret to your clipboard or to a text editor for later
reference.
These values specify the credentials of the user associated with the sending application.

Get Started with Integration Flow Development (Cloud Foundry Environment)

44 PUBLIC Get Started with Integration Flow Development
1.7.2 Create the HTTPS Sender Channel

Add an HTTPS sender channel to enable the integration flow to receive HTTP requests.

1. Select the integration flow and choose Edit.

2. Click the Sender shape. The context icons for the Sender appear.

 Note

If you choose the information icon, the version of the integration flow component is displayed.

Do not confuse the version of an individual integration flow component with the software version of
SAP Cloud Platform Integration. An integration flow component gets a new version each time a new
feature is added to it by SAP. Let's imagine a situation where you started modeling an integration flow
some time ago and now want to continue working on it. Let's assume that SAP has updated the
software in the meantime. A new version of an integration flow step or shape that you have used is now
available, containing a new feature. You can continue to use the old component version, but if you want
to use the new feature you need to update to the new version.

3. Click the arrow icon and drag and drop the cursor on the Start event.
The list of available adapter types is displayed in a dialog.

4. Choose adapter type HTTPS .

The properties of the adapter are shown below the model.
5. Go to the Connection tab.

Get Started with Integration Flow Development (Cloud Foundry Environment)

Get Started with Integration Flow Development PUBLIC 45
 Specify the following parameters:
○ Address: This parameter defines the endpoint under which the integration flow can be called from the
sender. Start the address with a slash, for example,/FirstFlow.
○ Authorization and User Role: You want to configure your first integration flow so that the inbound
request is authenticated using basic authentication (based on user credentials). To keep it simple, you
use your dialog user. During onboarding, you also made sure that the role ESBMessaging.send was
assigned to your user (and this setting was also used when configuring the HTTP client).
○ CSRF Protected: Keep this option selected (default setting). It ensures that your integration flow is
protected against Cross-Site-Request-Forgery, a kind of attack where a malicious party can perform
harmful actions by masquerading as the logged in user (the user specified for the HTTP client in our
case).

1.7.3 Add the JSON to XML Converter

Add a JSON-to-XML converter to convert the HTTP request, which is in JavaScript Object Notation (JSON)
format, to XML for further processing.

With the HTTP client, we send a POST request with a request body in JSON format. To enable the subsequent
steps to process the message, it needs to be converted to XML first. To perform the required conversion, you
can use the JSON-to-XML converter.

1. In the palette, select the Message Transformers entry and then choose Converter.

2. In the submenu, choose JSON to XML Converter.

Get Started with Integration Flow Development (Cloud Foundry Environment)

46 PUBLIC Get Started with Integration Flow Development
 3. In the integration flow model, place the shape inside the Integration Process shape after the Start event.
The model should now look like this:

1.7.4 Send the HTTP Request and Process the Integration

Flow

Set up an HTTP client using Postman and send the HTTP request.

1. Install an HTTP client on your computer.

2. Since the HTTPS sender adapter is configured to expect User Role authorization, the authentication mode
used is basic authentication (with user credentials).
Select the corresponding authentication mode for your HTTP client.
Depending on whether you work in the Neo or the Cloud Foundry environment, the way how to get the
required credentials differs.
○ Neo environment:
Specify the credentials of the user that is associated with the inbound HTTP request and that has been
assigned the role ESBMessaging.send in SAP Cloud Platform Cockpit .
○ Cloud Foundry environment:
As credentials, enter the values of clientid and clientsecret that have been generated when you
created the service key during onboarding.
The following figure shows the related dialog from SAP Cloud Platform Cockpit.

Get Started with Integration Flow Development (Cloud Foundry Environment)

Get Started with Integration Flow Development PUBLIC 47
3. As you have selected CSRF Protected in the HTTPS adapter, you need to fetch a CSRF token.
The CSRF token is then used to place the POST request for your integration flow.
1. Find out the endpoint address of the integration flow. To do this, go to the Monitor section of the Web
UI.
2. Choose a tile under Manage Integration Content.
3. Select your integration flow. It should be displayed in the list of deployed artifacts with status Started.

4. Copy the endpoint URL to the clipboard.

The URL should end with /http/<Address specified in the HTTPS adapter>.
4. Using your HTTP client, send a GET request to the endpoint address.
Make sure that you send a header with the key X-CSRF-token and the value fetch with the request.
5. You should receive the CSRF token.

You can now send the POST request to the integration flow.

1. Specify the same authentication settings as for the GET request above.

Get Started with Integration Flow Development (Cloud Foundry Environment)

48 PUBLIC Get Started with Integration Flow Development
 2. Specify the following HTTP request body (JSON format):

 Sample Code

{
"productIdentifier": "HT-1080"
}

3. Copy the value of the CSRF token (obtained from the GET request above) to the clipboard.
4. Add a header to the request.
In the Key field, enter X-CSRF-Token and in the Value field, enter the value of the CSRF token from your
clipboard.
5. Send the request.
You should get the details of the product with productIdentifier HT-1080.
6. Go to the e-mail account specified in the Mail adapter. You should have received an e-mail like this:

7. Place another POST request with a body containing productIdentifier HT-2001, and you receive details of
another product.
8. Finally, check how the message was processed by opening the Monitor section of the Web UI.
Choose a tile under Monitor Message Processing and you should find your message with the integration
flow name.

Get Started with Integration Flow Development (Cloud Foundry Environment)

Get Started with Integration Flow Development PUBLIC 49
Important Disclaimers and Legal Information

Hyperlinks
Some links are classified by an icon and/or a mouseover text. These links provide additional information.
About the icons:

● Links with the icon : You are entering a Web site that is not hosted by SAP. By using such links, you agree (unless expressly stated otherwise in your
agreements with SAP) to this:

● The content of the linked-to site is not SAP documentation. You may not infer any product claims against SAP based on this information.
● SAP does not agree or disagree with the content on the linked-to site, nor does SAP warrant the availability and correctness. SAP shall not be liable for any
damages caused by the use of such content unless damages have been caused by SAP's gross negligence or willful misconduct.

● Links with the icon : You are leaving the documentation for that particular SAP product or service and are entering a SAP-hosted Web site. By using such
links, you agree that (unless expressly stated otherwise in your agreements with SAP) you may not infer any product claims against SAP based on this
information.

Beta and Other Experimental Features

Experimental features are not part of the officially delivered scope that SAP guarantees for future releases. This means that experimental features may be changed by
SAP at any time for any reason without notice. Experimental features are not for productive use. You may not demonstrate, test, examine, evaluate or otherwise use
the experimental features in a live operating environment or with data that has not been sufficiently backed up.
The purpose of experimental features is to get feedback early on, allowing customers and partners to influence the future product accordingly. By providing your
feedback (e.g. in the SAP Community), you accept that intellectual property rights of the contributions or derivative works shall remain the exclusive property of SAP.

Example Code
Any software coding and/or code snippets are examples. They are not for productive use. The example code is only intended to better explain and visualize the syntax
and phrasing rules. SAP does not warrant the correctness and completeness of the example code. SAP shall not be liable for errors or damages caused by the use of
example code unless damages have been caused by SAP's gross negligence or willful misconduct.

Gender-Related Language
We try not to use gender-specific word forms and formulations. As appropriate for context and readability, SAP may use masculine word forms to refer to all genders.

Videos Hosted on External Platforms

Some videos may point to third-party video hosting platforms. SAP cannot guarantee the future availability of videos stored on these platforms. Furthermore, any
advertisements or other content hosted on these platforms (for example, suggested videos or by navigating to other videos hosted on the same site), are not within
the control or responsibility of SAP.

Get Started with Integration Flow Development (Cloud Foundry Environment)

50 PUBLIC Important Disclaimers and Legal Information
Get Started with Integration Flow Development (Cloud Foundry Environment)
Important Disclaimers and Legal Information PUBLIC 51
www.sap.com/contactsap

© 2019 SAP SE or an SAP affiliate company. All rights reserved.

No part of this publication may be reproduced or transmitted in any form

or for any purpose without the express permission of SAP SE or an SAP
affiliate company. The information contained herein may be changed
without prior notice.

Some software products marketed by SAP SE and its distributors

contain proprietary software components of other software vendors.
National product specifications may vary.

These materials are provided by SAP SE or an SAP affiliate company for

informational purposes only, without representation or warranty of any
kind, and SAP or its affiliated companies shall not be liable for errors or
omissions with respect to the materials. The only warranties for SAP or
SAP affiliate company products and services are those that are set forth
in the express warranty statements accompanying such products and
services, if any. Nothing herein should be construed as constituting an
additional warranty.

SAP and other SAP products and services mentioned herein as well as
their respective logos are trademarks or registered trademarks of SAP
SE (or an SAP affiliate company) in Germany and other countries. All
other product and service names mentioned are the trademarks of their
respective companies.

Please see https://www.sap.com/about/legal/trademark.html for

additional trademark information and notices.

THE BEST RUN