Search & Filters

Search filter

The instance list view provides a search bar to filter objects. The query is matched against the keyname, displayname, and raw data content of each instance.

Multiple words are combined with OR logic: an instance matches if any word is found in any of the three fields.

Allowed characters: letters, digits, ()_/.\: and spaces.

The current query is stored in the session per schema, so it persists when navigating away and returning to the same list.

RELATED: filter

The RELATED: keyword is a special filter that lists all instances of a schema that reference a specific object.

Format:

RELATED:<classname>:<keyname>

Example:

To list all app instances that reference the site object paris-01:

RELATED:site:paris-01

This filter is automatically applied when clicking the icon, count badge, or schema name in the Related Objects section at the bottom of an instance detail page.

The lowercase form related: is still accepted for backward compatibility.

Global searchbar

The top navbar has a global search field, available to any user with the p_data_access permission (granted to all authenticated users by the builtin default role). Press / anywhere on the page to focus it, then press Enter to see the results page.

Unlike the instance list search filter above, the searchbar query is a single term — no multi-word OR logic. It must be at least 3 characters.

Format:

<term>
SCHEMA:<term>

A SCHEMA: prefix (matched case-insensitively against a schema’s keyname) restricts the search to that one schema; an unrecognized prefix is treated as a literal part of the term instead.

The search runs, in order, against: keyname, displayname, the per-instance description field (if the schema defines one), the full raw data content, and finally schema names/displaynames themselves. An instance already matched by an earlier stage isn’t repeated in a later one. Each result only appears if the requesting user has read access to it (or, for a schema-name match, read access to the schema). Results are capped at SEARCHBAR_MAX_ANSWER (100) combined across all stages.