Hol das Beste aus der erweiterten Suche heraus, indem du erfährst, wie du deine JQL-Abfrage strukturierst. Eine einfache Abfrage in JQL (auch "Klausel" genannt) besteht aus einem Feld, gefolgt von einem Operator, gefolgt von einem oder mehreren Werten oder Funktionen.
| Beschreibung |
|---|
Felder | Ein Feld in JQL ist ein Wort, das ein Jira-Feld darstellt (oder ein benutzerdefiniertes Feld, das bereits in Jira definiert wurde). Hier erfährst du mehr über die Verwendung von Feldern für die erweiterte Suche. |
|---|
Operatoren | Ein Operator in JQL ist ein oder mehrere Symbole oder Wörter, die den Wert eines Feldes auf der linken Seite mit einem oder mehreren Werten (oder Funktionen) auf der rechten Seite vergleichen, so dass nur wahre Ergebnisse durch die Klausel abgerufen werden. Einige Operatoren können das Schlüsselwort NICHT (NOT) verwenden. Hier erfährst du mehr über die Verwendung von Operatoren für die erweiterte Suche. |
|---|
Schlüsselwort | Ein Schlüsselwort in JQL ist ein Wort oder eine Phrase, die einen der folgenden Punkte erfüllt: - zwei oder mehr Klauseln miteinander verbindet, um eine komplexe JQL-Abfrage zu bilden
- ändert die Logik einer oder mehrerer Klauseln
- verändert die Logik von Operatoren
- hat eine explizite Definition in einer JQL-Abfrage
- führt eine bestimmte Funktion aus, die die Ergebnisse einer JQL-Abfrage verändert.
Hier erfährst du mehr über die Verwendung von Schlüsselwörtern für die erweiterte Suche. |
|---|
Funktionen | Eine Funktion in JQL erscheint als ein Wort, gefolgt von Klammern, die einen oder mehrere explizite Werte oder Jira-Felder enthalten können. Eine Funktion führt eine Berechnung entweder mit bestimmten Jira-Daten oder dem Inhalt der Funktion in Klammern durch, so dass nur wahre Ergebnisse von der Funktion und dann wieder von der Klausel, in der die Funktion verwendet wird, abgerufen werden. Hier erfährst du mehr über die Verwendung von Funktionen für die erweiterte Suche. |
|---|
Zum Beispiel:
Diese Abfrage findet alle Vorgänge im Projekt "TEST". Sie verwendet das Feld "project", den Operator EQUALS und den Wert "TEST".
Eine komplexere Abfrage könnte wie folgt aussehen:
project = "TEST" AND assignee = currentuser()
Diese Abfrage findet alle Vorgänge im Projekt "TEST", bei denen die zugewiesene Person der aktuell eingeloggte Benutzer ist. Sie verwendet das Feld "project", den Operator EQUALS, den Wert "TEST", das Schlüsselwort "AND" und die Funktion "currentuser()".
Den Vorrang von Operatoren festlegen
Du kannst Klammern in komplexen JQL-Anweisungen verwenden, um den Vorrang von Operatoren zu erzwingen.
Wenn du zum Beispiel alle gelösten Vorgänge im Projekt "SysAdmin" sowie alle Vorgänge (beliebiger Status, beliebiges Projekt), die dem Systemadministrator (bobsmith) zugewiesen sind, finden möchtest, kannst du Klammern verwenden, um den Vorrang der booleschen Operatoren in deiner Abfrage zu erzwingen, z.B.
(status=resolved AND project=SysAdmin) OR assignee=bobsmith
Eingeschränkte Wörter und Zeichen
Reservierte Zeichen
JQL hat eine Liste mit reservierten Zeichen:
space (" ") + . , ; ? | * / % ^ $ # @ [ ]
Wenn du diese Zeichen in Abfragen verwenden willst, musst du
- sie in Anführungszeichen einschließen (du kannst entweder einfache Anführungszeichen (') oder doppelte Anführungszeichen (") verwenden);
und, wenn du ein Textfeld durchsuchst und das Zeichen auf der Liste der reservierten Zeichen für Textsuchen steht, - zwei Backslashes voranstellen.
Zum Beispiel:
Reservierte Wörter
JQL hat auch eine Liste von reservierten Wörtern. Diese Wörter müssen von Anführungszeichen (einfach oder doppelt) umgeben sein, wenn du sie in Abfragen verwenden willst:
"a", "an", "abort", "access", "add", "after", "alias", "all", "alter", "and", "any", "are", "as", "asc", "at", "audit", "avg", "be", "before", "begin", "between", "boolean", "break", "but", "by", "byte", "catch", "cf", "char", "character", "check", "checkpoint", "collate", "collation", "column", "commit", "connect", "continue", "count", "create", "current", "date", "decimal", "declare", "decrement", "default", "defaults", "define", "delete", "delimiter", "desc", "difference", "distinct", "divide", "do", "double", "drop", "else", "empty", "encoding", "end", "equals", "escape", "exclusive", "exec", "execute", "exists", "explain", "false", "fetch", "file", "field", "first", "float", "for", "from", "function", "go", "goto", "grant", "greater", "group", "having", "identified", "if", "immediate", "in", "increment", "index", "initial", "inner", "inout", "input", "insert", "int", "integer", "intersect", "intersection", "into", "is", "isempty", "isnull", "it", "join", "last", "left", "less", "like", "limit", "lock", "long", "max", "min", "minus", "mode", "modify", "modulo", "more", "multiply", "next", "no", "noaudit", "not", "notin", "nowait", "null", "number", "object", "of", "on", "option", "or", "order", "outer", "output", "power", "previous", "prior", "privileges", "public", "raise", "raw", "remainder", "rename", "resource", "return", "returns", "revoke", "right", "row", "rowid", "rownum", "rows", "select", "session", "set", "share", "size", "sqrt", "start", "strict", "string", "subtract", "such", "sum", "synonym", "table", "that", "the", "their", "then", "there", "these", "they", "this", "to", "trans", "transaction", "trigger", "true", "uid", "union", "unique", "update", "user", "validate", "values", "view", "was", "when", "whenever", "where", "while", "will", "with"
Eine Textsuche durchführen
Du kannst die Textsuchfunktionen nutzen, wenn du mit dem Operator CONTAINS in den folgenden Feldern suchst:
Zusammenfassung, Beschreibung, Umgebung, Kommentare und benutzerdefinierte Felder, die die "Freitextsuche" verwenden
Hier erfährst du mehr über die Verwendung der Such-Syntax für Textfelder
