Download as pdf or txt
Download as pdf or txt
You are on page 1of 58

Mapping Tool

Cloud Integration Gateway


Simple | Self Service | Speed

PUBLIC
Agenda

▪ Overview
▪ Mapping Tool Features
▪ Mapping Test Tool
▪ Node functions
▪ Supported CIG Addon Versions
▪ Use Cases
✓ Map extrinsic at header level
✓ Map extrinsic at item level
✓ Map a new optional element/ Concatenate/ Sub-string
✓ Delete a mapped element
✓ Format Number
✓ Normalize
✓ Format Date
✓ Map a Child Value form source structure to a Parent field in target structure
✓ Choose When
✓ Map text node to item level extrinsic
✓ Create/ Replace node
✓ Explicit For Each
▪ Limitations

© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 2


Overview

The mapping tool is introduced to enable more self service in CIG and to cope up with huge demand
of custom mappings. Using this feature the buyer can do the following

▪ Buyer can edit and create their own mapping customizations


▪ Buyer can deploy, un-deploy and manage version of their own mappings
▪ Mapping test tool is provided. Using this feature, buyer can test the custom mappings which they have done
▪ Using mapping test tool, the buyer can see the difference between standard and custom mappings

© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 3


Mapping Tool Features…Continued
▪ Buyer can see a new option in My Configuration page of CIG called Mappings

▪ Buyer will see different document types (transactions) like below

▪ Buyer can add a new custom mapping by choosing the Add button. Once buyer clicks add button,
buyer will be taken to the next screen where System ID need to be entered. Buyer can choose
multiple system IDs associated with the CIG project

© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 4


Mapping Tool Features…Continued
▪ Once the system ID is chosen, buyer can see the standard mappings delivered in a grey line like
below

▪ Buyer will not be able to edit the standard mappings.

© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 5


Mapping Tool Features…Continued
▪ Once the mappings are done, buyer can save the mapping and deploy the same to Test and
Production

© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 6


Mapping Test Tool
▪ Once the mappings are done, buyer can test the mappings using the mapping test tool

▪ Place the Source Payload / browse the Source Payload, Choose the System ID and click test.

© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 7


Node Functions

© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 8


Supported CIG Addon Versions

Mapping tool is supported from following CIG ADDON versions only but that may vary
based on the support policy

ADDONINFO 1 - ARBCI10003
ADDONINFO 2 - ARBCI20003

© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 9


Use Cases
Map Extrinsic at Header Level:

Map SAP Purchase Order document type to OrderRequest cXML extrinsic

© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 10


Map Extrinsic at Header Level

© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 11


Map Extrinsic at Header Level

© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 12


Map Extrinsic at Header Level

© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 13


Map Extrinsic at Header Level

© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 14


Map Extrinsic at Header Level

© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 15


Map Extrinsic at Item Level

© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 16


Map Extrinsic at Item Level

© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 17


Map Extrinsic at Item Level

© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 18


Map Extrinsic at Item Level

© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 19


Map Extrinsic at Item Level

© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 20


Map Extrinsic at Item Level

© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 21


Map Extrinsic at Item Level

© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 22


Map Extrinsic at Item Level

© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 23


Map a new Optional Element/ Concatenate/ Sub-String

Use Case:
▪ Map a new optional element tracking number in Ariba Network Purchase Order
▪ Concatenate - Use to concatenate a maximum of 3 fields from source to target
structure
▪ Sub-string - Buyer can extract specific character from a string

Note: This is self-explanatory. Direct one to one mapping

© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 24


Delete a mapped element

© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 25


Delete a mapped element

© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 26


Delete a mapped element

© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 27


Format Number

© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 28


Format Number

© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 29


Normalize function
Removes white spaces from the field value

© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 30


Normalize function

© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 31


Format Date
Date format can be done in below formats.
If source has a date format like 2019-01-27 and if we need to change the date format to
20190127, then add date format function like [Y0001][M01][D01]

© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 32


Format Date

© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 33


Map a Child value from source structure to a Parent field in target structure

© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 34


Map a Child value from source structure to a Parent field in target structure

© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 35


Map a Child value from source structure to a Parent field in target structure

© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 36


Map a Child value from source structure to a Parent field in target structure

© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 37


Map a Child value from source structure to a Parent field in target structure

© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 38


Map a Child value from source structure to a Parent field in target structure

© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 39


Map a Child value from source structure to a Parent field in target structure

© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 40


Map a Child value from source structure to a Parent field in target structure

© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 41


Choose When
This acts like a if and else function. For example, if ExternalLineNumber exists, map it to target else
map ERPLineItemNumber

© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 42


Choose When
Choose the operator as not empty. If the field is not empty, map the field to target

Choose the second field ERPLineItemNumber and map it to same target field

© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 43


Choose When

© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 44


Map Text node to item level Extrinsic

© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 45


Map Text node to item level Extrinsic

© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 46


Map Text node to item level Extrinsic

© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 47


Map Text node to item level Extrinsic

© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 48


Map Text node to item level Extrinsic

© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 49


Map Text node to item level Extrinsic

© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 50


Map Text node to item level Extrinsic

© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 51


Explicit For Each
If we want to map a custom string from a P2P SOAP message to PO_EXTENSIONIN value in the
target schema

© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 52


Explicit For Each
In this example, we are trying to map the line item details to PO_EXTENSIONIN structure

Choose the source looping structure

© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 53


Explicit For Each
Select the custom string and add a source condition. Here we want to map the INCO1 field value
from source structure to VALUEPART1. Add the source condition as INCO1 from name attribute

© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 54


Explicit For Each
Map the ItemOnReq from source structure to VALUEPART2 field of target structure

© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 55


Explicit For Each
Click Create/Replace Node on the PO_EXTENSIONIN structure. We need to choose
Create/Replace Node function if the structure is not created via standard mapping

© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 56


Explicit For Each
Test the mapping: PO_EXTENSIONIN is not available in the standard mapping but it is now
available in the custom mapping

© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 57


Limitations

© 2018 SAP SE or an SAP affiliate company. All rights reserved. ǀ PUBLIC 58

You might also like