About dimensions and dimension values

A dimension is a collection of related dimension values, organized into a tree. Dimension values are tags, or labels, you use to classify the records in your data set.

Important: Understanding dimensions and dimension values is critical to building an Endeca implementation. This topic provides a brief overview. However, Oracle strongly recommends that you read "Understanding Records, Properties, and Dimensions," in the Endeca Concepts Guide.

Dimensions

Dimensions provide the logical structure for organizing the records in your data set. Your Endeca application can have many dimensions, and dimensions can be hierarchical. For example, Merlot and Chablis dimensions could be children of the Wine dimension.

Dimension values

Dimension values both organize the record within the tree structure of the associated dimension, and identify the record as a valid result when that dimension value is selected via a navigation query.

Dimension values can either be discrete values (as in a year, a flavor, or a price), or include ranges with an upper and lower bound (for example, the years 1990-1999, or all prices under $10).

The top-most dimension value in a dimension tree is known as the dimension root. The bottom-most dimension values in a tree are referred to as leaf dimension values.

Auto-generated dimensions

Dimensions are often, though not always, derived automatically from source data properties.

Dimension value synonyms

Synonyms provide a textual way to describe a dimension value. A dimension value's definition includes one or more synonyms. Synonyms are used for display, search, and/or mapping, depending on how you set their three flags. Each of the synonym flags refers to the text that is contained in the body of the synonym element.

Note: Dimension values have synonyms, but dimensions do not.

Dimension.xml file

Developer Studio stores dimension hierarchy information in an XML file that the documentation and reference implementations generically call Dimension.xml. A data pipeline can have more than one Dimension.xml file, allowing you to provide dimension data from multiple sources.