<filterlist> XML element

This XML element specifies the global filters for a Performance Dashboard.

The list contains one entry per dimension. You can specify one and two-level dimensions as well as time dimensions.

The attributes of the filter XML element determine the appearance and source of the filter pick lists:

Attribute

Description

name

Displayed title of the filter element

type
(optional)

Type of filter element, valid values: dynamic (default), static, time, and textinput.
dynamic: Dimension values are displayed in the pick list.
static: Favorites from a particular folder are displayed.
time: Interactive time bar selection element.
textinput: Dimension values are entered using an input box.

source
(optional)

Name of the connector used to query the filter values. The default is ppm. When you use the by_login_user option for querying data, the logged in user's data access privileges are taken into account.

row
(optional)

Row in which the filter element is displayed. The default is 0.

displaytext_static
(optional)

Source for the texts displayed in favorite-based pick lists; valid values: favoritename, favoritedescription (default)

sortby_static
(optional)

Sort direction of the texts displayed in favorite-based pick lists; valid values: favoritename, favoritedescription (default)

displaytext_dynamic
(optional)

Dimension attributes used to display the texts in dimension-based pick lists; valid values: key_description (default), description_key, only_key, only_description

displaylevel_dynamic
(optional)

Dimension levels displayed in dimension-based pick lists; valid values: only_first, only_second, first_and_second (default), level_last

nofilter_entry
(optional)

Switch to set whether the No filter option is included in the pick list; valid values: true (default), false

leveldelimiter
(optional)

Separator used as a separator between filter values of multi-level dimension values when using the text input box.

rowcount
(optional)

Number of list items of the selection lists of filter types static and dynamic. Default value 5.

Example

...

<filterlist>

<filter row="0" name="WERKS" type="dynamic"

displaytext_dynamic="key_description"

displaylevel_dynamic="only_first"

nofilter_entry="true">

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

<description language="en" name="Region" />

</filter>

<filter row="0" name="MATERIAL" type="dynamic" rowcount="12"

displaytext_dynamic="key_description"

displaylevel_dynamic="first_and_second"

nofilter_entry="true">

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

<description language="en" name="Material" />

</filter>

<filter row="0" name="TIME" type="static"

displaytext_static="favoritedescription"

sortby_static="favoritename"

nofilter_entry="true">

<description language="de" name="Zeit relativ"/>

<description language="en" name="Time relative"/>

<usefavorite>\Dashboard\FilterTimeRel\</usefavorite>

</filter>

<filter row="1" name="TIME" type="time" source="ppm_sap">

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

<description language="en" name="Time" />

</filter>

<filter row="2" name="PRICIPAL" type="textinput" source="ppm_sap">

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

<description language="en" name="Principal" />

</filter>

</filterlist>

...