Editing message maps

You edit a message map in the Graphical Data Mapping editor.

Before you begin

Create a message map using the Graphical Data Mapping editor. For information about how to do this, see Creating a message map.

About this task

In the Graphical Data Mapping editor, you create a map, you define the input and output message models to the map, and the transformations that must be applied to create the output message with values from the input elements. When your input or output message model includes an xsd:any element, you must qualify this extension point by using the Cast function or the Add user defined function prior to defining transforms.

You use the Graphical Data Mapping editor to map (or connect) elements of input objects to elements of output objects. Then, for each mapping, you can create a transform, which performs an action on the data of the input element and puts the result in the output element. The input objects are on the left side in the Graphical Data Mapping editor, and the output objects are on the right.

You can define XPath conditional expressions on a transform. This expression determines whether the transform is applied. Use content assist to set the required parameters of the expression. For more information, see Using content assist (Mapping syntax).

Procedure

You can do any of the following editing tasks in the Graphical Data Mapping editor:

  1. Optional: Configure the general properties of a message map to define the Java™, ESQL, and XSD resources that the map can refer to; to define your solution XML namespaces, and and to add any documentation. For more information, see Configuring the general properties of a message map.
  2. Redefine xsd:any elements in your message.
    1. Use the Cast function to redefine parts of the input or output model in a graphical data map by using a schema model. For more information, see Mapping xsd:any on an input or output message. For more information, see Mapping xsd:any on an input or output message.
    2. Use the Add user defined function to define dynamically the input and output message models when you do not have a schema model available for any of them. For more information, see Defining user-defined elements.
  3. Map the input and output elements in any of the following ways:
    1. Map elements manually. For more information, see Mapping input to output elements manually.

      Use this method to select the input and output elements, create connections between them, and specify the required transforms.

    2. Map elements automatically. For more information, see Mapping input to output elements automatically.

      Use the Auto map wizard (automap) to map elements by examining the names of input and output elements to create the mappings.

  4. Specify a transform, also known as a mapping operation. For more information, see Specifying a transform (mapping operation).
  5. Configure the properties of a transform. For more information, see Configuring the properties of a transform.
  6. Delete objects and transforms. For more information, see Deleting objects and transforms.

What to do next

Configure the input and output message assembly in a message map by using the Graphical Data Mapping editor. For more information, see Advanced editing in a message map.