Introducing the Integration Suite, Managed Gateway Mapping Tool

Objective

After completing this lesson, you will be able to explain how the managed gateway mapping tool works, describe the mapping process steps, highlight key features, and define node functions for custom data mapping.

Mapping Repository

The managed gateway offers standardized SAP mapping content that converts S/4HANA message formats into SAP Business Network’s native cXML format. Additionally, the mapping tool, part of the SAP Integration Suite extension tools for spend management and business network, enables buyers to create their own custom mappings. This self-service feature supports the need for personalized mappings. The managed gateway provides three types of mappings within the SAP Integration Suite.

Type	Definition
Standard Mapping	The mappings provided with each integration. The mapping transformations are available for every document type in the managed gateway.
,Manual Extension Mapping	Mappings developed by the SAP Implementation Services team under special circumstances.
Custom Mapping	The mappings created by buyers using the self-service managed gateway mapping tool.

A flowchart showing three types of document mappings in a managed gateway.

The managed gateway allows buyers to keep the format they use when sending transaction documents between SAP ERP and SAP Business Network. It receives documents from SAP ERP or SAP S/4HANA system in a non-cXML format, converts them into cXML format, and sends them to SAP Business Network.

When you upgrade to a higher version of the managed gateway add-on, the mapping tool automatically migrates the custom mappings to the new version of the add-on.

Buyers have individual business process requirements and standards specific to their needs, often requiring customized solutions. With the managed gateway mapping tool, buyers are given the flexibility to create custom mappings and map to custom fields to meet those requirements.

The mapping tool offers various features and allows buyers to:

Create, edit, and delete custom mappings.
Deploy, un-deploy, and manage versions of the custom mappings.
Edit an existing version of the mapping and save it as a new version.
Enter a reason for editing a mapping configuration.
Deploy an older version of the mapping configuration.
Add functions to the custom mappings.
Test the newly created custom mappings.

Mapping Tool Node Functions

The table below shows the available node functions and their descriptions for the mapping tool.

No.	Node Function	Description
1	Add Constant Value	Constant values can be added to any destination field
2	Direct Mapping: One to One	Map a field from Source to Target
3	Add Source Condition	Conditions can be applied based on the position or value of the source element
4	Add Target Condition	Conditions can be based at the target side by looking over a source element
5	For Each	Iterate each element to create a target node using a source field
6	Group Multiple Condition	Multiple conditions can be grouped using OR, NOT, AND operations, for custom mappings
7	Duplicate Node	Multiple extension nodes can be created
8	Add Target Position Variable	Keeps variables at the target mapping for target’s occurrence position
9	Add Target ValueList Variable	Multiple extension or custom nodes in a mapping to a target matching a success condition of the ValueList variable
10	Choose-When	Map one or more source elements to one target element with a condition for each source element
11	Create/Replace Node	Allows to create new nodes. This node is to be done when the node is not created via standard mapping
12	Delete Node	Remove a standard or extension node that applies the mapping at a target mapping
13	Commit Function	Consolidate up to three source elements and map into a single field
14	IsNumeric Function	Remove additional symbols from a source field when it is not in the target list
15	Format Date Function	Set date pattern to be applied when writing the mapped date
16	Format Date Function	Set date pattern to be applied on the mapped number
17	Translation Function	Translate a value of the source field to a different value and map it to the target field

Summary

The key learning points of this lesson are:

The mapping tool in the managed gateway transforms SAP S/4HANA or ERP messages into SAP Business Network’s native cXML format. While the gateway provides standard SAP mappings for all document types, buyers can use the tool to create custom mappings to meet specific business needs.
The three types of mappings are:
- Standard mappings – delivered by SAP for all supported documents.
- Manual extension mappings – developed by SAP Implementation Services under special cases.
- Custom mappings – created by buyers using the self-service tool.
The Mapping Tool allows users to create, edit, test, and delete custom mappings, as well as deploy, un-deploy, and roll back to previous versions when needed. It supports adding functions, managing mapping versions with documented changes, and automatically migrating custom mappings during managed gateway upgrades.
This flexibility ensures buyers can adapt integration flows to their unique requirements while maintaining compatibility with SAP Business Network.

Next lesson