Creating a graphical data map in the Eclipse editor

Create a graphical data map in the Eclipse editor to transform data graphically.

If you plan to reuse the graphical data map in other products, read Guidelines for developing reusable graphical data mapping assets.

To create a graphical data map in the Eclipse editor, complete the following steps:

  1. Create a new graphical data map, by selecting File > New > Other > XML > Data map. Click Next.

    The New XML Mapping wizard opens.

  2. Select the parent folder for the new graphical data map and specify a file name. By default the new file is called NewMAP.map. Click Next.

    The Input and Output Roots pane is displayed.

  3. Select the input and output root files by clicking Add and then browsing to the required schema files.
    Note: If you choose not to select the input and output schemas at this point, you can select Next, and the Graphical Data Mapping editor is displayed with no input or output objects. You can then select your input and output objects in the Graphical Data Mapping editor by using the Add an input object and Add an output object icons.

    In the Graphical Data Mapping editor, Map variables are not supported when the target engine selected is XQuery.

    When the target engine is XSLT, Map variables are implicit inputs to nested maps. You do not need to define an explicit source connection to any nested map. The Map variables are available as inputs in your nested map.

    When you have specified your input and output objects, they are shown in the Graphical Data Mapping editor with the input object on the left side of the canvas, and the output object on the right side:

    Graphical Data Mapping editor

  4. Select a Target engine.
    • You can choose XSLT version 1.0 or XSLT version 2.0 as the target engine for a submap that is to be used outside of IBM® Integration Bus.
    • You can choose XQuery version 1.0 as a target engine for a submap that is used in IBM Integration Bus.
  5. Click Next.
  6. Optional: Add data sample input files. If you want to specify the sample file at this stage, click Add and then select the name of the required input file from the displayed list.

    Data Sample input files are files that include input test data. You can use these files to test locally the map.

  7. Click Finish.

Edit the graphical data map, and define transformations between the input message and the output message. For more information, see Editing graphical data maps.

Copyright IBM Corporation 2013Copyright IBM Corporation 2012.

Task topicTask topic | Version 1.0 | cm28803_