Create Attribute Mapping Groups

To create a new attribute mapping group right-click on either the top-level Attribute Mappings node, or on an existing attribute group node. From the menu that is then displayed, select either the Create > Attribute Group option or the Insert > Attribute Group option.

If the Create option is selected, the new attribute group node with the default name of New Attribute Mappings is then created at the bottom of the hierarchy of groups and mappings within the currently selected node.

If the Insert option is selected, the new attribute group is instead created directly above the node that was selected when the option was selected. The Insert option is not available from the top-level Attribute Mappings node.

The right-hand section of the dialog displays the properties of the new group.

Complete these properties to set up the attribute mapping group.

1. In the Name field, change the default name of the mapping as required. Alternatively, double-click on the name in the tree-view and type in the name. A mapping name may be up to 50 characters. The @ symbol may not be included.

2. The Element Types field displays the SCTYPEs to which the mappings in the group can be applied.

   If no SCTYPEs are specified in this field, all SCTYPEs may be selected for mappings in the group.

   To select the SCTYPEs, click the ... option at the end of the field. The Select Values dialog is then displayed.

   

3. The Select Values dialog consists of two lists. The Available Values list lists the SCTYPEs which are available for selection. The Selected Values list lists the SCTYPEs that have been selected.

   To select an SCTYPE, select it in the Available Values list and click the > option to transfer it to the Selected Values list.

   To de-select an SCTYPE, select it in the Selected Values list and click the < option to transfer it back to the Available Values list.

   Use the >> option to move all SCTYPEs to the Selected Values list. Use the << option to move all SCTYPEs to the Available Values list.

   Click the OK option once the required SCTYPEs have been selected. The selected SCTYPEs are then displayed in the Element Types field.

   Click Cancel to close the dialog without saving any selections that have been made.

4. Whether or not the attribute mappings in the group are applied can be made conditional. To enter the conditions, select the ... option at the end of the Condition field and enter an XPath Expression using the XPath Expression Builder dialog. For further information, refer to XPath Expression Builder Dialog.

   If an invalid expression is entered, "False" is displayed in the Condition field, indicating that the mapping cannot be applied. If a valid expression is entered, "True" is displayed.

   "True" is also displayed if no conditions are entered. If no conditions are entered, mappings are applied by default.

5. In the Source System field, select which source system the mappings in the group are to be applicable to. The mappings in the group will only be applied to data imported from this system. The default entry is blank, meaning all systems.

   Note:
   The list of source systems can be added to by processing data files using the Source Dictionary Management interface.

6. In the File Format field, select the import source file format associated with the source file attributes in the group from the drop-down list. The default entry is blank, meaning all formats.

7. The File Format Version field displays the versions of the source file format associated with the source file attributes in the group. The default entry is blank, meaning all versions.

   To select the versions, click the ... option at the end of the field. The Select Values dialog is then displayed.

   

   For further information, refer to Create Attribute Mapping Groups.