One-level dimensions

A one-level dimension (oneleveldim XML element) is described in full by only one level definition (leveldesc XML element). The language-specific names of the dimension, key, and description are specified in the description XML elements.

<?xml version="1.0" encoding="ISO-8859-1"?>

<!DOCTYPE keyindicatorconfig SYSTEM

'KeyindicatorConfiguration.dtd'>

<keyindicatorconfig>

...

<oneleveldim name="VTWEG" dimtype="PROCESS"

internal="no" importmode="OPTIONAL">

<description language="de" name="Vertriebsweg"/>

<description language="en"

name="Distribution channel"/>

<leveldesc>

<dimitem attrname="AT_VTWEG" colname="FIRST_ID"

calculated="FALSE">

<description language="de"

name="ID des Vertriebsweg"/>

<description language="en"

name="ID of distribution channel"/>

</dimitem>

<dimitem attrname="AT_VTWEG_NAME"

colname="FIRST_DESC" calculated="FALSE">

<description language="de" name="Vertriebsweg"/>

<description language="en"

name="Distribution channel"/>

</dimitem>

</leveldesc>

</oneleveldim>

...

</keyindicatorconfig>

XML attribute

Description

name

Name of the dimension. A table is created in the database under this name. For the specified name, the guidelines described in the Table name chapter are applicable.

dimtype

Dimension type: Valid values:
PROCESS (process dimension)
FUNCTION (function dimension, obsolete, only to be used for compatibility reasons)
OT_FUNC (function dimension)
RELATION (relation dimension)
OT_ORG (organizational dimension)

internal

Internal use of the dimension
yes: The dimension is used internally and is not displayed in the interface.
The default value is no.

importmode

Output of error messages when calculating dimension values
OPTIONAL: Calculation errors are not output.
MANDATORY: Calculation errors are output
Default value: OPTIONAL

dimgroup
(optional)

Dimension group to which the dimension is assigned

XML element

Description

compression
value
(optional sub-element for dimitem)

The internal aggregation attribute AT_INTERNAL_COMPRESSCRITERION must be specified (Configure the internal aggregation attribute).

Only for dimtype="PROCESS"

Identical and differing dimension values are deleted when permanently aggregating using the command prompt (runppmcompress) (see PPM Operation Guide) and they are replaced by the specified aggregation value (Change aggregation behavior).

To avoid the not specified dimension step for a dimension, specify importmode="MANDATORY" so that process instances that cannot be assigned to any dimension step are identified when importing the data by the output of a corresponding message.

Internal dimensions

Internal dimensions (internal="yes") are not displayed in the PPM front-end interface. They are used to distinguish administrative process instance characteristics.

Using multi-byte character sets

The following file extract from the measure configuration shows an example of the definition options for one-level dimensions when using a multi-byte character set:

...

<oneleveldim name="D_PRODUCT_GR" dimtype="FUNCTION"

internal="no" importmode="OPTIONAL">

<description name="Produktgruppe" language="de"/>

<description name="Product group" language="en"/>

<description name="Ομάδα προϊόντων" language="el"/>

<leveldesc>

<dimitem attrname="ΙΔ_ΣΥΝ_ΠΡΟΪΟΝΤ_ΤΑΥΤ"

colname="Column name_3" calculated="FALSE">

<description language="de"

name="ID Produktgruppe"/>

<description language="en"

name="Product group ID"/>

<description language="el"

name="Ταυτότητα ομάδας προϊόντων"/>

</dimitem>

<dimitem attrname="ΙΔ_ΣΥΝ_ΠΡΟΪΟΝΤ_ΠΕΡΙΓΡ"

colname="Column name_4" calculated="FALSE">

<description language="de"

name="Beschreibung Produktgruppe"/>

<description language="en"

name="Product group description"/>

<description language="el"

name="Περιγραφή της ομάδας προϊόντων"/>

</dimitem>

</leveldesc>

</oneleveldim>

...