Mapping an XML message

To map an XML message, take the following steps:

Procedure

  1. Open the mapping.mdmxmi file with the Hub Service Mapping editor.
  2. Click the Model tab to switch to the Model editing page.
  3. Click Add.

    The Map XML Message wizard is shown.

  4. Select the XSD element which defines the request message format from the XSD files that you imported into the project.
  5. Click Next.
  6. Select the XSD element which defines the response message format from the XSD files that you imported into the project. If there are multiple possible response elements for the same request, select one – additional responses can be defined separately.
  7. Click Next.
  8. Select the Hub server transaction that you want to map the request to. This selection is used only to generate skeleton mapping implementation files. If you wish to change the mapping later or if you need to map to different target transactions depending on the message content, then you should do so by editing the mapping implementation.

    You can type a string into the text field to search for particular transactions by name.

  9. Click Next.
  10. Select the implementation type.
    You can choose between implementing the mappings directly in XSLT or using the graphical data mapping tool. If you change your mind later, this can be set for each mapping individually in the properties for that mapping.
  11. Choose whether to immediately generate skeleton implementation files. You may wish to defer doing so if you are mapping several messages.
  12. Click Finish.
    If you selected the option to generate implementation files, code generation is run immediately.
  13. Expand the XML message in the tree view and select the Request mapping.
  14. Click on the Implementation file link to open the mapping implementation file for editing.
  15. Depending on the implementation type, either an XSLT file or a graphical data map (.map) file is opened for editing. You must implement the mapping by editing the file with your preferred tools.
  16. Repeat steps 10 to 12 for the response mapping.