How to Import Standard ESR Content to PI/PO

SAP delivers standard Enterprise Service Repository (ESR) content such as interfaces, message types, mapping, etc. for cross-application integration. For example, for Point of Sale (POS) integration that is built on Trade Service Framework (TOF) in IS-Retail or SAP HANA, we need to import the standard content of Software Component Version EA-RETAIL. Certain SAP standard content is not imported to ESR at the time of system installation. Installation depends on customer requirements. Hence, you should upload standard content manually to ESR when the requirement arises.

In this article, we will discuss,

  1. What is Standard Content
  2. Real-Life Use Cases of Standard Content
  3. Step-by-step Guide on How to Import Standard Content to ESR
  4. How to Customize Standard XI/PI Content and Services

The Illustration in this article is built in SAP Systems,


What is Standard XI/PI ESR Content?

With most SAP systems, SAP provides a collection of predefined solutions and a set of objects, for example, standard Function Modules and BAPIs in SAP S4 HANA.

Similarly, SAP has provided a set of predefined interface objects for SAP XI, PI, PO, and HCI. The standard objects include Message Mapping, Operation Mapping, Service Interfaces, Data Types, Message Types, etc. These predefined objects are called XI/PI Standard Content and are reusable in integration scenarios. Additionally, they can be enhanced or extended according to your custom requirements.


Uses Cases of Standard XI/PI/PO ESR Content:

To further understand the meaning of standard content and its use, let’s look at a few practical cases.

Here are a few examples where I used PI standard content in SAP implementation projects and SAP integration projects,

  1. Extended Receiver Determination
  2. Point of Sales (POS) integration with SAP
  3. Outbound Business Partner communication
  4. B2B EDI Integration Cockpit (B2B Add-on) installation

Extended Receiver Determination

Extended receiver determination technique is used to determine the receiver(s) of messages dynamically at runtime using inbound message content. To implement this receiver determination method we require several standard ESR objects provided by SAP.

For example, we need standard Service Interface ‘ReceiverDetermination’ and standard ‘Receivers’ Message Type/Data Type. All these objects are available in standard SWCV SAP BASIS under namespace ‘http://sap.com/xi/XI/System’.

Standard ESR content of SAP BASIS SWCV which is used for extended receiver determination technique in SAP PI
Standard Content of SAP BASIS SWCV used for Extended Receiver Determination

Point of Sales (POS) Integration with SAP HANA

POS integration with SAP is a very common practice in most, if not all, SAP IS-Retail or SAP HANA implementations. POS processors are some of the most important aspects when it comes to automation of Retail processors with SAP. Hence, SAP has provided a set of standard Proxy services to integrate SAP HANA or SAP IS-Retail with POS.

For example, we can use the outbound proxy service interface ‘MerchandiseERPReplicationBulkRequest_Out’ to send Articles (materials) and prices (recommended retail price, etc.) from SAP HANA to POS. Standard objects needed for POS integration are provided by SAP in SWCV EA-RETAIL. In SAP IS-Retail or SAP HANA systems, you can trigger proxy messages and create Article Master and Price XMLs using transaction WESOUT.

Standard proxy (SOAP) services of IS-Retail and SAP HANA systems in EA-RETAIL SWCV in ESR
Standard Proxy(SOAP) services of EA-Retail SWCV imported to ESR
MerchandiseERPReplicationBulkRequest_Out and other services of EA-RETAIL SWCV in ESR.
Standard Proxy service used for WESOUT imported to ESR

Business Partner Communication

There are instances where Business Partner master data in SAP should be communicated with legacy systems and other third-party systems. Similar to POS integration services, SAP HANA has provided special standard proxy service interfaces to trigger Business Partner master data out of SAP system. You can use these services in integration scenarios to trigger bulk data as well as delta information using the change pointers technique.

For example, ‘BusinessPartnerSUITEBulkReplicateRequest_Out’ service triggers Business Partner information from SAP HANA. In S4 HANA, SAP recommends using this standard proxy service instead of DEBMAS and CREMAS iDocs for integration purposes. Check the note 202265093 for more information.

From SAP S4 HANA back-end system, you can trigger these BP messages via transaction DRFOUT.

Service ‘BusinessPartnerSUITEBulkReplicateRequest_Out’ and other standard services are available under SWCV S4FND namespace http://sap.com/xi/SAP_BS_FND/MDG/Global2′.

Standard proxy (SOAP) service BusinessPartnerSUITEBulkReplicateRequest_Out and other standard services of SWCV S4FND imported in ESR
Business partner replication standard service in SWCV S4FN in ESR

Not only are outbound interfaces available with the standard content, but inbound proxy services too.

B2B Add-on Installation

Organizations can use the B2B integration cockpit to build EDI interfaces between SAP and EDI partners. In addition to EDI conversions, B2B cockpit can handle content conversions of plain text and CSV files. Before you can start using the B2B add-on for integration scenarios, you must install and setup the integration cockpit.

Under the installation, you need to set up B2B Mapping Kit, B2B Tool Kit, and Standard EDI content.

B2B Toolkit standard content in ESR
B2B Toolkit standard content in ESR
B2B Mapping Kit standard content imported to ESR
B2B Mapping Kit standard content imported to ESR

Prerequisites to Upload Standard Content:

Users should have AP_XI_ADMINISTRATOR or SAP_XI_CONTENT_ORGANIZER roles assigned.

Also, the Software Component Version should be installed in the System Landscape Directory (SLD). Refer to step 1 and step 4 of the installation guide below.


Step-by-step Guide on How to Upload Standard Content to ESR:

Let’s look at how to import standard content to ESR in detail. In the illustration, we will import the standard contents of EA-RETAIL Software Component Version.

To successfully import standard XI/PI/PO content to ESR, you need to follow these steps,

  1. Verify if SWCV is available in SLD
  2. Download ESR content ZIP file from SAP Service Marketplace
  3. Unzip the Downloaded File to Extract the TPZ File
  4. Import Standard SWCV to ESR from SLD
  5. Upload TPZ File to ESR

Step 1: Check if Software Component Is Available in SLD.

Go to SLD > SWCV and check if SWCV EA-RETAIL is available.

EA-RETAIL Software Component version 618 available in SLD
EA-RETAIL Software Component version 618 available in SLD.

Step 2: Download ESR Content ZIP File from SAP Service Marketplace.

Go to SAP Service Marketplace > Software Center using URL https://launchpad.support.sap.com/#/softwarecenter

Select support packages and patches from the main menu
Select support packages and patches from the main menu.

Under Support Packages and Patches letter “E”, select ESR Content (XI Content).

Select ESR Content XI Content
Select ESR Content XI Content

Access the individual version files of EA-RETAIL Software Component by selecting XI Content EA-RETAIL.

XI Content EA-RETAIL
Select XI Content EA-RETAIL.

Download the latest or compatible version of the content to client.

Select the SWC Version
Select Software Component Version.

Select the patch level of EA-RETAIL version that’s compatible with your system. I will be downloading 618 patch level 0.

Select the correct patch level
Select the correct patch level.

Step 3: Unzip Downloaded ESR Content.

Unzip downloaded zip file and locate the .tpz file.

ESR .tpz file for EA-RETAIL unzipped from the downloaded file
ESR .tpz file

Step 4: Import Standard SWCV to ESR from SLD.

Import EA-RETAIL Software Component Version to ESR.

Right-click on SWCV, select “new” and import SWCV from SLD.

Import Software Component Version to ESR from SLD
Import Software Component Version to ESR from SLD
Select the EA-RETAIL Software Component Version to ESR from SLD SWCV list
Select the EA-RETAIL Software Component Version to ESR from SLD SWCV list.

Step 5: Import ESR Content from .TPZ file.

Import XI Content .TPZ file using “Import Design Objects” option under “Tools” menu.

Import .tpz file to ESR using Import Design Objects
Import .tpz file to ESR.
Select tpz file from client
Select tpz file from client.

ESR content of EA-RETAIL Software Component Version will be available after successful import.

ESR Content under SWCV EA-RETAIL after a successful import.
ESR Content imported successfully in ESR

How to Enhance or Customize Standard Content

As we discussed previously, these are integration objects which are provided by SAP to be reused in organizational integration needs. But standard objects provided by SAP may not be a 100% match to your requirement. In this situation, you must adjust and customize these objects to implement the complete integration solution according to your needs.

Let’s assume the standard service ‘MerchandiseERPReplicationBulkRequest_Out’ for POS article master integration does not completely fit your requirement. What if you want to send custom Z field information of the Article master in the same service? In this case, you must add custom segments and data fields to the standard message type of the service which in turn will be reflected in the standard service.

But you should not directly change the standard objects. You need to customize the proxy service by adding custom fields to the message type/data type using Data Type Enhancement method.


You can find more examples on how to install standard XI content in my previous blog post on B2B Add-On Installation Guide. If you have any questions, leave a comment below.

Encode Message Payload to Base64 on CPI!

How to use Base64 message encoder in SAP Integration Suite.

Subscribe for more

My First Interface on CPI!

Learn how to develop your first iFlow on SAP Integration Suite within 7 minutes!

Subscribe for more

4 thoughts on “How to Import Standard ESR Content to PI/PO

  1. Sandeep says:

    Hi Isuru,

    It’s very informative and great blog .

    Please throw some blogs of CPI as well if you get a chance.

    Regards,
    Sandeep

    • Isuru Fernando says:

      Hello Sandeep!

      I will try my best to write about CPI in future articles. Thank you!

      Did you know that you can become a contributing author for SAP Integration hub? 😉 Register via the home page if you are interested.

      Cheers!
      Isuru

Leave a Reply

Your email address will not be published. Required fields are marked *