Mappings dialog box

This dialog contains a Mappings table, and options to create new, modify, or remove mappings.

Option Description

Mappings table

This table displays all of the source property mappings that have been defined for the project. It includes the following columns:
  • Source: The source property to be mapped.
  • Target: The dimension or Endeca property that the source property will be mapped to.
  • Match mode: For dimension mappings, indicates the type of match mode used.

    Normal

    Normal maps only those source property values that have a matching dimension value explicitly defined in the dimension hierarchy. Forge assigns the IDs for any matching dimension values to the Endeca records. Any source property values that do not have matching dimension values in the dimension hierarchy are ignored.

    In order for a source property value to match a dimension value, the dimension value's definition must contain a synonym that:

  • Is an exact text match, including capitalization and white space, to the source property value.
  • Has its Classify option enabled.
    Note: There are two types of advanced dimension values, range and sift. These dimension value types have different matching criteria than standard dimension values. See About range dimension values and About sift dimensions, respectively.

    Must Match

    Must Match behaves identically to Normal, with the exception that Must Match issues a warning for any source property values that do not have matching dimension values.

    Auto Generate

    Auto Generate specifies that Forge automatically generates a dimension value name and ID for any source property value that does not have a matching dimension value in the dimension hierarchy. Forge uses these automatically-generated names and IDs to tag the Endeca records the same as it would explicitly-defined dimension values.

    Auto Generate dramatically reduces the amount of editing you have to do to the dimension hierarchy. However, auto-generated dimensions are always flat. Auto-generated names and IDs are persisted in a file that you specify as part of a dimension server component.

New

Click to create a new mapping of one of the following types:
  • Null Mapping: Indicates that the source property should be ignored during mapping.
  • Property Mapping: Maps the source property to an Endeca property.
  • Dimension Mapping: Maps the source property to a dimension.

Modify

Used to modify an existing mapping. To modify a mapping:
  1. Select it in the mappings table.
  2. Click Modify .
  3. Make your changes in the dialog box that appears.
  4. Click OK .

Remove

Removes the selected mapping.