Create Attribute Mappings

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

If the Create option is selected, a new attribute mapping with the default name of New Attribute Mapping is then created at the bottom of the hierarchy of groups and mappings within the current node.

If the Insert option is selected, the new attribute mapping is instead created directly above the node that was selected when the option was selected.

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

Complete these properties to set up the attribute mapping.

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 mapping is to be applied. To select the SCTYPEs, click the ... option at the end of the field. The Select Values dialog is then displayed.

   For further information on this dialog, refer to Create Attribute Mapping Groups.

   The SCTYPES that are available for selection are limited to those specified for the mapping group. If no SCTYPEs are specified for the group, any available SCTYPE may be selected.

3. In the Database Attribute field select the UDAs/database attributes to which the source file attribute is to be mapped to. The attributes that may be selected will be those common to the SCTYPEs selected in the Element Types field.

   

4. Whether or not an attribute mapping is applied can be made conditional. To enter the conditions, click 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.

   Note:
   Conditions may also be set up for the group as a whole. If conditions have been setup for both the group and the mapping, both sets of conditions must be satisfied if the mapping is to be applied.

5. In the Attribute Value field, either enter the name of the source file attribute. Alternatively, click the ... option at the end of the field and enter an XPath Expression using the XPath Expression Builder dialog. For further information, refer to XPath Expression Builder Dialog.

6. In the Attribute Units field, if applicable select the type of unit (for example, weight, volume) associated with the source file attribute from the drop-down list.

   Alternatively, select the ... option at the end of the field and enter an XPath Expression using the XPath Expression Builder dialog. For further information, refer to XPath Expression Builder Dialog.

   This field may be automatically completed if the XPath Expression Builder dialog is used to enter an XPath Expression in the Source Attribute field. For further information, refer to Automatic Setting of Attribute Units and Types.

7. In the File Format field, select the import source file format associated with the source file attribute from the drop-down list. The default entry is that of the attribute group.

8. The File Format Version field displays the versions of the source file format associated with the source file attribute. The default entry is that of the attribute group.

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

For further information on this dialog, refer to Create Attribute Mapping Groups.