Access and Edit Rules

Use the rule editor in the Essbase web interface to access and edit a dimension build rule.

Prerequisite: Import a cube from the gallery. The following instructions assume you have built or imported Sample Basic.

  1. Log in to the Essbase web interface.

  2. On the Applications page, open the application and then open the database (cube).

  3. Select the Scripts tab, and then click Rules.


    Scripts tab is selected and Rules tile is highlighted, in Essbase web interface.

  4. Click Dim_Product, which is the name of a dimension build rule associated with Sample Basic.

    The Dim_Product rule opens in the rule editor.


    Edit Rule dialog with Dim_Product rule opened. Field 1 is labeled Product, Parent. Field 2 is labeled Product, Child. Field 3 and 4 are labeled Product, Property, Child. No preview data is available, so there are empty rows below the field definitions.

    Fields are defined with metadata that identifies the expected format of the source data file. These definitions are already present, because this rule was created automatically by the application workbook when you imported the cube.

    All fields are associated with the Product dimension. This rule uses the parent-child build method. Field 1 is designed to expect a parent member. Field 2 expects a child of Field 1. Fields 3 and 4 are reserved for identifying member properties of the child member in Field 2. Fields 5-9 are for aliases associated with the child.

    No preview data is visible until you associate this rule with a data file. That is why there are empty rows (records) beneath the field definitions.

  5. Now associate a source data file with the rule, to preview it and ensure that the field definitions map correctly to the records in the source file. Click Source Properties.

  6. Click File Properties.


    Edit Source dialog with File Properties tab highlighted

  7. For Select a file, navigate to the source data file for building the Product dimension. In the Catalog, it is Dim_Product.txt, located in the current cube directory for Sample Basic.

  8. Select Dim_Product.txt from the list, and click Select.

    The file has no header record, and is comma-delimited, so you can leave all the defaults as-is, and click Preview Data.

    Note:

    You can increase the number of records that will display in the preview by incrementing Preview Data Count on the File Properties tab. The maximum preview size is 500 records.

    The Dim_Product rule is populated with preview data mapped to the fields.


    Edit Rule dialog with Dim_Product rule opened and preview data populating the rows below the field definitions.

    Blank cells in the preview correspond with null values ("") in the source data.