Configuring Facet Filters

APF-based applications can use facet filters that narrow down the data of an entire analysis path. For each facet filter, you can configure the following:

The property for which a facet filter is displayed
The values that are listed in the value help for the property
You may have to configure a value help request to generate the list of values that the user can choose from to filter the data.
The values that are preselected in the value help.

When you launch your APF-based application from a Smart Business KPI tile, you must also consider whether a filter is handed over with the Smart Business context and how that affects the facet filter.

You can use the fields listed in the following table to configure a facet filter. Not all of the fields are relevant for each use case. For example, you can configure a value help request to determine the entries in the value help list. A filter resolution request is necessary if the Smart Business context contains not only single values, but also other operators. The filter resolution request then resolves the context into a list of single values. This is necessary because a facet filter can only display single values. For details about possible use cases, see Use Cases for Configuring Facet Filters.

Field		Explanation
Facet Filter Definition	Property	The property for which you want to configure a facet filter. This property is also used as the property displayed in the facet filter if an alias is not defined. Values that the user selects in the facet filter are handed over to the entire analysis path as filter.
	Label	The label displayed for the facet filter at runtime.
	Alias	The property displayed in the facet filter. It is used if the field name of the facet filter’s property is different in the value help request. If the property and the alias are the same, the alias can be omitted.
	Selection Mode	Choose whether you want to allow single selection or multiple selections.
Value Help	Service	The request that determines the values that are displayed in the value help. Enter the path to the OData service root.
	Entity Set	Entity set that corresponds to the SAP HANA view. This field is mandatory if a service has been entered.
	Properties	The properties that determine the values in the value help. Select at least the facet filter property or the alias property. You can also select further properties. For example, you can select CompanyCode and Revenue so that the value help lists those company codes for which revenue exists. If you select both a filter property and the corresponding text property, for example, CompanyCode and CompanyCodeName, a concatenation of key and text is displayed in the facet filter and you can search for both of them.
	Default Value Mode	Select Fixed Values if you want to list specific values that are preselected in the value help. Select Function if you want to specify a function that calculates the default values.
	Default Values/Function	Depending on the default value mode, either specify the fixed default values or a function. If you chose single selection and fixed default values, it is mandatory to enter a default value. If you chose multiple selection and fixed default values, it is optional. In this case, if you don’t enter any default values, all values are selected in the facet filter. Note If a context is handed over from a Smart Business KPI tile for this filter property, this context replaces the default values. The default values are used as a fallback only. This is necessary because it is not possible to have an empty facet filter.
Filter Resolution	Service	The request used for resolving a context into single values for the value help. You should specify a filter resolution request if there is a possibility that a Smart Business context is handed over that does not contain single values. If you did not specify a filter resolution request, but a filter resolution is necessary to be able to display the values in the value help, the facet filter for the corresponding property is not displayed on the UI. Instead, the context is applied to the analysis path in the background.
	Entity Set	Entity set that corresponds to the SAP HANA view.
	Properties	The properties that determine which values are preselected in the facet filter. Select at least the facet filter property or the alias property. You can also select further properties.