Tell us what you think

We want to create the best possible experience for our learners. Your feedback helps us to improve the experience for everyone.

Learning the Basics

Objective

After completing this lesson, you will be able to create and configure a content modifier

The Basics of Process Modeling

In this lesson, the following topics are discussed:

Handle Attachments.
File Transfer.
Decouple integration flows.
Use Converters.

Handle Attachments

In this lesson, you are not using attachments, but you will learn how to handle them effectively in integration flows, where a file is specified in a format such as text files, and attached as an exchange parameter.

File Transfer

This lesson covers transferring files from a server, although it does not involve the use of attachments.

Decouple integration flows

In this lesson, you learn about decoupling processing, which involves asynchronous decoupling of the processing of integration scenarios between the sender and the integration flow.

Decouple with SOAP Adapter

This lesson uses a specific configuration for the SOAP adapter, which invokes the integration flow asynchronously. The configuration is as follows:

Message Exchange Pattern: One-Way.
Process Settings: WS Standard.

Screenshot of the call of the integration flow with Message Exchange Pattern: One-Way and Processing Settings: WS Standard highlighted in red.

Use Converters

This lesson provides guidance on how to perform file format conversion, but it is important to note that converters are necessary as there is no internal message format like in Process Integration with the XI Message Protocol. XML is the most commonly used format as it is required for Message Mapping and XPATH operations, as well as the JSON format.

Summary

Attachments can be created, modified, and combined, while files can be retrieved using the SFTP adapter in various ways. Asynchronous decoupling of integration flows separates the call time from the processing time. It's also important to note that XML or JSON formats are necessary for message mapping and XPATH operations.

Create and Configure a Content Modifier

Business Scenario

To expand your integration process, you now want to store the currently processed ProductID and enrich it in this process. The option to use an Exchange Property into a Content Modifier enables you to enrich your Message.

Task Flow

In this exercise, you will perform the following tasks:

Log on to the integration flow DelayedDelivery_Process.
Create and configure a Content Modifier.
Save as version, deploy, and debug your integration process.

Prerequisites

You have completed the task of creating and configuring an OData call.

Outcome after this exercise

The Exchange Property is used to store the ProductID that is being processed.

What do you learn within this exercise?

You learn how to use and configure a Content Modifier with an Exchange Property.

Task 1: Log on to the Integration Flow DelayedDelivery_Process

Steps

Log on to the integration flow DelayedDelivery_Process via SAP Integration Suite.
1. Navigate within the SAP Integration Suite welcome page to Design → Integrations → DelayedDelivery_Package_CLD900_Date_Number → DelayedDelivery_Process_Number.
2. This is the status after the last exercise step.
3. Imagine that the integration flow is more edited.

Task 2: Create and Configure a Content Modifier

Steps

Enlarge the swim lane of your processes.
1. Keep adjusting the right border of your swim lane until the border line becomes active.
2. Use the mouse to drag the center point towards the right side.
3. Proceed in the same manner to the right of the End_Message_ Event.
Create and configure a Content Modifier.
1. Position an additional Content Modifier object after the General Splitter, just like at the beginning.
2. Name it Modify_setProductIDasProperty.
3. Switch to the Exchange Property tab.
4. Choose the Add button, and enter the following data.
  Field Name Value
  Name ProductID
  Source Type XPATH
  Source Value //ProductID
  Data Type java.lang.String (S is upper case)

Field Name	Value
Name	ProductID
Source Type	XPATH
Source Value	//ProductID
Data Type	java.lang.String (S is upper case)

Task 3: Save as Version, Deploy, and Debug your Integration Process

Steps

Save as version, deploy, and debug your integration process.
1. Perform the following steps:
  1. Save as version.
  2. Deploy.
  3. Jump to Overview → Manage Integration Content.
  4. Set the log level to trace.
  5. Deploy again.
  6. Jump again to Overview → Manage Integration Content.
2. Navigate to your Integration Flow Model in Overview → Monitor Message Processing → Message Processing Run.
3. Choose End_Message_Event from the first loop.
1. Switch to the Message Content tab, and choose the Exchange Property link.
  Now, you see the ProductID as a property, which is set correctly.
Learn more about the Content Modifier component.
1. Return to your Integration Process.
2. Access the configuration bar of the Content Modifier.
3. Choose the question mark symbol.
4. You are taken directly to the help site of the Content Modifier.