Mapping from source: by selection or by name

There are two ways to map from source: by selection, or by name. The following steps describe how to map from source using the Map from Source wizard, or using the drag and drop method.

Using the Map from Source wizard

  1. Select the source and target elements that you want to map by clicking them.
  2. Click Map > Map from Source.

    There are four possible scenarios: the first three scenarios represent mapping by selection, while the fourth scenario demonstrates mapping by name.

    • If more than one mappable source element is selected, the selected sources are mapped to the selected target.
    • If more than one mappable target element is selected, the selected source is mapped to the selected targets.
    • If one mappable source and one mappable target are selected, and neither element has any children, the selected source is mapped to the selected target.
    • If one mappable source and one mappable target are selected, and either element has children, the Map from Source wizard opens to allow you to perform mapping by name. Go to Step 3.
  3. Choose the appropriate option from the Map from Source wizard:
    • Deep copy entire complex element. This option copies the entire structure below the element. The option is available only when the selected source and target elements have the same type definition, or when the source type is derived from the target type.
    • Map leaves. This option maps only the parts of the structure below the element that match each other.
    • Map immediate children. This option maps only the immediate children of the source element to the immediate children of the target element that match each other. This option is available only when the selected source and target elements have immediate children that are mappable.
  4. If you select the Map leaves or Map immediate children option, specify how names are matched.

    Items of the same name are always considered to be a match and the Map items of same names check box is always selected by default. Two names are considered to be the same if they contain the same alphanumeric characters in the same order. This comparison is not case sensitive, so FIRST_NAME and FirstName are considered to be a match.

    If you select the Map leaves or Map immediate children option, the Map items of similar names check box is also available. Two names are considered to be similar if one name is a truncation of the other, such as first_name and name, or PART_NUMBER and partNum. Also, if one name is a contraction of another, such as November and nvmbr, they are considered to be similar.

  5. If you selected the Map leaves or Map immediate children option, verify that the mappings are relevant and edit them manually if necessary. You might need to delete unwanted mappings and add extra mappings.

Using the drag and drop method

Drag the appropriate source element or elements onto the target element or elements.

When you use the drag and drop method to map from source, mapping by selection is always performed. You can use the drag and drop method in the following scenarios:

Related concepts
Message Mapping editor
Creating message mappings
Related tasks
Mapping a target element from source message elements
Mapping a target element from database tables