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
When you want to modify only some fields of a message assembly component, complete the following steps to transform the message assembly component:
- 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
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.
- 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.
The Assign transform is defined and connected to the Encoding element in the output Properties tree.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
- A suggestion icon represented by a yellow light bulb.
When you hover over the icon, you get the following pop-up window:
- 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.
- 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.
You have transformed elements of a message assembly component by using the Override function.
The local map that is created contains a Move transform per element, with the exception of the Encoding element that has an Assign transform.