Filters and breadcrumbs

A filter is a set of conditions applied to a table to help you find and work with a subset of the data in that table.

You can apply, modify, create, and save filters. A hierarchical list of conditions at the top of the table — breadcrumbs — indicates the current filter.

Breadcrumbs offer a quick form of filter navigation. They are ordered from left to right. The left condition is the most general, and the right condition is the most specific. Clicking a breadcrumb removes all the conditions to its right. Clicking the condition separator (>) before a condition removes only that condition.

By default, a user with no roles cannot see the breadcrumbs or filter. Administrators can configure the ESS portal to allow unauthenticated users to see breadcrumbs and filters by using a script include. For more information on using script includes to suppress breadcrumbs and filters, see Use script includes to suppress filters and breadcrumbs .

Note: In List v3 split mode, you cannot edit the filter from the breadcrumb. Click the filter icon in the left pane to open the filter conditions in the right pane for editing.

Breadcrumbs for List v2 — Figure 1. Breadcrumbs, List v2

Breadcrumbs for List v3 — Figure 2. Breadcrumbs, List v3

Examples:

Clicking Priority = 2 removes the condition Category = Software and returns all active incidents with a priority of 2.
Clicking the condition separator (>) before Priority = 2 removes the condition Priority = 2 and returns all active incidents in the software category.
Clicking All removes all conditions and returns all incidents in the system.

Click a breadcrumb to refresh the list of records and show the latest information for those records.

Note: Clicking the New button in a filtered list automatically applies the same filter to the new record. For example, clicking New in the Resolved Incidents list opens a record preset with State set to Resolved. In a list filtered for active, priority 1 incidents, clicking New opens a record preset with Active selected and Priority set to 1 - Critical.

You can change the preset values on the form as needed. If there is a field you do not want to have populated in this way, you can add the following dictionary attribute to the field: ignore_filter_on_new=true.

Additional navigational functions are available when you right-click a breadcrumb.

Table 1. Breadcrumb right-click options
Option	Description
Open new window	Opens the results list for the breadcrumb in a new tab or window.
Copy URL	Copies the URL to the clipboard for the results list of the breadcrumb. Follow browser instructions if browser security measures restrict this function.
Copy query	Copies the encoded query to the clipboard for the breadcrumb. You can use this query in the URL of an instance or in the reference qualifier field of a dictionary entry. For example, if you are viewing a list of all active incidents with a high or medium impact, right-click the breadcrumb and copy the query active=true^impact=1^ORimpact=2. You can append this query to the end of the instance URL as follows: https://{instance_name}/incident_list.do?sysparm_query=active=true^impact=1^ORimpact=2 This selection is not available for the All breadcrumb.

Filters and breadcrumbs

A filter is a set of conditions applied to a table to help you find and work with a subset of the data in that table.

You can apply, modify, create, and save filters. A hierarchical list of conditions at the top of the table — breadcrumbs — indicates the current filter.

Note: In List v3 split mode, you cannot edit the filter from the breadcrumb. Click the filter icon in the left pane to open the filter conditions in the right pane for editing.

Examples:

Clicking Priority = 2 removes the condition Category = Software and returns all active incidents with a priority of 2.
Clicking the condition separator (>) before Priority = 2 removes the condition Priority = 2 and returns all active incidents in the software category.
Clicking All removes all conditions and returns all incidents in the system.

Click a breadcrumb to refresh the list of records and show the latest information for those records.

Additional navigational functions are available when you right-click a breadcrumb.

Table 1. Breadcrumb right-click options
Option	Description
Open new window	Opens the results list for the breadcrumb in a new tab or window.
Copy URL	Copies the URL to the clipboard for the results list of the breadcrumb. Follow browser instructions if browser security measures restrict this function.
Copy query	Copies the encoded query to the clipboard for the breadcrumb. You can use this query in the URL of an instance or in the reference qualifier field of a dictionary entry. For example, if you are viewing a list of all active incidents with a high or medium impact, right-click the breadcrumb and copy the query active=true^impact=1^ORimpact=2. You can append this query to the end of the instance URL as follows: https://{instance_name}/incident_list.do?sysparm_query=active=true^impact=1^ORimpact=2 This selection is not available for the All breadcrumb.

How search works:

Topics are ranked in search results by how closely they match your search terms

Filters and breadcrumbs

Filters and breadcrumbs

On this page

Filters and breadcrumbs

Filters and breadcrumbs

Log in to personalize your search results and subscribe to topics