Mapping a target element from source message elements

You can map:
  • simple source elements to simple target elements
  • source structures to target structures (where the source and target are of the same type)
  • Start of changesource structures to target structures (where the source and target are of a different type)End of change
  • multiple simple source elements to a simple target element
The following sections describe how to perform mapping for these particular scenarios using the Message Mapping editor.

Mapping simple source elements to simple target elements

In the following example, the source element called Name does not contain the same children as the target element called Name:
Source Target
Name
	Title
	First_name
	Middle_name
	Last_name
Name
	Title
	First_names
	Last_name
To map one of the child elements, drag the element from the Source pane onto the corresponding element in the Target pane; for example, drag the Last_name source element onto the Last_name target element.

The mapping is represented by a line between the source element and the target element and an entry for the mapping in Xpath format appears in the Spreadsheet pane. A triangular icon indicates which elements in the Source and Target panes have been mapped.

Start of changeMapping source structures to target structures (where the source and target are of the same type)End of change

In the following example, the source element called Name has the same structure as the target element called Name:
Source Target
Name
	Title
	First_name
	Middle_name
	Last_name
Name
	Title
	First_name
	Middle_name
	Last_name
To map the entire source structure to the target structure, drag the parent element (Name) from the Source pane onto the corresponding element (Name) in the Target pane. All the child elements are mapped.

Start of changeMapping source structures to target structures (where the source and target are of a different type)End of change

Start of changeIn the following example, the source element called Name has a different structure to the target element called DifferentName:
Source Target
Name
	Title
	First_name
	Middle_name
	Last_name
DifferentName
	Title
	FirstName
	LastName
To map the entire source structure to the target structure, drag the parent element (Name) from the Source pane onto the corresponding element (DifferentName) in the Target pane. The Map By Name wizards opens. Select Map leaves and Map items of same and similar names to map all child elements in the target. The source element Middle_name will not be mapped, as there is no target element with the same or a similar name.End of change

Mapping multiple source elements to a simple target element

In the following example, you want to concatenate the First_name and Middle_name source elements to form a single target element called First_names:
Source Target
Name
	Title
	First_name
	Middle_name
	Last_name
Name
	Title
	First_names
	Last_name
To map multiple source elements to a simple target element, Ctrl+click the appropriate source elements (First_name and Middle_name) and the target element (First_names), then click Map > Map from Source. A concatenate function appears in the Spreadsheet pane; you can edit this function to define how the concatenated target element looks, for example, by adding a white space between the two source elements.

To customize the target element (for example, to make the target value equal to the source value plus one), see Setting the value of a target element using an expression or function. You cannot map a simple element if one of its ancestors also has a mapping. For example, you cannot map Properties from source to target, then map Properties/MessageFormat.

Related concepts
Message Mapping editor
Creating message mappings
Related tasks
Mapping from source: by selection
Mapping from source: by name
Setting the value of a target element using an expression or function
Related reference
Message Mapping editor Source pane
Message Mapping editor Target pane
Message Mapping editor Spreadsheet pane
Message mappings