Filterausdrücke schreiben

Der vollständige Sprachumfang für Filterbedingungen — nach Typ, Tags, Namen, Eigenschaften und Datum filtern und alles mit und/oder/nicht kombinieren.

Meistens bauen Sie einen Filter in der App: Öffnen Sie den Filter-Bereich im Modellnavigator, fügen Sie Bedingungen hinzu, und der Baum reduziert sich auf das Passende. Dieser Artikel ist für den anderen Fall — den Ausdruck eines Filters direkt zu schreiben, so wie es der KI-Assistent und die API tun.

Ein Ausdruck ist ein kleines Stück JSON. Er ist entweder eine Bedingung oder mehrere Bedingungen, verknüpft mit und, oder und nicht.

Die einfachsten

{"OfType": {"type_id": "Risk"}}

Trifft auf jedes Element eines Typs zu. Sie können den Typ benennen oder seine ID angeben.

{"HasTag": {"tag": "critical"}}

Trifft auf Elemente zu, die einen Tag tragen. Groß- und Kleinschreibung wird ignoriert, critical und Critical sind also derselbe Tag.

"All"

Trifft auf alles zu. "None" trifft auf nichts zu — gelegentlich nützlich als Ausgangspunkt, den Sie später füllen.

Nach Tags filtern

Bedingung	Trifft zu auf
{"HasTag": {"tag": "critical"}}	Hat genau diesen Tag
{"HasAnyTag": {"tags": ["critical", "urgent"]}}	Hat mindestens einen davon
{"HasAllTags": {"tags": ["critical", "reviewed"]}}	Hat jeden einzelnen davon

Nach Namen und Beschreibungen filtern

{"NameMatches": {"operator": "Contains", "value": "payment"}}
{"DescriptionMatches": {"operator": "Contains", "value": "deprecated"}}

Der Operator ist einer von Contains, Equals, StartsWith, EndsWith oder Regex.

NameMatches arbeitet auf dem, was die jeweilige Elementart ihren Namen nennt — die Bezeichnung eines Elements, der Name eines Typs, eines Diagramms oder eines Ordners.

Nach einer Eigenschaft filtern

{"PropertyMatches": {"property_name": "status", "operator": "Equals", "value": "open"}}

Verwenden Sie den Namen der Eigenschaft, so wie er im Eigenschaften-Panel steht — nicht ihre interne ID.

Operatoren: Equals, NotEquals, Contains, GreaterThan, LessThan, GreaterOrEqual, LessOrEqual, IsEmpty, IsNotEmpty.

IsEmpty und IsNotEmpty ignorieren den Wert. So finden Sie alles, dem noch ein Verantwortlicher fehlt:

{"PropertyMatches": {"property_name": "owner", "operator": "IsEmpty", "value": ""}}

Nach Datum filtern

{"UpdatedDate": {"operator": {"InLast": {"days": 7}}, "value": ""}}
{"CreatedDate": {"operator": "Before", "value": "2026-01-01"}}

CreatedDate und UpdatedDate nehmen beide Before, After, Between (mit einem end-Datum) oder InLast (mit einer Anzahl Tage). Daten werden als ISO 8601 geschrieben — 2026-01-01.

Alles, was diese Woche angefasst wurde ist {"InLast": {"days": 7}} auf UpdatedDate.

Nach Ordner oder ID filtern

{"InFolder": {"folder_id": "folder-uuid", "recursive": true}}
{"HasId": {"ids": ["node-uuid", "RSK-4"]}}

recursive: true schließt auch alles in Unterordnern ein; false bleibt in diesem einen Ordner.

HasId greift bestimmte Elemente per ID oder Auto-ID heraus — praktisch für eine von Hand zusammengestellte Auswahl.

Einen anderen Filter wiederverwenden

{"FilterRef": {"filter_id": "filter-uuid"}}

Trifft auf das zu, worauf jener gespeicherte Filter zutrifft. So bauen Sie einen breiten Filter einmal und verengen ihn in mehrere Richtungen, ohne sich zu wiederholen. Wurde der referenzierte Filter gelöscht, trifft der Ausdruck einfach auf nichts zu.

Bedingungen kombinieren

{"And": [
  {"OfType": {"type_id": "Risk"}},
  {"HasTag": {"tag": "critical"}}
]}

And verlangt, dass jede Bedingung zutrifft, Or mindestens eine, und Not kehrt eine einzelne Bedingung um:

{"And": [
  {"OfType": {"type_id": "Service"}},
  {"Not": {"HasTag": {"tag": "deprecated"}}}
]}

Sie lassen sich verschachteln, sodass Sie sagen können: kritische oder dringende Risiken ohne Verantwortlichen:

{"And": [
  {"OfType": {"type_id": "Risk"}},
  {"HasAnyTag": {"tags": ["critical", "urgent"]}},
  {"PropertyMatches": {"property_name": "owner", "operator": "IsEmpty", "value": ""}}
]}

Gut zu wissen

• Bedingungen gelten nur dort, wo sie sinnvoll sind. Ein Ordner hat einen Namen, aber keine Eigenschaften — eine Eigenschaftsbedingung trifft auf ihn also schlicht nicht zu. Das ist vor allem innerhalb von Not wichtig: Die Umkehrung gilt nur für die Elementarten, auf die die Bedingung überhaupt anwendbar ist.
• Ein falsch geschriebener Typ- oder Eigenschaftsname trifft still auf nichts zu. Es gibt keine Fehlermeldung, nur ein leeres Ergebnis. Kommt ein Filter leer zurück, obwohl Sie Treffer erwartet haben, prüfen Sie zuerst die Schreibweise im Eigenschaften-Panel.
• Einen Filter über die API zu ändern ersetzt den ganzen Ausdruck. update_filter führt Ihre Änderung nicht mit dem Bestehenden zusammen — schicken Sie also den vollständigen Ausdruck.
• Filter sind selbst Elemente. Sie liegen in Ordnern, tragen Tags und lassen sich übersetzen — ihr Name ist also eine Überlegung wert.