.Stat Suite documentation

Filters

Table of Content

General note: All content related to the filter area is localised. For more information, go to the general documentation about Languages.


Filter area

The left-hand side (right-hand in rtl mode) of the visualisation page shows a set of dimension filters that allow dynamically filtering the dimension values to be displayed in the preview table or chart, to be extracted through the download feature ‘Filtered data in tabular text (CSV)’ or to be applied in the auto-generated data query in ‘Developer API’ menu.

Since April 20, 2023 Release .Stat Suite JS unicorn, the current filters selection is summarised in the ‘Applied filters’ area, and displayed on the right-hand side (right-left in rtl mode) of the visualisation page.

A filter is created for each of the dimensions of the currently displayed dataflow based on data availability (see documentation), except if the dimension contains only one possible item or if it is configured to be hidden. In addition, the dimensions ‘Frequency’ and ‘Time Period’, when available, are automatically combined into a common ‘Frequency & Time Period’ filter (see the related documentation).

The order of the filters respects the order of the dimensions as defined in the underlying data structure definition (DSD), except the ‘Frequency & Time Period’ filter panel, which is displayed second after the ‘Applied filters’ panel.

The number of currently selected items against the number of available items (selected/available) is displayed next to each filter name.

Multi selection filters

If the user has made selection(s) in the previous search result page, if a default selection is applied from an SDMX annotation (see documentation), or if the URL contains dimension selections, then these selections are automatically pre-applied in the filters.

Whenever there is no filter item selection, then it is indicated in the filter title by “all”, e.g. "all/39". When all filter items are selected, the number of selected items is displayed instead "39/39".
Because making no selections and complete selections return the same data, the usage of “all” should help to clarify this effect, while there remains a visual distinction for the fact that a saved selection is static while the items concerned by no selection may evolve over time. Indeed, as a generic behavior, when no element of a filter is selected, then it acts as if all items were selected. However, if a corresponding query is saved (e.g. bookmarked page, saved API query or shared dynamic table/chart), then the results may defer later in case the available dimension items evolve.
Therefore, while a full selection would always correspond to 39 items, for no filter selection the number of actually considered dimension items might increase, e.g. 40, 41 etc.


Multi-selection filters

All filters are standardised multi-selection filters, except the ‘Frequency & Time Period’ filter. It means that the user can select multiple items per filter.

Multi selection filters

(since October 5, 2021 Release .Stat Suite JS 10.0.0) Each item of a filter is displayed with a checkbox on the left side in the filter list:

  • when the item is not selected, the checkbox is empty;
  • when the item is not selected and the mouse hovers it, the checkbox stays empty and the background is blue;
  • when the item is selected, the checkbox is changed into a tick mark.

de filter checkbox

Since April 20, 2023 Release .Stat Suite JS unicorn, the bulk selection option has been replaced by the advanced selection popup feature.

When a filter contains 8 items or more, then:

  • a vertical scrollbar is added to the filter
  • a local search (spotlight feature) box is displayed,
  • an advanced selection button is displayed next to the local search box, which gives access to an advanced selection popup. A localised tooltip with the text “Use advanced selection modes” is displayed on mouse-over.

Advanced selection button

Any filter selection change will automatically trigger the update of the data view (table/chart/API query), and these changes will also be reflected in the ‘Applied filters’ panel.

Hierarchical content

In case of a hierarchy in the items, they are shown as ‘a tree’, which means that the filter will display all the items with indentations according to the item level in the tree. A blue arrow next to an item indicates that this item is a parent of child item(s). Clicking this blue arrow switches its up/down direction and the related child items will respectively be hidden or become visible. By default, the tree is fully expanded so that all the items of all tree levels are visible (through scrolling if needed).

Hierarchical contents

If for a parent (at any level) there are no data available (according to the Actual ContentConstraint related to the Dataflow), then the parent item is not selectable (and marked in light grey). Still, the user can navigate to the children.

Hierarchical contents

For more information on how advanced hierarchies can be applied, please see Advanced hierarchies.

Display of code descriptions

Introduced in March 4, 2022 Release .Stat Suite JS 13.0.0

The localised descriptions of codes defined in a codelist of a dimension are displayed on mouse-over on the related filter items using a tooltip. These items are underlined with dots in order to inform the user of the availability of the description.

Code descriptions

Advanced selection popup

Clicking the advanced filter selection button triggers the display of an advanced selection popup. It provides more advanced selection options especially for a longer or hierarchical list and refreshes the data view only once the new selection is validated by the user.

The popup always provides a local search (spotlight feature) box.

Clicking the Selection mode button located next to the local search box opens a drawer with tiles for the different modes of selection:

  • Single item
  • Item and all items directly below
  • Whole branch
  • All items at the same level
  • All items

Once the user clicked one of the tiles, the drawer closes again upwards. All following filter selections apply the chosen selection mode.

Hierarchical contents

Additional features in the popup propose to Expand all items or to Collapse all items keeping only the root item(s) when the items are hierarchical.

To apply the selection in the Filters area and refresh the data view, it is necessary to click on the Apply button, which closes the advanced selection popup.

Data availability

In filters with hierarchical dimensions, parent values, for which no data exist, are still shown but marked specifically. For more information, see Data availability.

The local search (spotlight feature) helps to find specific items.

Typing some characters in the local search box dynamically reduces the displayed items to the ones containing the given set of characters. If the local search term has no hit in any item then the list is empty.

Local search example

Since April 20, 2023 Release .Stat Suite JS unicorn, whenever the content of the local search box is changed, the items in hierarchical lists are fully expanded. When a local search terms has a hit in a child item, then all its above parent items will automatically be displayed, even if the search term was not found in these parent items.

Local search example with hierarchy

Keyboard selection options

Released in (January 21, 2021 Release .Stat Suite JS 7.0.0)

The keyboard’s Ctrl and Shift keys, as well as holding mouse click, can be used in the filters and in the advanced selection popup to ease multiple selections.

  • Using the Shift key:
    If you first press Shift and select an item of a list, then selecting another item while still holding Shift will result in selecting all intermediate items (between those 2 selections) of the list. The same principle will apply in de-selection mode. As long as the ctrl key is held, the data table is not updated.
  • Using the Ctrl key:
    If you first press Ctrl and select an item of a list, then selecting another item while still holding Ctrl will result in selecting this second item too. You can keep on selecting new items as long as Ctrl is held.
    As long as the ctrl key is held, the data table is not updated.
    Remark: The combination of ctrl and shift keys is not possible.
  • Holding mouse click:
    If you click on one item and hold the mouse button without releasing it, then moving the mouse cursor down/up to another item of the same list will select both items and all intermediate ones.
    As long as the mouse button is held, the data table is not updated.

Note that these keyboard selection options are not compatible with the web content accessibility support.


Frequency and Time period filter

See here for details.


Applied filters panel

Since April 20, 2023 Release .Stat Suite JS unicorn, the ‘Used filters’ panel has been renamed to ‘Applied filters’ and moved above the data table.

The ‘Applied filters’ panel displays all currently selected items per dimension of the data table.

This panel provides an overview of the current selection and an easy mean to unselect individual dimension items or whole dimension selections:

  • one single item by clicking on the x next to the item label, or
  • all items for a given dimension by clicking on the x next to the dimension label, or finally
  • all selections by clicking on Clear all filters.

Selected root items are displayed ordinarily. Selected child items are displayed prefixed with ...> and the details of the full parent hierarchy are shown in a tooltip.

Hierarchical contents

To ease the readibility of the applied filters when 15 or more items are selected in a facet, the display of the individual selected items is replaced by a number being the number of selected items for the specific facet.

Applied filters
Applied filters

When viewing the microdata table, the ‘Applied filters’ panel is not displayed.