This topic describes how to add and configure a filter bar for a tab. You can add multiple filter bars to a tab to query data of one or more charts.
Add a filter bar to a tab
The following example shows how to add a filter bar to Tab 1.
- Click the Workspace tab. In the left-side navigation pane, click Dashboards.
- On the Dashboards page, click the dashboard to which you want to add a filter bar.
- On the dashboard editing page, add a filter bar to the tab. You can add a filter bar to a tab by using one of the following methods:
- Move the pointer over Tab 1, click the icon on the right side of the tab, and then select Filter.
- In the Chart Design panel, click the icon next to Tab 1 in the Labels section of the Style tab.
- In the Set Query Conditions dialog box, configure the parameters.
- Query ConditionsWhen you click the icon next to Query Conditions to add a filter, the default name of the filter is Unnamed. You can enter a name for the filter.Note
- The name takes effect immediately after you enter the name and move the pointer.
- You can click the icon to hide a filter. After a filter is hidden, it is no longer displayed on the dashboard. However, the configuration is retained.
- You can click the icon to rename or delete a filter.
- Associated Charts and FieldsSelect the charts and fields that you want to associate with the filter bar. You can select Smart Field Selection. This feature automatically selects associated fields in the charts that are created based on the same dataset as the current chart. If a large number of charts exist, select the check boxes next to the charts that you want to associate with the filter bar.
- Query Condition ConfigurationParameters in the Query Condition Configuration pane vary based on the associated field. The following figure shows the parameters for a year-granularity time field. For more information about how to configure these parameters, see Configure the display type.
- Conditional Cascade ConfigurationAfter you configure conditional cascading, upper-level fields can control the display of lower-level fields. Conditions at the same level can affect each other. After you configure a global filter bar, tab-level filter bar, and chart-level filter bar, these filter bars are cascaded in the following descending order: global filter bar, tab-level filter bar, and chart-level filter bar. For more information about how to configure conditional cascading, see Configure conditional cascade.
- Query Conditions
After you configure a filter bar, you can set the display style of the filter bar on the Style tab.
- In the Template Settings section, you can select a defined template to configure the filter bar style.
Styles supported in Template Settings are Right-side Search Box, Drop-down List, and Tile.
Template Settings allows you to change the style of a filter bar with one click. After you change the style of a filter bar, you can still configure the style in the Basic Settings, Control style, or Field style section.
- Basic Settings:
- If you select Drop-down List or Tile in the Template Settings section, you can configure the Display Location, Hide query button, Expand All Filters By Default, and Control type parameters.
- If you select Right-side Search Box in the Template Settings section, you can configure Display Location.
- Set Condition Name Display Location in the Control style section.
- If you select Drop-down List or Tile in the Template Settings section, you can set Condition Name Display Location to Above or Left.
- If you select Right-side Search Box in the Template Settings section, you can set Condition Name Display Location to Left.
If Tab Layout is set to Right, Condition Name Display Location cannot be set to Right.
- Specify the value style and filter width for each field in the Field style section.
For the date and numeric fields, you can specify only the filter width. For the text fields, you can also set the value style to Drop-Down or Tile.