Merkzettel für die Jira Query Language (JQL)

Mit Jira Query Language (JQL) kannst du in einem Jira-Arbeitsbereich Vorgänge suchen, filtern und Berichte dazu erstellen. Flexible, leistungsstarke Abfragen sorgen für präzise Ergebnisse. Auf diese Weise suchst du in Jira nach bestimmten Inhalten, wenn das Durchklicken der Filter nicht ausreicht.

JQL ist für alle gedacht, die präzise und wiederholbare Suchläufe in verschiedenen Vorgängen benötigen: Projektmanager, die einen Statusbericht abrufen, Administratoren, die ein Backlog prüfen, oder Entwickler, die jeden Bug aufspüren, der mit einem bestimmten Release zusammenhängt.

Jira kostenlos nutzen

Die 4 Bausteine einer JQL-Abfrage

Jede JQL-Klausel besteht aus denselben vier Teilen:

Teil

Funktionsweise

Beispiel

Feld

Das Attribut, nach dem du suchst

priority, assignee, fixVersion

Operator

Verknüpft das Feld mit einem Wert

=, !=, <, IN

Wert oder Funktion

Womit abgeglichen wird

"High", currentUser()

Stichwort

Verknüpft mehrere Klauseln miteinander

AND, OR, ORDER BY

Allgemeine JQL-Operatoren

Operatoren legen fest, wie Jira ein Feld mit dem Wert vergleicht, nach dem du suchst. Verwende sie, um exakte Übereinstimmungen zu finden, Bedingungen zu kombinieren, in einer Liste von Werten zu suchen oder zu prüfen, ob ein Feld leer ist.

Operator

Bedeutung

Beispiel

 

Genaue Übereinstimmung

project = "Marketingkampagne"

!=

Entspricht nicht

assignee != currentUser()

AND

Kombiniert Bedingungen, alle müssen zutreffen

priority = High AND status = Open

OR

Kombiniert Bedingungen, eine davon kann zutreffen

status = Open OR status = Reopened

IN

Entspricht einem beliebigen Wert in einer Liste

priority IN (High, Highest)

~

Enthält (Textsuche)

summary ~ "login error"

IS EMPTY

Feld hat keinen Wert

assignee IS EMPTY

Wichtige JQL-Funktionen und ihre Verwendung

JQL-Funktionen verbessern die Abfragefunktionen, indem sie Benutzern ermöglichen, komplexere Operationen durchzuführen, Ergebnisse zu sortieren und anhand dynamischer Kriterien zu filtern. Zu diesen Funktionen gehören:

Funktion

Beschreibung

Beispiel

ORDER BY

Sortiert Ergebnisse nach einem Feld.

project = "Marketing" ORDER BY created DESC

WAS

Findet Vorgänge, die sich zuvor in einem bestimmten Status befanden.

status WAS "Erledigt" AND status = "Offen"

CHANGED

Identifiziert Vorgänge, die innerhalb eines Zeitraums geändert wurden.

status CHANGED AFTER -1w

MEMBERSOF

Filtert nach Gruppenzugehörigkeit.

assignee IN MEMBERSOF("Entwickler")

JQL-Beispiele für gängige Jira-Anwendungsfälle

Hier sind ein paar Möglichkeiten, wie du JQL in Jira verwenden kannst.

Anwendungsfall

JQL-Abfrage

Alle Vorgänge mit hoher Priorität finden, die dir zugewiesen sind

priority = High AND assignee = currentUser()

Überfällige Vorgänge in einem bestimmten Projekt auflisten

project = "Kundensupport" AND duedate < now() AND status != Geschlossen

Zuletzt erstellte Vorgänge anzeigen

created >= -7d ORDER BY created DES

Fortgeschrittene JQL-Techniken

Mit der erweiterten Suche mit JQL kannst du benutzerdefinierte Felder und komplexe Abfragen nutzen.

Methode

Beispiel

Hinweise zur Verwendung

Mit benutzerdefinierten Feldern

"Name des benutzerdefinierten Felds" ~ "Suchbegriff"

Suche in benutzerdefinierten Feldern für gezieltere Abfragen.

Unterabfragen

project IN subTaskIssueTypes() AND assignee = currentUser()

Vorgänge anhand der Ergebnisse einer anderen Abfrage filtern.

Bestimmte Vorgangstypen

issuetype = Epic AND status != Erledigt

Bestimmte Vorgangstypen und Status gezielt auswählen.

So lassen sich Fehler schon vor der Suche finden

Fehlersuche im JQL-Editor

Der aktuelle JQL-Editor in Jira Cloud ist so konzipiert, dass er Probleme schon bei der Eingabe erkennt und nicht erst, nachdem auf "Suchen" geklickt wurde:

  • Fehlerprüfung: Ungültige Syntax wird sofort markiert, mit Hinweisen zu ihrer Behebung

  • Syntaxhervorhebung: Felder, Operatoren, Werte und Funktionen sind farblich gekennzeichnet

  • Automatische Vervollständigung: Relevante Schlüsselwörter und Funktionen werden während der Eingabe angezeigt

  • Mehrzeilige Bearbeitung: Erweitere den Editor und finde Fehler anhand von Zeilennummern

  • Gut lesbare Benutzerverweise: Namen und Avatare ersetzen rohe Konto-IDs

  • JQL-Debugger: Wenn eine Abfrage einen Fehler zurückgibt, schlägt Rovo eine korrigierte Abfrage vor, die du prüfen und akzeptieren kannst

Mit Rovo suchen

Du musst dir die oben genannten JQL-Syntaxen nicht merken, um eine präzise Suche auszuführen. Rovo, die KI von Atlassian, übersetzt deine Eingabe automatisch in JQL. Wähle in der Jira-Suchleiste Rovo fragen aus und gib deine Frage so ein, wie du sie laut sagen würdest. Zum Beispiel:

"Finde alle Bugs, die diesen Monat im Mobile-App-Projekt gemeldet wurden"

Rovo übersetzt das in die passende JQL, führt die Suche aus und zeigt dir sowohl die Ergebnisse als auch die generierte JQL. Dieser letzte Teil ist besonders wichtig: Du siehst genau, welche Felder, Operatoren und Funktionen deiner einfachen Frage zugeordnet wurden und kannst so JQL anhand von Beispielen lernen. Wenn eine Abfrage im Basismodus zu komplex für Rovo ist, wechselt es automatisch in den JQL-Modus, um dir ein genaueres Ergebnis zu liefern. Du kannst jederzeit über das Menü "Weitere Aktionen" wieder in den Basismodus wechseln.

Hier funktioniert die Rovo-Suche am besten

Hier solltest du zu JQL wechseln

Du weißt ungefähr, was du möchtest, aber nicht die genauen Feldnamen oder Syntax

Du brauchst präzise, wiederholbare Abfragen für gespeicherte Filter, Boards oder Dashboards

Du suchst mit Alltagssprache und Schlüsselwörtern aus deinen Vorgängen, Bereichen oder Boards

Deine Abfrage benötigt Funktionen oder Logik, die sich in natürlicher Sprache nicht zuverlässig ausdrücken lassen

Du möchtest die JQL-Syntax nach und nach kennenlernen

Du verwendest eine andere Sprache als Englisch für die Suche

JQL: häufig gestellte Fragen

Wie kann JQL mir dabei helfen, bestimmte Vorgänge in Jira zu finden?

Mit JQL kannst du benutzerdefinierte Abfragen erstellen, um Vorgänge nach Feldern wie Zugewiesene Person (assignee), Status, Projekt (project) oder Datum (date) zu filtern. So findest du schnell die Vorgänge, die für dich am wichtigsten sind.

Kann ich meine JQL-Abfragen speichern und mit meinem Team teilen?

Du kannst deine JQL-Suchen als Filter speichern und sie mit Teammitgliedern teilen, damit alle ganz einfach auf dieselbe Gruppe von Vorgängen zugreifen können.

Was sind einige häufige Anwendungsfälle für JQL im Projektmanagement?

Teams verwenden JQL oft, um überfällige Aufgaben zu verfolgen, den Fortschritt im Sprint zu überwachen, Blocker zu identifizieren und Berichte zu erstellen, die zu ihrem Workflow passen.

Gibt es Tipps zum Schreiben erweiterter JQL-Abfragen?

Mit Operatoren, Funktionen und durch das Kombinieren mehrerer Kriterien mit AND/OR kannst du komplexe Abfragen für eine detaillierte Vorgangsverfolgung und Berichterstellung erstellen.