Filter Pill Component

Filter Pill Component

The Filter Pill component inserts a standard filter pill in List views. Filter pills provide an easy method for filtering board data.

The Filter Pill component is supported in the List view.

Example of Three Filter Pills with Optional Count Expressions

Filter Pill Example

To create filter pills

  1. Set up at least one view filter in DesignStudio. For information about building a view filter in DesignStudio, see Build a View Filter For a Display View.

  2. In a List view, in the Components tray, under Data Visualization, drag a Filter Pill component onto the canvas. The Filter Pill Settings window opens.

    Filter Pill Settings

  3. Configure the filter pill using these settings.

Filter Pill Settings fields
Field Description Procedure

Label

A unique identifier that briefly describes the component in the user interface.

Enter a unique name that will appear on the filter pill on the board. For example, to create a filter pill for a shelter status of open, enter Open.

View Filter Name

The pre-existing filter to be used for the filter pill.

Select from the list of pre-defined filters created in DesignStudio. See Build a View Filter For a Display View for details.

Filter Group

A group of filters that allows you to apply multiple filters at once.

Enter the name of the filter group.

By default, a board user can only apply one filter pill at a time. To allow multiple filter pills to be used simultaneously, enter the same filter group name for each filter pill. For example, to create a shelters board with status filters of Open, Closed, and Full, use the same filter group name (such as filterStatus) for each filter pill. Users can filter on multiple statuses at once when viewing the shelters board.

Color Choice

 

The color for the background of the filter pill when it is selected.

Select one of the following options and then do the associated action.

  • Predefined: Below Color Choice, select one of the example color squares.

  • Custom: Below Color Choice, click the square, and then use the color picker to select a color.
Expression Name

The expression you want to use for the filter pill. If you choose not to include an expression, the filter pill displays the pill only, without running the expression and has no effect on the data on the board. For information about expressions, see <expression> in the WebEOC Admin Help Center.

Enter the expression name.

Expression

The expression that runs when the user clicks the filter pill. For information about expressions, see Expressions in the WebEOC Admin Help Center.

Enter the expression.

Board Level Filters

(Data tab)

Whether view filters applied at the board level are respected when calculating an expression.

Select the checkbox to use board-level filters.

See Board, Group, and User Filters below for details.

Group Level Filters

Whether view filters applied at the group level are respected when calculating an expression.

Select the checkbox to use group-level filters.

See Board, Group, and User Filters below for details.

User Level Filters

Whether view filters applied at the user level are respected when calculating an expression.

Select the checkbox to use user-level filters.

See Board, Group, and User Filters below for details.

Board, Group, and User Level Filters

When using expressions with the filter pill component, you can set the expression to run on data filtered at different levels. These levels can be combined. For example, you can set an expression to run on data filtered at both the board and group levels.

If you select the Board Level Filters checkbox, data will be filtered using the active filters set at the board’s view filter level, visible in Configure mode. See Build a View Filter For a Display View for details.

Example In this example, the board-level filter of Removed is applied to the board data before an expression runs.
View filter to be ued with board level filters

If you select the Group Level Filters checkbox, data will be filtered using the view filters set for the feature group assigned to the board in WebEOC.

Example For example, the Shelters board is assigned to the Shelters – Admin feature group. The board’s view filter for that group is set on the Edit Board window. In this example, the Active Requests filter will be applied to the board data before the expression runs for all members of this feature group.
Group level Filters applied before expression runs

If you select the User Level Filters checkbox, data will be filtered using any filters the user has set while using the board in WebEOC. Filters could include selections the user makes in dropdowns, or selections made using the Filter button.

Example In this example, the Full filter the user selected will be applied to the board data before the expression runs.
User level filter applied before the expression runs

Actions Toolbar

The following actions are available when you select any component on the canvas in the Board Workspace.

Actions descriptions
Icon Name Description Procedure
Settings Icon

Settings

Opens the Settings dialog.

You can modify the component’s settings, such as label, database field name, help text, style, and conditional settings.

  1. In Design mode, click the component on the canvas. A toolbar appears on the top right.

  2. Click the Settings icon.

  3. Modify the fields as needed.

  4. Click Done.
Move Icon

Move

 

This icon is not used.

To move the component, click and drag it to its new location.
Copy Icon

Clone

Copies the current component and its settings, then pastes it after the current component.

  1. In Design mode, click the component on the canvas. A toolbar appears on the top right.

  2. Click the Clone icon.
    The component's Settings dialog opens.

  3. Edit the settings for the cloned component.

  4. Click Done.
Delete Icon

Delete

Deletes the selected component.

  1. In Design mode, click the component on the canvas. A toolbar appears on the top right.

  2. Click the Delete icon.