Step by Step Guide: XML File 2 XML File Scenario: Part I

[Former Member]

Whenever I use to start learning a new programming language I always use to search for a hello world program which can make me happy to see a output even though I did not did understand what’s going inside. Even my boss asks me many a times “Can you please show me, what this tool does?” Well, this kind of guides helps many new babies to understand a typical hello world program kind of stuff using XI. I am not going to copy and paste much theory that you can find in many of good articles in the sdn library. In turn, I am going to just elaborate more on the basic steps to implement this simple scenario (That’s what the heading say so?). Even I am doing as I write this blog. So, Let’s Start!
Scenario Suppose, you want to transfer a XML file (some user-defined XML format) from one system (Sender) to another system (Receiver) and also converting from one XML format to another XML format then you will use XI as an integration tool between the two systems.
Interface Diagram
Step by Step Solution
	Step 1: Login into XI
» Login into the SAP XI server using the logon pad.   » Type “sxmb_ifr” transaction code to launch the Integration Builder.   » Page will popup showing the first screen of the integration Builder which looks similar to this.
	Step 2: System Landscape Directory
» Click on the “System Landscape Directory” link.   » This will open up the first screen of the SLD (System Landscape Directory). Here we are going to define our Product, Software Component, Technical System and Business System. (What is Product, Software Component, Technical System and Business system?)
	Step 3: System Landscape Directory - Define a Product
» First step is to define a Product. For that, click on “Software Catalog” link.   » Click on “New Product” Button to create a Product. .   » Now define the Product as per the inputs and click on “Create” button.   » Can you see this message on your page when u clicked “Create” button. [Keep an eye on such kind of messages on top of the page]   » If yes then Great. Congratulations! You have created a Product successfully.
	Step 4: System Landscape Directory - Define a Software Component
	Next step is to create a Software Component. To make the life easier XI automatically takes u to the Software Component page and by default it will select the Product that you have created.
» Now define the Software Component as per the inputs and click on “Create” button.   » Fine! You are done with Product and Software Component. If you see this screen then lets go back to main SLD screen as we have created the product and software component successfully. To go back to the main SLD screen click on "Home" Link on the top of the page. .
	Step 5: System Landscape Directory - Define Technical System
	Now we need to define two Technical Systems (One for Sender and another for Receiver).
» Click on “Technical Landscape” from the SLD main page.   » When the page opens up select the “Third-Party” from the Technical System Type drop-down and press on the “New Technical System” button.   » A page will pop-up asking for details of creating a Technical System.   » Click on “Next>” button and then Fill all the values and then click on “Next>” again. .   » Your next screen will ask you where is your product? Just search in the box or select it from the list and when it is listed just double click it or select it and say “Add”. Points to be noted before pressing Finish: - Check that your Product is listed in the “Selected Products box” - In the Components is your Software Component is selected. It should be selected as per the figure shown below. Checklist done! Okay enough reading click on "Finish" now. Are you with me? – Just nod   » Can you see this: AND If Yes Great! We are on the same track then. Let’s move ahead.   » Now, I think you are intelligent enough to create one more Technical System. Just go back to the SLD Main Screen – This is can be done by clicking on “Home” link on the top.   » When you reach to the SLD main screen click on Technical System again to create the Receiver Technical System. Follow the steps as per used earlier in order to create the Sender Technical system.   » Don’t forget to select correct Product and Software Component from the list displayed.   » This is what I can see what about u? AND   Okay we have done with the Technical Systems and now we are going to create Business Systems. Go back to the SLD Home Page – Don’t ask me how now it’s shown in the top.
	Step 6: System Landscape Directory - Define Business System
» Click on the “Business Landscape” on the SLD Main Page.   » This will open up the Business Landscape page. Just click on “New Business System” button.   » Enter the Business system name and Press “Next>"   » Select and Press “Next>”   » Now select the Technical System for which you are creating the Business System.   » Fill the fields with these values and press “Next>”   » Don’t forget to check the product. Anyhow by default it is selected. Just check that it is like this.   » Select the Integration Server from the Drop down and Click on "Finish".   » Now Lets see what u have learned till now. Create one more Business System with different Logical System name (Leg002). All other steps are same.   » Can you see the two business system   Okay now move to SLD Home page again and check that the Technical Systems are correctly added to the Products or not.   » If you are at SLD Home Page then click at ”Software Catalog” and then search you Product.   » Click on the version and this will show the Software Component.   » To check the Technical system, click on “Installed Systems” this should show something like this.   » Can you see this? Yes Thank God! Okay fine we have done with the SLD (Products, Software Component, Technical System and Business System)   » Just close the SLD window and now come back to our main XI screen.
	Step 7: Integration Repository
» Click to open the “Integration Repository” if you are using the XI for the first time this will take some loading time.   » You will be shown an Integration Builder: Design Screen.   » First step is to import the Software Component which you have created in the “System Landscape Directory”   » Select you Software Component from the list shown and click on import button. Done importing - click on “Exit”   » Now you can see the Software Component on the Left hand side with no objects in it. Double click your Software Component, a page will open up in the right hand side. Can you see it? Now everything will be in Disable mode to make it in Enable mode click in Edit or Change Icon.   » Just enter the Namespace.   » If you are not able to see the Namespace it will in the minimize mode. Just click on “Namespace” and then click on Cap button. This will maximize the Namespace box.   » Press save icon .   » Can you see this on the left hand side?   » Now we are going to create Two Data Types.   » Right Click on Data types and click on “New”.   » Enter the details as per shown and press “Create” Button.   » Now start inserting the Fields that you are going to have in the input XML file.   » Create the Sender Data Type (dt_sender) which is some things like this.   » Now we need to create the Receiver Data Type (dt_receiver) as per shown below:   » Receiver Data type Fields:   » Now we need to create two Messages Types one for Sender and other for Receiver. In order to create anything new just right click on the object on the left side and select “New”.   » Select the Data Type (dt_sender) for the Message Type (mt_sender) by clicking the help button and then save it.   » Similar way, create the Receiver message type (mt_receiver) and then press save.   » It’s the time to create Interface now. Say “New” on the Message Interface on the left hand side   » Please make sure that you selected Outbound and Asynchronous and then select the Message Type (mt_sender) using the help button . Your screen should be like this before u save it.   » Now we need to create Receiver Interface. Say “New” and then fill the details as per shown.   » This time the Category isInbound and Mode is same Asynchronous and then select the Receiver Message Type - atlast save it.   » Where we are? - We have Created two Data Types (dt_sender and dt_receiver) - Then we have created two Message Types (mt_sender and mt_receiver) - Last we have made 2 Interface (mi_sender and mi_receiver) My Screen says this. What about urs? Same output! Let’s move ahead.   » Now its time to map the fields of Sender Message type and Receiver Message Type. This can be done by creating a Message Mapping Program. A "Graphical Mapping" which maps the field of Sender to Receiver.   » Here are the inputs for the Message Mapping Screen. Press “Create”   » You can drag and drop the Message Types in the corresponding boxes shown as Black. Drag mt_sender Message Type and drop it in the Black Box as shown   » Same way drag and drop the mt_receiver Message type on the Target Box.   » Now drag the elements say PO_NUM from mt_sender and drop it on the right hand side SONUM field. As you do you can see that Red Color fields turns into Green which means we are doing it right. Complete the mapping by dragging and dropping onto the right hand side fields and see that all the target fields are in Green color.   » In order to see the Mapping lines what you have done Graphically select the Option as displayed below. Right Click on the field and then select “Dependencies” and select “Show All”   » Nice functionality Right! This is what called as Graphical Mapping. Save it   » Okay we have done with the Mapping program between the messages but we need to create mapping between the Interfaces even. So, Select the Interface Mapping and say “New”. Fill the details and Press “Create”.   » Now this is tricky. Here you can drag and drop the Interfaces on the white text boxes or you can use the help button to select the interface.   » Once this is done click on Read Interface button below . This will add the interface in the below box and then u can select the message mapping program for these interface.   » Okay now we are about to close this Integration Repository. Just select the Message Mapping Program using the help button. What was the mapping program? – (mt_.....). Don’t worry as I told XI has made life of us easier it will show only one message mapping program just select it. 🙂   » Good! This is what I Can see now? Okay then save the work.   » Now its testing time before saying yes we have done everything correct in the Designing Part. Click on the “Test” tab in the same Interface Mapping Screen.   » Enter the values and press "Execute" button on the same screen   » Does it works? If Yes wow! This is what I can see? and The message box says: Messages:16:12:37 Start of test Executed successfully 16:12:42 End of test   » Here is the list from my XI Tool. Now its time to activate. This is something like results time after you write the exam but here best thing is you can see the errors but in real exam result we can feel the beatings? 😉   » To activate click on the "Change List" tab   » Expand your Component and Do it by yourself!   » Change the name of the Activate List and then press the "Activate" button in the bottom.   » Hurray ! My first design is Successful.
Sorry for making this blog so big, my intension was to make this a reference guide for all the new Babies. I was not aware of the limitation of the Blog. Anyways, click here for the Continuation of this blog: Step by Step Guide: XML File 2 XML File Scenario: Part II