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.

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"

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).

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

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

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

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.

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"

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

Beispiele

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

votes < 4

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

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"

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")

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

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"

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\""

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"

Beispiele

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

summary !~ run

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.

Beispiele

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

fixVersion is empty

oder

fixVersion is null

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.

Beispiele

• Finde alle Vorgänge, die eine oder mehrere Stimmen haben:

votes is not empty

oder

votes is not null

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.

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")

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.

Beispiele

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

status WAS IN ("Resolved","In Progress")

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.

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"

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.

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"

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"

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()