6/10/2015

New functions in the Graphical Mapping Tool XI ... | SCN

Getting Started Newsletters

Hi, Guest

Log On

Store

Search the Community

Join Us

Products

Services & Support

About SCN

Downloads

Industries

Training & Education

Partnership

Developer Center

Lines of Business

University Alliances

Events & Webinars

Innovation

Activity

Communications

Actions

Brow se

stefan.grube

New functions in the Graphical Mapping Tool XI 3.0

SP13
Posted by Stefan Grube in stefan.grube on Dec 29, 2005 1:27:56 AM
Share

Tw eet

0 Like

Before you read this article, I recommend first to go through Sravya Talanki's Weblogs Message Mapping Simplified
Part I and Message Mapping Simplified Part II
The graphical mapping provides some useful functions with starting with XI 3.0 SP13:
- The node functions mapWithDefault, formatByExample, sort and sortByKey
- The statistic function index

The function mapWithDefault

This function provides a default value, whenever the source element is not available. This is useful function, when you
want to use the content conversion of the file adapter. Look at this example:

Before SP13 we had to use a combination of the functions exists and if, now we need only one function:

The function formatByExample

This function allows grouping of values of a tag according to values of another tag. Look at this example:

http://scn.sap.com/people/stefan.grube/blog/2005/12/29/new-functions-in-the-graphical-mapping-tool-xi-30-sp13

1/4

6/10/2015

New functions in the Graphical Mapping Tool XI ... | SCN

We can achieve this with our new function:

The other nodes are mapped with help of the node functions splitByValue and collapseContexts like follows:

Make sure, that the context of the node ID is set to ORDERLIST in all cases.

The functions sort and sortByKey

Of course these functions are used to sort elements. Let us look at this example:

The elements in tag PRODUCT shall be sorted the same way as the elements in tag ID. As the functions sort and
sortByKey only sort the elements within the same context, we have to use the function removeContexts before sort.
After sort we have to restore the original contexts. We do this with the node function splitByValue The mapping now
looks like follows:

http://scn.sap.com/people/stefan.grube/blog/2005/12/29/new-functions-in-the-graphical-mapping-tool-xi-30-sp13

2/4

6/10/2015

New functions in the Graphical Mapping Tool XI ... | SCN

The function index

This function works like the function counter. The difference is that the function index repeats counting for each
context. Let us look at an example:

We want the tag No to count the positions in an order. For this reason we have to provide the correct contexts. This
can be done by the node function splitByValue. After creating of the correct index numbers, the values have to be
separated to different contexts. This can be achieved as well with the node function splitByValue.

I hope this blog will help you to understand the use of the new mapping functions.

10496 View s

Average Us er Rating

My Rating:

(7 ratings )

Share

Tw eet

0 Like

6 Comments
Dec 29, 2005 10:21 AM

Hi Stefan,
Good examples illustrating the new functions. The examples are very nice and very easy to follow.
Regards,
naveen
Like (0)

Michal Kraw czyk Dec 30, 2005 2:23 AM

Hi Stefan :)
Great to see a weblog from you,
hope there will be more :)
Regards,
michal
Like (0)

http://scn.sap.com/people/stefan.grube/blog/2005/12/29/new-functions-in-the-graphical-mapping-tool-xi-30-sp13

3/4

6/10/2015

New functions in the Graphical Mapping Tool XI ... | SCN

Ashok Pathmanathan May 17, 2007 6:42 AM

Hi Stefan,
Your blog with clear examples solved my query in the XI forum - ' Help in mapping with 'createIf' node
function'.
Thanks,
Ashok.
Like (0)

Aaron Myers Apr 8, 2009 11:44 AM

I was reading in SDN library and other sources to try and figure out SplitByValue and could never
make them work. Your method of removing, adding, and then collapsing context are exactly what I
needed to go from simple flat input file to a nested hierarchy.
Best regards,
Aaron
Like (0)

Roberto Villadarez Jun 17, 2009 9:44 PM

Great examples.
Just one comment for formatByExample.
You have to do sorting functionalities first before formatByExample function for data source that are
not in order.
Thanks and Regards,
Robert
Like (2)

Anupam Ghosh Sep 30, 2013 1:34 PM

Hi Stefan,
This is very helpful blog.
Thank you for sharing.
Regards
Anupam
Like (0)

Site Index
Privacy

Contact Us
Terms of Use

SAP Help Portal

Legal Disclosure

Copyright

http://scn.sap.com/people/stefan.grube/blog/2005/12/29/new-functions-in-the-graphical-mapping-tool-xi-30-sp13

Follow SCN

4/4