Jira Cloud Dokumentation

JQL-Operatoren



Diese Seite beschreibt Informationen über Operatoren, die für die erweiterte Suche verwendet werden.

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 NOT verwenden.


Equals (=)

Der Operator "=" wird verwendet, um nach Vorgängen zu suchen, bei denen der Wert des angegebenen Feldes genau mit dem angegebenen Wert übereinstimmt. (Hinweis: Kann nicht mit Textfeldern verwendet werden; siehe stattdessen den Operator CONTAINS).

Um Vorgänge zu finden, bei denen der Wert eines bestimmten Feldes genau mit mehreren Werten übereinstimmt, verwende mehrere "="-Anweisungen mit dem AND-Operator.


Beispiele


  • Finde alle Vorgänge, die von John Smith erstellt wurden:
reporter = "John Smith"
  • Finde alle Vorgänge, die von John Smith erstellt wurden, dessen Atlassian-Kontonummer abcde-12345-fedcba ist:
reporter = "abcde-12345-fedcba"


Not equals (!=)

Der Operator "!=" wird verwendet, um nach Vorgängen zu suchen, bei denen der Wert des angegebenen Feldes nicht mit dem angegebenen Wert übereinstimmt. (Hinweis: Kann nicht mit Textfeldern verwendet werden; siehe stattdessen den DOES NOT CONTAIN ("!~") Operator).


Beachte, dass die Eingabe von field != value dasselbe ist wie die Eingabe von NOT field = value, und dass field != EMPTY dasselbe ist wie field IS_NOT EMPTY.

Der Operator "!=" passt nicht auf ein Feld, das keinen Wert hat (d.h. ein leeres Feld). Beispiel: component != fred findet nur Vorgänge, die eine Komponente haben und die Komponente ist nicht "fred". Um Vorgänge zu finden, die eine andere Komponente als "fred" oder keine Komponente haben, musst du eingeben: component != fred or component is empty.

Beispiele


  • Finde alle Vorgänge, die der Atlassian-Kontonummer eines beliebigen Benutzers zugewiesen sind, außer der von John Smith:
not assignee = abcde-12345-fedcba

oder

assignee != abcde-12345-fedcba
  • Finde alle Vorgänge, die nicht der Atlassian-Konto-ID von John Smith zugewiesen sind
assignee != abcde-12345-fedcba or assignee is empty
  • Finde alle Vorgänge, die von mir gemeldet wurden, mir aber nicht zugewiesen sind:
reporter = currentUser() and assignee != currentUser()
  • Finde alle Vorgänge, bei denen der Autor oder die zugewiesene Person eine andere Person als John Smith ist:
assignee != "John Smith" or reporter != "John Smith"
  • Finde alle Vorgänge, die nicht nicht zugewiesen sind:
assignee is not empty

oder 

assignee != null


Greater than (>)

Der Operator ">" wird verwendet, um nach Vorgängen zu suchen, bei denen der Wert des angegebenen Feldes größer ist als der angegebene Wert.


Beachte, dass der Operator ">" nur bei Feldern verwendet werden kann, die eine Reihenfolge unterstützen (z. B. Datums- und Versionsfelder), und nicht bei Textfeldern. Welche Operatoren für ein Feld unterstützt werden, kannst du in der Feldreferenz nachlesen.

Beispiele


  • Finde alle Vorgänge mit mehr als 4 Stimmen:
votes > 4
  • Finde alle überfälligen Vorgänge:
duedate < now() and resolution is empty
  • Finde alle Vorgänge, deren Priorität höher als "Normal" ist:
priority > normal


Greater than equals (>=)

Der Operator ">=" wird verwendet, um nach Vorgängen zu suchen, bei denen der Wert des angegebenen Feldes größer oder gleich dem angegebenen Wert ist.


Beachte, dass der Operator ">=" nur bei Feldern verwendet werden kann, die eine Reihenfolge unterstützen (z. B. Datums- und Versionsfelder), und dass er nicht bei Textfeldern verwendet werden kann. Welche Operatoren für ein Feld unterstützt werden, kannst du in der Feldreferenz nachlesen.

Beispiele


  • Finde alle Vorgänge mit 4 oder mehr Stimmen:
votes >= 4
  • Finde alle Vorgänge, die am oder nach dem 31.12.2008 fällig sind:
duedate >= "2008/12/31"
  • Finde alle Vorgänge, die in den letzten fünf Tagen erstellt wurden:
created >= "-5d"


Less than (<)

Mit dem Operator "<" wird nach Vorgängen gesucht, bei denen der Wert des angegebenen Feldes kleiner als der angegebene Wert ist.


Beachte, dass der Operator "<" nur bei Feldern verwendet werden kann, die eine Reihenfolge unterstützen (z. B. Datums- und Versionsfelder), und nicht bei Textfeldern. Welche Operatoren für ein Feld unterstützt werden, kannst du in der Feldreferenz nachlesen.

Beispiele


  • Finde alle Vorgänge mit weniger als 4 Stimmen:
votes < 4


Less than equals (<=)

Mit dem Operator "<=" wird nach Vorgängen gesucht, bei denen der Wert des angegebenen Feldes kleiner oder gleich dem angegebenen Wert ist.


Beachte, dass der Operator "<=" nur bei Feldern verwendet werden kann, die eine Reihenfolge unterstützen (z. B. Datums- und Versionsfelder), und nicht bei Textfeldern. Welche Operatoren für ein Feld unterstützt werden, kannst du in der Feldreferenz nachlesen.

Beispiele


  • Finde alle Vorgänge mit 4 oder weniger Stimmen:
votes <= 4
  • Finde alle Vorgänge, die im letzten Monat (30 Tage) nicht aktualisiert wurden:
updated <= "-4w 2d"


IN

Der Operator "IN" wird verwendet, um Vorgänge zu suchen, bei denen der Wert des angegebenen Feldes einer von mehreren angegebenen Werten ist. Die Werte werden als kommagetrennte Liste angegeben, die von Klammern umgeben ist.

Die Verwendung von "IN" entspricht der Verwendung mehrerer EQUALS (=)-Anweisungen, ist aber kürzer und praktischer. Die Eingabe von reporter IN (tom, jane, harry) ist dasselbe wie die Eingabe von reporter = "tom" OR reporter = "jane" OR reporter = "harry".


Beispiele


  • Finde alle Vorgänge, die entweder von jsmith oder jbrown oder jjones erstellt wurden:
reporter in (jsmith,jbrown,jjones)
  • Finde alle Vorgänge, die von John Smith, Jim Brown oder Jared Jones erstellt wurden, deren Atlassian-Konto-IDs abcde-12345-fedcba oder fedcb-12345-edcba bzw. cdefb-67895-cbaed sind:
reporter in (abcde-12345-fedcba,fedcb-12345-edcba,cdefb-67895-cbaed)
  • Finde alle Vorgänge, bei denen der Autor oder die zugewiesene Person entweder Jack oder Jill ist:
reporter in (Jack,Jill) or assignee in (Jack,Jill)
  • Finde alle Vorgänge, bei denen der Autor oder die zugewiesene Person entweder Jack oder Jill ist, deren Atlassian-Konto-IDs abcde-12345-fedcba bzw. cdefb-67895-cbaed lauten:
reporter in (abcde-12345-fedcba,cdefb-67895-cbaed) or assignee in (abcde-12345-fedcba,cdefb-67895-cbaed)
  • Finde alle Vorgänge in Version 3.14 oder Version 4.2:
affectedVersion in ("3.14", "4.2")


NOT IN

Der Operator "NOT IN" wird verwendet, um nach Vorgängen zu suchen, bei denen der Wert des angegebenen Feldes nicht einer von mehreren angegebenen Werten ist.

Die Verwendung von "NOT IN" entspricht der Verwendung mehrerer NOT_EQUALS (!=) Anweisungen, ist aber kürzer und bequemer. Das heißt, wenn du reporter NOT IN (tom, jane, harry) eingibst, ist das dasselbe wie wenn du reporter != "tom" AND reporter != "jane" AND reporter != "harry" eingibst.

Der Operator "NOT IN" passt nicht zu einem Feld, das keinen Wert hat (d. h. ein leeres Feld). Zum Beispiel findet assignee not in (jack,jill) nur Vorgänge, die eine zugewiesene Person haben und die zugewiesene Person nicht "jack" oder "jill" ist. Um Vorgänge zu finden, die einer anderen Person als "jack" oder "jill" zugewiesen sind oder die nicht zugewiesen sind, musst du eingeben: assignee not in (jack,jill) or assignee is empty.


Beispiele


  • Finde alle Vorgänge, bei denen die zugewiesene Person eine andere als Jack, Jill oder John ist:
assignee not in (Jack,Jill,John)
  • Finde alle Vorgänge, bei denen die zugewiesene Person eine andere als Jack, Jill oder John ist, deren Atlassian-Konto-IDs abcde-12345-fedcba oder fedcb-12345-edcba bzw. cdefb-67895-cbaed lauten:
assignee not in (abcde-12345-fedcba,fedcb-12345-edcba,cdefb-67895-cbaed)
  • Finde alle Vorgänge, bei denen die zugewiesene Person nicht Jack, Jill oder John ist:
assignee not in (Jack,Jill,John) or assignee is empty
  • Finde alle Vorgänge, bei denen die Zugewiesene Person nicht Jack, Jill oder John ist, deren Atlassian-Konto-IDs abcde-12345-fedcba oder fedcb-12345-edcba bzw. cdefb-67895-cbaed lauten:
assignee not in (abcde-12345-fedcba,fedcb-12345-edcba,cdefb-67895-cbaed) or assignee is empty
  • Finde alle Vorgänge, bei denen die FixVersion nicht 'A', 'B', 'C' oder 'D' ist:
FixVersion not in (A, B, C, D)
  • Finde alle Vorgänge, bei denen die FixVersion nicht 'A', 'B', 'C' oder 'D' ist oder nicht angegeben wurde:
FixVersion not in (A, B, C, D) or FixVersion is empty


CONTAINS (~)

Der Operator "~" wird verwendet, um nach Vorgängen zu suchen, bei denen der Wert des angegebenen Feldes mit dem angegebenen Wert übereinstimmt (entweder eine genaue Übereinstimmung oder eine "unscharfe" Übereinstimmung - siehe Beispiele unten). Nur für Textfelder geeignet, d. h:


  • Zusammenfassung
  • Beschreibung
  • Umgebung
  • Kommentare
  • benutzerdefinierte Felder, die den "Free Text Searcher" verwenden; dazu gehören benutzerdefinierte Felder der folgenden eingebauten benutzerdefinierten Feldtypen
    • Freies Textfeld (unbegrenzter Text)
    • Textfeld (< 255 Zeichen)
    • Nur-Lese-Textfeld


Das JQL-Feld "text" wie in text ~ "some words" durchsucht die Zusammenfassung, Beschreibung, Umgebung und Kommentare eines Vorgangs. Es durchsucht auch alle benutzerdefinierten Textfelder. Wenn du viele benutzerdefinierte Textfelder hast, kannst du die Leistung deiner Abfragen verbessern, indem du in bestimmten Feldern suchst, z. B. 
Summary ~ "some words" OR Description ~ "some words"


Hinweis: Wenn du den Operator "~" verwendest, kann der Wert auf der rechten Seite des Operators mit der Jira-Syntax für die Textsuche angegeben werden.

Beispiele


  • Finde alle Vorgänge, in deren Zusammenfassung das Wort "win" (oder einfache Ableitungen dieses Wortes, wie "wins") vorkommt:
summary ~ win
  • Finde alle Vorgänge, bei denen die Zusammenfassung einen Platzhalter für das Wort "win" enthält:
summary ~ "win*"
  • Finde alle Vorgänge, bei denen die Zusammenfassung das Wort "issue " und das Wort "collector " enthält:
summary ~ "issue collector"
  • Finde alle Vorgänge, bei denen die Zusammenfassung den exakten Ausdruck "full screen" enthält (siehe Such-Syntax für Textfelder, um zu erfahren, wie Anführungszeichen und andere Sonderzeichen vermieden werden können):
summary ~ "\"full screen\""


DOES NOT CONTAIN (!~)

Der Operator "!~" wird verwendet, um nach Vorgängen zu suchen, bei denen der Wert des angegebenen Feldes keine "unscharfe" Übereinstimmung mit dem angegebenen Wert ist. Nur für Textfelder geeignet, d.h.:


  • Zusammenfassung
  • Beschreibung
  • Umgebung
  • Kommentar*
  • benutzerdefinierte Felder, die den "Free Text Searcher" verwenden; dazu gehören benutzerdefinierte Felder der folgenden eingebauten benutzerdefinierten Feldtypen
    • Freies Textfeld (unbegrenzter Text)
    • Textfeld (< 255 Zeichen)
    • Nur-Lese-Textfeld


*Wenn der Vorgang mehr als einen Kommentar enthält, schlägt dieser Operator fehl, da alle Kommentare in die Suche einbezogen werden.

Das JQL-Feld "text" wie in text ~ "some words" durchsucht die Zusammenfassung, Beschreibung, Umgebung und Kommentare eines Vorgangs. Es durchsucht auch alle benutzerdefinierten Textfelder. Wenn du viele benutzerdefinierte Textfelder hast, kannst du die Leistung deiner Abfragen verbessern, indem du in bestimmten Feldern suchst, z. B. 
Summary ~ "some words" OR Description ~ "some words"


Hinweis: Wenn du den Operator "!~" verwendest, kann der Wert auf der rechten Seite des Operators mit der Jira Textsuch-Syntax angegeben werden.

Beispiele


  • Finde alle Vorgänge, in deren Zusammenfassung das Wort "run" (oder Ableitungen dieses Wortes, wie "running" oder "ran") nicht vorkommt:
summary !~ run


IS

Der Operator "IS" kann nur mit EMPTY oder NULL verwendet werden. Das heißt, er wird verwendet, um nach Vorgängen zu suchen, bei denen das angegebene Feld keinen Wert hat.


Beachte, dass nicht alle Felder mit diesem Operator kompatibel sind; siehe die einzelnen Feldreferenzen für Details.

Beispiele


  • Finde alle Vorgänge, die keine Lösungsversion haben:
fixVersion is empty

oder

fixVersion is null


IS NOT

Der Operator "IS NOT" kann nur mit EMPTY oder NULL verwendet werden. Das heißt, er wird verwendet, um nach Vorgängen zu suchen, bei denen das angegebene Feld einen Wert hat.


Beachte, dass nicht alle Felder mit diesem Operator kompatibel sind; siehe die einzelnen Feldreferenzen für Details.

Beispiele


  • Finde alle Vorgänge, die eine oder mehrere Stimmen haben:
votes is not empty

oder

votes is not null


WAS

Der "WAS"-Operator wird verwendet, um Vorgänge zu finden, die aktuell den angegebenen Wert für das angegebene Feld haben oder vorher hatten.

Dieser Operator hat die folgenden optionalen Prädikate:


  • AFTER "date"
  • BEFORE "date"
  • BY "username" or BY (username1,username2)
  • DURING ("date1","date2")
  • ON "date"


Dieser Operator stimmt mit dem Wertnamen überein (z.B. "Resolved"), der zu dem Zeitpunkt, als das Feld geändert wurde, in deinem System konfiguriert war. Dieser Operator stimmt auch mit der Wert-ID überein, die mit diesem Wertnamen verknüpft ist, d.h. er stimmt sowohl mit "4" als auch mit "Resolved" überein.


Dieser Operator kann nur mit den Feldern Zugewiesene Person, Lösungsversion, Priorität, Autor, Lösung und Status verwendet werden.

Beispiele


  • Finde Vorgänge, die derzeit den Status "In Arbeit" haben oder hatten:
status WAS "In Progress"
  • Finde Vorgänge, die von Joe Smith vor dem 2. Februar behoben wurden:
status WAS "Resolved" BY jsmith BEFORE "2019/02/02"
  • Finde Vorgänge, die von Joe Smith, dessen Atlassian Account ID abcde-12345-fedcba ist, vor dem 2. Februar gelöst wurden:
status WAS "Resolved" BY abcde-12345-fedcba BEFORE "2019/02/02"
  • Finde Vorgänge, die von Joe Smith im Jahr 2010 gelöst wurden:
status WAS "Resolved" BY jsmith DURING ("2010/01/01","2011/01/01")


  • Finde Vorgänge, die von Joe Smith, dessen Atlassian-Konto-ID abcde-12345-fedcba lautet, im Jahr 2010 gelöst wurden:
status WAS "Resolved" BY abcde-12345-fedcba DURING ("2010/01/01","2011/01/01")
  • Finde Vorgänge, die von Joe Smith oder Sam Rogen im Jahr 2019 gelöst wurden:
status WAS "Resolved" BY (jsmith,srogen) DURING ("2019/01/01","2020/01/01")


WAS IN

Der Operator "WAS IN" wird verwendet, um Vorgänge zu finden, die einen von mehreren angegebenen Werten für das angegebene Feld haben oder früher hatten. Die Werte werden als kommagetrennte Liste angegeben, die von Klammern umgeben ist.

Die Verwendung von "WAS IN" entspricht der Verwendung mehrerer WAS-Anweisungen, ist aber kürzer und praktischer. Das heißt, die Eingabe von status WAS IN ('Resolved', 'Closed') ist dasselbe wie die Eingabe von status WAS "Resolved" OR status WAS "Closed".

Dieser Operator hat die folgenden optionalen Prädikate:


  • AFTER "date"
  • BEFORE "date"
  • BY "username"
  • DURING ("date1","date2")
  • ON "date"


Dieser Operator stimmt mit dem Wertnamen überein (z.B. "Resolved"), der zu dem Zeitpunkt, als das Feld geändert wurde, in deinem System konfiguriert war. Dieser Operator stimmt auch mit der Wert-ID überein, die mit diesem Wertnamen verknüpft ist, d.h. er stimmt sowohl mit "4" als auch mit "Resolved" überein.


Hinweis: Dieser Operator kann nur mit den Feldern Zugewiesene Person, Lösungsversion, Priorität, Autor, Lösung und Status verwendet werden.

Beispiele


  • Finde alle Vorgänge, die derzeit den Status "Resolved" oder "In Progress" haben bzw. hatten:
status WAS IN ("Resolved","In Progress")


WAS NOT IN

Der Operator "WAS NOT IN" wird verwendet, um Vorgänge zu finden, die einen von mehreren angegebenen Werten für das angegebene Feld haben oder früher hatten. Die Werte werden als kommagetrennte Liste angegeben, die von Klammern umgeben ist.

Die Verwendung von "WAS NOT IN" entspricht der Verwendung mehrerer WAS_NOT-Anweisungen, ist aber kürzer und praktischer. Das heißt, die Eingabe von status WAS NOT IN ('Resolved', 'In Progress') ist dasselbe wie die Eingabe von status WAS NOT "Resolved" OR status WAS NOT "In Progress".

Dieser Operator hat die folgenden optionalen Prädikate:


  • AFTER "date"
  • BEFORE "date"
  • BY "username"
  • DURING ("date1","date2")
  • ON "date"


Dieser Operator stimmt mit dem Wertnamen überein (z.B. "Resolved"), der zu dem Zeitpunkt, als das Feld geändert wurde, in deinem System konfiguriert war. Dieser Operator stimmt auch mit der Wert-ID überein, die mit diesem Wertnamen verknüpft ist, d.h. er stimmt sowohl mit "4" als auch mit "Resolved" überein.


Hinweis: Dieser Operator kann nur mit den Feldern Zugewiesene Person, Lösungsversion, Priorität, Autor, Lösung und Status verwendet werden.

Beispiele


  • Finde Vorgänge, die noch nie den Status "Resolved" oder "In Progress" hatten:
status WAS IN ("Resolved","In Progress")
  • Finde Vorgänge, die vor dem 2. Februar noch nicht den Status "Resolved" oder "In Progress" hatten:
status WAS NOT IN ("Resolved","In Progress") BEFORE "2011/02/02"


WAS NOT

Der "WAS NOT"-Operator wird verwendet, um Vorgänge zu finden, die noch nie den angegebenen Wert für das angegebene Feld hatten.

Dieser Operator hat die folgenden optionalen Prädikate:


  • AFTER "date"
  • BEFORE "date"
  • BY "username"
  • DURING ("date1","date2")
  • ON "date"


Dieser Operator stimmt mit dem Wertnamen überein (z.B. "Resolved"), der zu dem Zeitpunkt, als das Feld geändert wurde, in deinem System konfiguriert war. Dieser Operator stimmt auch mit der Wert-ID überein, die mit diesem Wertnamen verknüpft ist, d.h. er stimmt sowohl mit "4" als auch mit "Resolved" überein.


Hinweis: Dieser Operator kann nur mit den Feldern Zugewiesene Person, Lösungsversion, Priorität, Autor, Lösung und Status verwendet werden.

Beispiele


  • Finde Vorgänge, die nicht den Status "In Progress" haben und auch nie hatten:
status WAS NOT "In Progress"
  • Finde Vorgänge, die vor dem 2. Februar noch nicht den Status "In Progress" hatten:
status WAS NOT "In Progress" BEFORE "2011/02/02"


CHANGED

Der "CHANGED"-Operator wird verwendet, um Vorgänge zu finden, bei denen sich ein Wert für das angegebene Feld geändert hat.

Dieser Operator hat die folgenden optionalen Prädikate:


  • AFTER "date"
  • BEFORE "date"
  • BY "username"
  • DURING ("date1","date2")
  • ON "date"
  • FROM "oldvalue"
  • TO "newvalue"


Hinweis: Dieser Operator kann nur mit den Feldern Zugewiesene Person, Lösungsversion, Priorität, Autor, Lösung und Status verwendet werden.

Beispiele


  • Finde Vorgänge, deren zugewiesene Person sich geändert hat:
assignee CHANGED
  • Finde Vorgänge, deren Status von "In Progress" zurück auf "Open" geändert wurde:
status CHANGED FROM "In Progress" TO "Open"
  • Finde Vorgänge, deren Priorität vom Benutzer 'freddo' nach dem Beginn und vor dem Ende der aktuellen Woche geändert wurde.
priority CHANGED BY freddo BEFORE endOfWeek() AFTER startOfWeek()





Zurück zum Hauptmenü   Nächstes Thema  







Confluence

Diese Seite wurde zuletzt am 27.12.2024 geändert.