List Filter Visuals

List filter visuals are based on a single attribute, metric, or time field in a data source. These visuals list the values of the selected data source field. They are supported by all Composerdata connectors.

You can select one or more of the field values in the list filter visual to quickly apply a filter to other visuals in the dashboard that subscribe to a cross-visual filter for the field. Regular visual filters can also be applied to a list filter visual itself. Filters applied to the list filter visual are saved when the visual or dashboard are saved. However, any filtering performed using the list filter visual is not saved when the dashboard is saved and any data selections made on the list filter visual are not saved.

A list filter visual cannot be converted to a different style, as other visual styles can using the visual sidebar menu. Likewise, other visual styles cannot be converted to the list filter visual style.

This topic describes:

• Configure Default List Filter Visual Settings for a Data Source
• Configure Settings for a Specific List Filter Visual

For information on setting even time intervals, see Even Time Intervals.

Configure Default List Filter Visual Settings for a Data Source

To configure the default settings for list filter visuals for a data source configuration:

1. Edit the appropriate data source configuration. See Edit a Data Source Configuration.

2. Select the Visuals tab in the data source configuration wizard.

3. On the Standard subtab of the Visuals tab, select List Filter.

   If you want to be able to display the data collected by this data source configuration as a list filter visual, make sure the List Filter checkbox is selected.

   Default list filter visual settings appear on the right side of the page.

4. Configure the default settings as follows:

   Setting	Description
   Display Value	Select an attribute, metric, or time field for the list filter visual. If you select a time field, a date and time granularity box appears to the right of the field. Select the date and time granularity used to group the data. Valid granularity options are Millisecond, Second, Minute, Hour, Day, Week, Month, Quarter, or Year. If some of these granularity options do not appear, verify that the granularity specified for this field on the Fields tab of the data source definition is set at the correct granularity level. The refinement level of the field data in a data store defines the minimum level of granularity that should be set for the field. Specifying granularity for a field that is lower than the refinement level of the field data will not produce a visual with data grouped at the requested lower level. For example, if a field's data is stored in hours, requesting the granularity of that data lower than hours will produce the values up to the hour level, and the more detailed level information will be zeros (i.e., 0 minutes, 0 seconds, and 0 milliseconds).
   Display Value Limit	Specify the maximum number of values to display in a list filter visual.
   Display Value Sort	By default, the field selected is the same as the field selected for Display Value. A default sorting order is also selected, but you can select a different one. Valid values for the sorting order vary, based on the field that is selected.

5. Select .

Configure Settings for a Specific List Filter Visual

To change the settings for a specific list filter visual:

1. Edit the list filter visual you want to modify. See Edit Visuals.

2. If you are editing the visual in a dashboard, select Edit Visual from the visual drop-down menu. The sidebar menu for the visual appears.

   If you are editing the visual from the Visual Gallery, the sidebar appears to the right of the visual.

3. Select on the sidebar menu. The List Filter Settings sidebar for the visual appears.

   

4. Alter the settings as needed:

   Setting	Description
   Display Column	Select to select a different data source field for the list filter visual.
   Display Style	Only the Fixed List display style is available. It is automatically selected.
   Number of Selections	Specify whether only one or multiple data values can be selected in the visual. Select Single to allow users to select only one data value; select Multiple to allow users to select more than one value. Multiple is not allowed for time fields. The default is Single.
   "No Selection" Label	Supply a label for the visual option when no data is selected. The default is None. This label is only available when Number of Selections is set to Single.

5. Select to save the dashboard and the visual with its updated settings.