Creating a graphical data map in the Eclipse editor

Create a graphical data map in the Eclipse editor to transform data graphically so that you can reuse it in other products that support graphical data maps.

Before you begin

Before you create a reusable message map, you must complete the following tasks:
  1. Create an application, a library, an integration service, or an Integration project, as described in the following topics:
  2. Create a message flow. For more information, see Creating a message flow.
  3. Define the message flow content that includes a Mapping node. For more information, see Defining message flow content.

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

About this task

In IBM® Integration Bus, you can create a graphical data map as a reusable message map. You handle a graphical data map as a submap.


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 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.

    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:

  4. Click Next.
  5. Click Finish.

What to do next

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