Transforming some elements of a message assembly component by using the Override function

You can use the Move transform to copy a complex type from the input message to the output message, while updating some of the child elements in the complex type by using the Override function. A message assembly component is described by a complex data structure.

About this task

Note: You can only use the Override function to include Move transforms and Assign transforms.

Procedure

When you want to modify only some fields of a message assembly component, complete the following steps to transform the message assembly component:

  1. Required: Define a Move transform to copy the input message component into the output message component, that is, to copy an input complex data structure into an output complex data structure.

    For example, the Properties tree has a Move transform defined automatically when you create a message map so that all elements in the Properties tree are copied to the output Properties tree structure. If you transform elements in the Local Environment tree, you must manually define the Move transform.

    This figure shows graphically the result of adding a Move transform between the input LocalEnvironment tree and the output LocalEnvironment tree.

  2. Add additional transforms between the input and output elements in the message assembly component.

    For example, you need to change the encoding for the output message. You assign a different value to the Encoding element in the properties tree. Right-click the Encoding element, and then select the menu option Create Assign.

    This figure shows the menu options that you get when you right-click an element. the Create Assign option is selected.

    The Assign transform is defined and connected to the Encoding element in the output Properties tree.

    This figure shows graphically the Assign transform connected to the output encoding element.

    You get the following icons on the top left hand side of the transform:
    • An Error icon represented with a red exclamation mark. You can ignore this error and continue. You get the error because you have defined two transformations on an element and this is not allowed. By using the Override function, you fix the problem.

      This figure displays the error message: Encoding is mapped by a Move mapping on parent element Properties as well as a assign map directly on element encoding.

    • A suggestion icon represented by a yellow light bulb.

      When you hover over the icon, you get the following pop-up window:

      This figure shows the pop-up window that opens when you hover the light bulb icon.

  3. When you hover over the yellow light bulb, choose Group the conflicting transforms in an override group. This option is the recommended approach and allows you to maintain visibility of the transforms you have defined in the main transformation map.

    This figure shows the Override transform containing the parent component Move transform and the Encoding element Assign transform.

Results

You have transformed elements of a message assembly component by using the Override function.

Note: If you choose Nest transforms within the parent map, a Local map transform is defined between the input Properties tree and the output Properties tree.

This figure shows the Local map transform that is defined when you choose Nest transforms within the parent map.

The local map that is created contains a Move transform per element, with the exception of the Encoding element that has an Assign transform.

This images shows graphically Move transforms for each element except Encoding that has an Assign transform.

What to do next

Configure the message map body parts. For more information, see Mapping input to output elements manually or Mapping input to output elements automatically.