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 won't be using attachments, but you can learn about 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.

Read more here:

File Transfer

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

Read more here:

Decouple integration flows

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

Read more here:

Decouple with SOAP Adapter

This lesson utilizes 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.

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 JSON format.

Read more here:

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 for the ProductID

Business Scenario

To expand your integration process, you now want to store the currently processed productID as an Exchange Property for subsequent steps, for each loop.

The following overview image can help you understand the location and functionality of the new component.

Task Flow

In this exercise, you will perform the following tasks:

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

Prerequisites

You have completed the task of creating and configuring a General Splitter.

Outcome After This Exercise

The Exchange Property is used to store the productID that is being processed in this loop.

What Do You Learn Within This Exercise?

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

Exercise Options

To carry out this exercise, you can choose from the following options:

  1. Live Environment: Using the instructions provided below, you can perform the steps in your SAP BTP account.
  2. Platform Simulation: Follow the step-by-step instructions within the simulation.
  3. Side-by-side: Follow the step-by-step instructions within the simulation and perform the steps in your SAP BTP account simultaneously.

Note

We strongly recommend to perform the steps in the live environment.
ExerciseStart Exercise

Task 1: Log on to the integration flow DelayedDelivery_Process

Steps

  1. Log on to the integration flow DelayedDelivery_Process via Integration Suite.

    1. Navigate within the Integration Suite welcome page toDesign → Integrations → DelayedDelivery_Package_randomNumber → DelayedDelivery_Process.

    2. This is the status after the last exercise step.

    3. Imagine that the integration flow is more edited.

Task 2: Create and Configure an Content Modifier

Steps

  1. 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.

    3. Proceed in the same manner to the right of the End Event.

  2. 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 tab Exchange Property.

    4. Choose the Add button, and enter the following data.

      Field NameInput
      ActionCreate
      NameProductID
      Source TypeXPath
      Source Value//ProductID
      Data Typejava.lang.String (Note: S is in uppercase !)

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

Steps

  1. Save as version, deploy, and debug your integration process.

    1. Perform the following steps:

      1. Save as version.
      2. Deploy.
      3. Jump to the Overview > Manage Integration Content.
      4. Set log level to trace.
      5. Deploy again.
      6. Jump again to the Overview → Manage Integration Content.

    2. Navigate to your Integration Flow Model in Overview → Monitor Message Processing → Message Processing Run.

    3. Check out the two loops from the General Splitter No. 1 and No. 2.

    4. Choose the End Event from the first loop.

    5. Switch to the Message Content tab, and choose the Exchange Property link.

      Now you will see the productID property is set correctly.

    6. Repeat the procedure at the second loop.

  2. 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 will be taken directly to the help site of the Content Modifier.

Log in to track your progress & complete quizzes