Set Dimension Build Global Properties and General Source Properties

Use the global properties of an Essbase dimension build rule to set properties affecting all dimensions in the rule, including alias table, dimension arrangement, and auto configuration. Use source properties of a dimension build or data load rule to specify the handling of headers and tokens in the source data.

Dimension Build Global Properties

You can change the following global properties, affecting all dimensions included in a dimension build rule.


Global Properties available for a dimension build rule include Alias Table selection, Arrange Dimensions option, Auto Configuration option, and an interface to add or update Smart Lists (also known as text list objects).

Select Alias Table

You can select which alias table to update with new aliases from the source data. If you do not specify an alias table, the dimension build updates the default alias table.

For example, the following selection indicates to Essbase that any alias updates found in the source data should affect only the Long Names alias table, when you run the dimension build.


Alias Table selection is Long Names

To specify which alias table to update,

  1. Open or create a dimension build rule.

  2. Click Global Properties.

  3. From the Alias Table selector, choose an alias table, and click OK.

  4. Verify, save, and close the rule.

Arrange Dimensions for Calculation Performance

Dimension placement (within outlines) affects calculation time.

This setting is applicable to block storage cubes only. In global properties for a dimension build rule, you can optimize calculation performance by placing dimensions in the following order (called an hourglass arrangement):

  1. Densest dimensions (accounts and time)

  2. Remaining dense dimensions (largest to smallest)

  3. Sparse dimensions (smallest to largest)

  4. Attribute dimensions (no particular order)

To arrange the dimensions this way (applicable only for block storage outlines),

  1. Open or create a dimension build rule.

  2. Click Global Properties.

  3. Select Arrange Dimensions, and click OK.


    Dimension build global properties with Arrange Dimensions checked

  4. Verify, save, and close the rule.

Auto Configure Density and Sparsity

This setting is applicable to block storage cubes only.

By default, dense and sparse settings for dimensions are kept as either the existing setting or the setting specified in the dimension build rule. To override this default and let Essbase automatically assign dimensions to be dense or sparse,

  1. Open or create a dimension build rule.

  2. Click Global Properties.

  3. Select Auto Configuration, and click OK.

  4. Verify, save, and close the rule.

Add or Update Smart Lists (Text List Objects)

Expand the Smart Lists section to add or update a text list object, also known as a Smart List. Text list objects are a way to store metrics as textual values, when your accounts dimension is designed to work with text measures. You can implement text measures when your outline is enabled to work with typed measures. To see a sample cube that uses a textual measure dimension, import the sample application Facility Rating, available in the gallery section of the Files catalog.


Smart List specification in dimension build rule global properties

General Source Properties (for Dimension Build and Data Load Rules)

Using the general Source Properties of a dimension build or data load rule, you can broadly set how the rule behaves with respect to the source data.


Source properties, general tab for a dimension build rule or data load rule. Includes text box labeled Header, a text box labeled Tokens to Ignore, and a selector labeled Tokens Joined By, with AND or OR options available.

To specify general source data options in the rule,

  1. Open or create a dimension build or data load rule.

  2. Click Source Properties.

  3. On the General tab,

    • Enter a Header string used in the source data, if known. This will be skipped during the dimension build or data load.
    • If needed, enter source data records to ignore, based on the presence of a given token, during the dimension build or data load. A token is one delimited string in the source data.
    • If you listed multiple tokens to ignore, specify AND if Essbase should ignore only records that contain all of the tokens. Specify OR if Essbase should ignore records that contain any of the tokens.
  4. Click OK, then verify, save, and close the rule.