When calling a Management view, you can specify filter settings in the form of a parameter list in the URL. The parameter list is simply added to the URL of the Management view page and has the following format:
&<Parameter_1>[[&<Parameter_2>]…&<Parameter_N>]
A parameter is made up of the following information:
<Key>[(<Format>)][:<Separator>]=<Value1.1>[<Separator>
<Value1.2][;<Value2.1>[<Separator><Value2.2][;…]
Element |
Description |
Key |
Internal name of the dimension or measure |
Format |
Expected format of filter values (formatting instructions) |
Separator |
String used to separate filter values of the refinement levels of multi-level dimensions or to separate the limit values of an interval |
Value.1 |
First filter value for first level |
Value1.2 |
First filter value for second level |
Value2.1 |
Second filter value for first level |
Value2.2 |
Second filter value for second level |
Key
Indicate the internal name to specify the dimension or measure that the filter is to apply to. The internal name corresponds to the name XML attribute specified in the measure configuration.
Format (optional)
The formatting instructions specify how a transferred filter value will be interpreted. Default formats exist for each filter type, which are used if no formatting instructions are specified.
Separator (optional)
The specification of a separator is introduced by a colon and is specified as a string. The separator must not contain any special characters. It separates the values specified for the levels of two-level dimensions or the limit values for the description of floating point intervals and time periods.
By default, the minus symbol is used as a separator.
Values
The filter values are expected in the specified format. The specified value must match the data type of the dimension or measure.
Multiple filter values are separated by semicolons. If an interval or time period is specified, the lower limit value is contained in the results set, the upper limit is not.
The following characters are meta-characters of the parameter list and must not be used in key names and filter values:
Characters |
Description |
? |
Separator between URL and parameter list |
& |
Separator between individual parameters in parameter list |
= |
Separator between key and value of a parameter |
( ) |
Limiting characters for formatting instructions |
; |
Separator between multiple values of a filter criterion |
\ |
Replaced by slash |
/ |
Must not be used in values of one and two-level dimensions |
+ |
Replaced by a space |
{ } |
Replaced by square brackets |
If you filter a dimension via a URL, which is also included in the global filter component (see Integrate global filter components), the selection box of this dimension filter or the slider display the text External filter. The set filter value is shown in the tooltip.
For this to work, the filters of the global filter component must be inactive, i.e., the entry No filter must be selected in the selection box (this requires the XML attribute nofilter_entry="true" in the corresponding filter definition in the _conf file), or the time filter is inactive.