SAP Exchange Infrastructure - Graphical Mapping

Transcription

1 SAP Exchange Infrastructure - Graphical Mapping Joachim Orb SAP AG Thomas Volmering SAP AG Learning Objectives As a result of this workshop, you will be able to: Handle the graphical mapping editor Use predefined standard functions Enhance your mappings with user-defined functions Test your mappings SAP AG, TechEd EMEA, BPI252 Graphical Mapping, Thomas & Joachim / 2

2 Agenda Concepts Handling Standard Functions Node Functions User-defined Functions Summary SAP AG, TechEd EMEA, BPI252 Graphical Mapping, Thomas & Joachim / 3 Agenda Concepts Handling Standard Functions Node Functions User-defined Functions Summary SAP AG, TechEd EMEA, BPI252 Graphical Mapping, Thomas & Joachim / 4

3 Concepts - General Mapping Types Mapping Transformation from one message structure to another Transformation of one key value to another <hh:book-flight xmlns:hh="..."> <hh:customer> <hh:first-name>micheal</hh:first-name> <hh:surname>moore</hh:surname> </hh:customer> <hh:booking-data> <hh:airline>airline Kingdom</hh:airline> <hh:connection>ak087</hh:connection> <hh:date> </hh:date> <hh:class>business</hh:class> </hh:booking-data> </hh:book-flight> Value Mapping Structure Mapping <ak:bookflight xmlns:ak="..."> <ak:date> </ak:date> <ak:flight>087</ak:flight> <ak:passenger>micheal Moore</ak:Passenger> <ak:class>2</ak:class> <ak:agency>happy Holiday</ak:Agency> </ak:bookflight> SAP AG, TechEd EMEA, BPI252 Graphical Mapping, Thomas & Joachim / 5 Concepts Mapping at Runtime Integration Server (IS) Message Message Header: Logical Sender Payload: Sender Document Business System Determination Receiver Interface Determination 1 2 Logical Routing Technical Routing Mapping Message Message Header: Receiver Address Payload: Receiver Document Messages in XI contain a sender interface IS evaluates configuration data of the Integration Directory During logical routing, the IS determines a receiver interface (1) Such an interface pair can optionally reference an interface mapping An interface mapping points to one or more mapping programs (for request, response and/or fault messages) IS executes mapping program on J2EE server (2) SAP AG, TechEd EMEA, BPI252 Graphical Mapping, Thomas & Joachim / 6

4 Concepts - Relate Mapping Programs to Interfaces Outbound Message Interface Integration Repository Interface Mapping(s) Inbound Message Interface Request Response Fault Request Message Type Response Message Type Fault Message Type Message Mapping XSLT Mapping Java Mapping Message Mapping XSLT Mapping Java Mapping Message Mapping XSLT Mapping Java Mapping Request Message Type Response Message Type Fault Message Type SAP AG, TechEd EMEA, BPI252 Graphical Mapping, Thomas & Joachim / 7 Concepts - Mapping in SAP XI Message Mapping Designed by using the graphical mapping editor of Integration Builder Result: Generated Java Code. Imported Archives Import externally defined mapping programs into repository Java mapping: Implemented by using a specific interface XSLT mapping: Runtime supports XSLT processor Java methods can be called from within a Style Sheet You can execute mapping programs in a sequence (Only for a request or a response message) SAP AG, TechEd EMEA, BPI252 Graphical Mapping, Thomas & Joachim / 8

5 Concepts Message Mapping Functions Standard Functions E.g. string processing, number/date formatting, boolean, Value Mapping Node functions User-defined functions Java method SAP AG, TechEd EMEA, BPI252 Graphical Mapping, Thomas & Joachim / 9 Agenda Concepts Handling Standard Functions Node Functions User-defined Functions Summary SAP AG, TechEd EMEA, BPI252 Graphical Mapping, Thomas & Joachim / 10

6 Handling SAP AG, TechEd EMEA, BPI252 Graphical Mapping, Thomas & Joachim / 11 Handling Mapping Editor Structure Overview Source Source Structure Structure Target Target Structure Structure Data-Flow Editor Target Field Mapping SAP AG, TechEd EMEA, BPI252 Graphical Mapping, Thomas & Joachim / 12

7 Handling Elements Attribute Element is mandatory and might re-occur (minoccurs>0, maxoccurs>1) Element is mandatory (minoccurs>0) Parent node might repeat (maxoccurs>1) Element might repeat (maxoccurs>1) SAP AG, TechEd EMEA, BPI252 Graphical Mapping, Thomas & Joachim / 13 Handling- Assignment of Fields Double click on an any field = insert field into data-flow editor Double click on a white field = insert field into data-flow editor Double click on a green/yellow field = navigate to target field mapping drag&drop drag&drop drag&drop SAP AG, TechEd EMEA, BPI252 Graphical Mapping, Thomas & Joachim / 14

8 Handling- Text Preview Text Preview All target field mappings SAP AG, TechEd EMEA, BPI252 Graphical Mapping, Thomas & Joachim / 15 Agenda Concepts Handling Standard Functions Node Functions User-defined Functions Summary SAP AG, TechEd EMEA, BPI252 Graphical Mapping, Thomas & Joachim / 16

9 Standard Functions: Introduction X 1 X 2 R = f(x 1,X 2 ) R I O = f(i) O X 1 X 2 X 3 R = f(x 1,X 2,X 3 ) R O = Generated Value O All functions expect and return string values String value is cast to needed type according to standard function Generating functions produce values (for example: Constant) Some standard functions provide function properties For example: concat let s you additionally specify a delimiter Call the function properties window by double clicking the function SAP AG, TechEd EMEA, BPI252 Graphical Mapping, Thomas & Joachim / 17 Simple Standard Functions: concat Function category: Text Source Message <Customer> <firstname> Harry </firstname> <surname> Potter </surname> </Customer> Mapping concat properties Delimiter= Target Message <Contact> <name> Harry Potter </name> </Contact> SAP AG, TechEd EMEA, BPI252 Graphical Mapping, Thomas & Joachim / 18

10 Simple Standard Functions: substring Function category: Text Source Message <Customer> <customerid> </customerid> </Customer> Mapping substring properties start from: 0 count: 10 Target Message <Contact> <customerno> </customerno> </Contact> Position count for all text functions start at 0! SAP AG, TechEd EMEA, BPI252 Graphical Mapping, Thomas & Joachim / 19 Simple Standard Functions: DateTrans Function category: Date Source Message <Customer> <custbirthday> </custbirthday> </Customer> Mapping DateTrans properties src Format: ddmmyy dst Format: MM/dd/yyyy Target Message <Contact> <birthday> 11/18/1970 </birthday> </Contact> uses standard Java date template SAP AG, TechEd EMEA, BPI252 Graphical Mapping, Thomas & Joachim / 20

11 Demo Demo SAP AG, TechEd EMEA, BPI252 Graphical Mapping, Thomas & Joachim / 21 Agenda Concepts Handling Standard Functions Node Functions User-defined Functions Summary SAP AG, TechEd EMEA, BPI252 Graphical Mapping, Thomas & Joachim / 22

12 Node Functions Contexts Context Change Message mapping works internally by using queues If no further elements are imported at a particular hierarchy level, a Context Change is inserted in the queue Use node functions to handle changes in the message hierarchy. removecontexts deletes all context changes of a queue SplitByValue insert additional context changes in a queue SAP AG, TechEd EMEA, BPI252 Graphical Mapping, Thomas & Joachim / 23 Node Functions removecontexts (I) With removecontexts Source Message <Test_Out_Remove> <header name= A"> <item>a.one</item> <item>a.two</item> <item>a.three</item> </header> <header name="b"> <item>b.one</item> <item>b.two</item> </header> </Test_Out_Remove> Mapping Target Message <Test_In_Remove> <item>a.one</item> <item>a.two</item> <item>a.three</item> <item>b.one</item> <item>b.two</item> </Test_In_Remove use removecontext() to delete the parent context of an element. SAP AG, TechEd EMEA, BPI252 Graphical Mapping, Thomas & Joachim / 24

13 Node Functions removecontexts (II) Without removecontexts Source Message <Test_Out_Remove> <header name= A"> <item>a.one</item> <item>a.two</item> <item>a.three</item> </header> <header name="b"> <item>b.one</item> <item>b.two</item> </header> </Test_Out_Remove> Mapping Target Message <Test_In_Remove> <item>a.one</item> <item>a.two</item> <item>a.three</item> </Test_In_Remove> SAP AG, TechEd EMEA, BPI252 Graphical Mapping, Thomas & Joachim / 25 Demo Demo SAP AG, TechEd EMEA, BPI252 Graphical Mapping, Thomas & Joachim / 26

14 Agenda Concepts Handling Standard Functions Node Functions User-defined Functions Summary SAP AG, TechEd EMEA, BPI252 Graphical Mapping, Thomas & Joachim / 27 User-Defined Functions Overview Functional enhancements if standard functions do not fulfill requirements Integration of Java programs from imported archives Usage just like standard functions SAP AG, TechEd EMEA, BPI252 Graphical Mapping, Thomas & Joachim / 28

15 User-Defined Functions Editor Simple editor functions Usage of imported Java programs Single return value is of type java.lang.string SAP AG, TechEd EMEA, BPI252 Graphical Mapping, Thomas & Joachim / 29 Agenda Concepts Handling Standard Functions Node Functions User-defined Functions Summary SAP AG, TechEd EMEA, BPI252 Graphical Mapping, Thomas & Joachim / 30

16 Summary Introduction to the graphical mapping tool Mapping techniques in XI : Message Mapping Java Mapping XSLT Mapping Message Mapping Standard Functions Node Functions User-defined Functions Test Mode SAP AG, TechEd EMEA, BPI252 Graphical Mapping, Thomas & Joachim / 31 Further Information Public Web: SAP Customer Services Network: Consulting Contact Roy Wood, VP SAP NetWeaver Consulting Practice (r.wood@sap.com) Related SAP Education Training Opportunities TZXIDC, Early Product Training Development & Configuration SAP XI 2.0 Related Workshops/Lectures at SAP TechEd 2003 SAP Exchange Infrastructure - Integrating SAP applications, Date/Time, Room, Hands-on (4h) SAP Exchange Infrastructure - Utilize SAP Adapters to Connect to Heterogeneous Systems, Date/Time, Room, Hands-on (4h) SAP AG, TechEd EMEA, BPI252 Graphical Mapping, Thomas & Joachim / 32

17 Questions? Q&A SAP AG, TechEd EMEA, BPI252 Graphical Mapping, Thomas & Joachim / 33 Feedback Please complete your session evaluation and drop it in the box on your way out. Thank You! The SAP TechEd 03 Basel Team SAP AG, TechEd EMEA, BPI252 Graphical Mapping, Thomas & Joachim / 34

18 Copyright 2002 SAP AG. All Rights Reserved No part of this publication may be reproduced or transmitted in any form or for any purpose without the express permission of SAP AG. The information contained herein may be changed without prior notice. Some software products marketed by SAP AG and its distributors contain proprietary software components of other software vendors. Microsoft, WINDOWS, NT, EXCEL, Word, PowerPoint and SQL Server are registered trademarks of Microsoft Corporation. IBM, DB2, DB2 Universal Database, OS/2, Parallel Sysplex, MVS/ESA, AIX, S/390, AS/400, OS/390, OS/400, iseries, pseries, xseries, zseries, z/os, AFP, Intelligent Miner, WebSphere, Netfinity, Tivoli, Informix and Informix Dynamic ServerTM are trademarks of IBM Corporation in USA and/or other countries. ORACLE is a registered trademark of ORACLE Corporation. UNIX, X/Open, OSF/1, and Motif are registered trademarks of the Open Group. Citrix, the Citrix logo, ICA, Program Neighborhood, MetaFrame, WinFrame, VideoFrame, MultiWin and other Citrix product names referenced herein are trademarks of Citrix Systems, Inc. HTML, DHTML, XML, XHTML are trademarks or registered trademarks of W3C, World Wide Web Consortium, Massachusetts Institute of Technology. JAVA is a registered trademark of Sun Microsystems, Inc. JAVASCRIPT is a registered trademark of Sun Microsystems, Inc., used under license for technology invented and implemented by Netscape. MarketSet and Enterprise Buyer are jointly owned trademarks of SAP AG and Commerce One. SAP, SAP Logo, R/2, R/3, mysap, mysap.com and other SAP products and services mentioned herein as well as their respective logos are trademarks or registered trademarks of SAP AG in Germany and in several other countries all over the world. All other product and service names mentioned are trademarks of their respective companies. SAP AG, TechEd EMEA, BPI252 Graphical Mapping, Thomas & Joachim / 35 Copyright 2002 SAP AG. Alle Rechte vorbehalten Weitergabe und Vervielfältigung dieser Publikation oder von Teilen daraus sind, zu welchem Zweck und in welcher Form auch immer, ohne die ausdrückliche schriftliche Genehmigung durch SAP AG nicht gestattet. In dieser Publikation enthaltene Informationen können ohne vorherige Ankündigung geändert werden. Die von SAP AG oder deren Vertriebsfirmen angebotenen Softwareprodukte können Softwarekomponenten auch anderer Softwarehersteller enthalten. Microsoft, WINDOWS, NT, EXCEL, Word, PowerPoint und SQL Server sind eingetragene Marken der Microsoft Corporation. IBM, DB2, DB2 Universal Database, OS/2, Parallel Sysplex, MVS/ESA, AIX, S/390, AS/400, OS/390, OS/400, iseries, pseries, xseries, zseries, z/os, AFP, Intelligent Miner, WebSphere, Netfinity, Tivoli, Informix und Informix Dynamic ServerTM sind Marken der IBM Corporation in den USA und/oder anderen Ländern. ORACLE ist eine eingetragene Marke der ORACLE Corporation. UNIX, X/Open, OSF/1 und Motif sind eingetragene Marken der Open Group. Citrix, das Citrix-Logo, ICA, Program Neighborhood, MetaFrame, WinFrame, VideoFrame, MultiWin und andere hier erwähnte Namen von Citrix-Produkten sind Marken von Citrix Systems, Inc. HTML, DHTML, XML, XHTML sind Marken oder eingetragene Marken des W3C, World Wide Web Consortium, Massachusetts Institute of Technology. JAVA ist eine eingetragene Marke der Sun Microsystems, Inc. JAVASCRIPT ist eine eingetragene Marke der Sun Microsystems, Inc., verwendet unter der Lizenz der von Netscape entwickelten und implementierten Technologie. MarketSet und Enterprise Buyer sind gemeinsame Marken von SAP AG und Commerce One. SAP, SAP Logo, R/2, R/3, mysap, mysap.com und weitere im Text erwähnte SAP-Produkte und -Dienst-leistungen sowie die entsprechenden Logos sind Marken oder eingetragene Marken der SAP AG in Deutschland und anderen Ländern weltweit. Alle anderen Namen von Produkten und Dienstleistungen sind Marken der jeweiligen Firmen. SAP AG, TechEd EMEA, BPI252 Graphical Mapping, Thomas & Joachim / 36