getFilterProperties(hierarchyName:String):Object
[starting from version: 1.6]
Returns the filter properties set for the specified hierarchy.
Parameters
hierarchyName – the name of the hierarchy.Returns
Object that describes the filter set for the hierarchy. The object always has type and members properties. It may have quantity and measure properties if filter on values is defined. It has all four properties if both filters, on hierarchy’s members and on values, are defined. Structure of the object:
type – Represents the filter type applied to the hierarchy. It can be:'none' – the filter is not applied to the hierarchy,'members' – the filter on hierarchy’s members is applied,'top' – the filter Top X is applied on values,'bottom' – the filter Bottom X is applied on values.members (optional) – Array. Represents the filter on hierarchy’s members. Each object in array contains the following parameters: caption, uniqueName, and hierarchyName.quantity (optional) – Represents the filter on values. Number of elements to choose for the Top X filter if type is 'top' or for the Bottom X filter if type is 'bottom'.measure (optional) – Object. Represents the filter on values. Identifies the measure on which Top X or Bottom X filter will be applied. Has the following properties:uniqueName – String. Unique measure name.aggregation (optional) – String. Measure aggregation type.Example
var filter = [
"category.[cars]",
"category.[bikes]"
];
flexmonster.setFilter('Category', filter);
flexmonster.getFilterProperties('Category');
/*
method getFilterProperties() returns the following object, where type is 'members' and members property has 2 elements
{
type : 'members',
members : [
{'caption' : 'Cars', 'uniqueName' : 'category.[cars]'},
{'caption' : 'Bikes', 'uniqueName' : 'category.[bikes]'}
]
}
*/
flexmonster.clearFilter('Category');
flexmonster.getFilterProperties('Category');
/*
after clearFilter() call method getFilterProperties() returns an Object with type 'none' and empty members array
{
type : 'none',
members : []
}
*/
Try the example on JSFiddle.
See also