Dimension Extract

A dimension can be extracted from a Jedox In-Memory DB (OLAP) database using the dimension extract. The extract creates a tree.

Dimensions can be filtered for the following items:

  • Elements
  • Consolidations (i.e., hierarchical relations between elements)
  • Consolidation factors
  • Element types (numeric / string)
  • Attributes
  • Formats and styles for dimension elements

Settings

Connection Connection to Jedox In-Memory DB
Dimension A dimension from the selected database
Read attributes
none No attributes are extracted.
standardAttributes Attributes are extracted. If several languages are defined in the database, only values of the default language are extracted.
includeLanguages Attributes are extracted for all languages of the database. The attribute names in the dimension extract are in the form "<attributeName>@<languageName>" (e.g. "Description@de_DE")
includeStyles
 		Same as standardAttributes, but including formats and styles of dimension elements
includeLanguageStyles
 		Same as includeLanguages, but including formats and styles of dimension

Query Filter on Dimensions

A query filter on the dimension allows filtering according to the name of elements and the hierarchy. The values are filled dynamically, depending on the selected filter type (1), operator (2), and mode (3). These filtering options are described below.

1. Filter type options

accept All nodes that fulfill the filter criteria are included in the selection.
deny All nodes that fulfill the filter criteria are excluded from the selection.

2. Operator options

The values for each expression depend on the operator used; specific values are noted when necessary in the descriptions below.

equal Filtering occurs according to the element specified. This operator is not case-sensitive. Example: Austria

inAlphaRange Alphanumerical values in a particular range are filtered. Example: [A100,D200]. The short GIF below shows how this functionality works with dates.

inRange Numerical values in a particular range are filtered. Example: [1000,2000]

isEmpty Empty values (blank, space, or multiple space values) are filtered. The Value field should be left blank.

like Filters the dimension elements according to regular expressions. This operator is case-sensitive. You can change that by using the (?i) modifier at the start of a regular expression.

After using the regular expression, the data preview must look like in the example below:
subset Filters the dimension elements based on any stored global Subsets for the dimension. The extract can filter from Subsets with one or more defined filter criteria or variables:

Filtering from a stored Subset

Select the stored Subset from the "Edit Subset" dialog:

If the Subset uses variables, you must select them manually by adding as many rows as there are defined variables within the "Edit Subset" dialog.

Filtering with an Integrator variable

For more dynamic design, you can replace the value of the Subset variable with an Integrator variable, as shown in the screenshot below:

Note: the value " has to be escaped as \"

3. Mode options

Defines a hierarchical filter for the dimension. If not set, the default mode "onlyNodes" is applied, returning only the filtered elements independently of the hierarchy. In case of a global Subset filter, a mode is in general not reasonable.

Mode Example Tree view
rootToBases Selected value: Austria

Based on the selected element, this element and the elements above and below are filtered.
rootToNodes (to top element and the nodes above) Selected value: Basic Sports Equipment

All parents and their respective parents are filtered, including the selected elements.
rootToConsolidates Selected value: Basic Sports Equipment

Only consolidated elements above the selected element are filtered.
nodesToBases Selected value: Austria

All bases under this value are filtered, including the parent element.
onlyChildren Selected value: East

Only the children are filtered based on the element selected.
onlyBases Selected value: East

After filtering the elements according to any of the operators, takes all base elements underneath them. Consolidated elements are not included.

From the cube, only cells where ALL elements are base elements are returned. If you would filter all dimensions with mode "onlyBases" setting, "Base elements only" has no longer an effect. But here it removes cells from the result that are on consolidated elements for other dimensions.

In the example on the right, the filter value "East" passes the operator, and the returned elements are the base elements.
onlyNodes Only the selected element is filtered (nodal point).
onlyRoots Selected value: Austria

Only the element from the highest level of the hierarchy is filtered based on the selected element.

Example of Query Filter on Dimensions:

Filter Type Operator Value Mode
accept equal Austria onlyBases

Updated December 9, 2024