7 Fortgeschrittene Suche mit JQL (Jira Query Language)

Nachdem wir die grundlegenden Suchfunktionen kennengelernt haben, wollen wir uns nun mit den erweiterten Suchmöglichkeiten befassen, die Jira durch die spezielle Abfragesprache JQL (Jira Query Language) bietet.

Zur Dokumentation zu JQL

7.1 Was ist JQL?

JQL (Jira Query Language) ist eine leistungsfähige Abfragesprache, die speziell für Jira entwickelt wurde. Sie ermöglicht komplexere und präzisere Suchanfragen als die grundlegenden Filteroptionen. Wenn Sie mit anderen Abfragesprachen wie SQL vertraut sind, werden Sie viele Ähnlichkeiten erkennen.

7.2 Zugriff auf JQL

Um JQL zu verwenden: 1. Starten Sie eine Suche mit den grundlegenden Filteroptionen 2. Klicken Sie auf die Registerkarte “JQL” 3. Sie sehen, dass Jira Ihre bestehenden Filter automatisch in JQL-Syntax umwandelt

7.3 Die Grundlagen der JQL-Syntax

Eine JQL-Abfrage besteht typischerweise aus:

• Feldern (z.B. project, issueType, status)
• Operatoren (z.B. =, !=, IN, WAS)
• Werten (z.B. Projektnamen, Statuswerte)
• Logischen Operatoren (AND, OR, NOT)

7.3.1 Beispiel einer einfachen JQL-Abfrage:

project = SSP AND issueType = Story AND status IN ("In Progress", "To Do")

7.4 JQL-Unterstützung in Jira

Jira bietet umfangreiche Unterstützung beim Erstellen von JQL-Abfragen:

• Autovervollständigung: Beim Eintippen werden Vorschläge für Felder, Operatoren und Werte angezeigt
• Syntaxhervorhebung: Verschiedene Elemente der Abfrage werden farblich markiert
• Validierung: Jira überprüft automatisch die Gültigkeit Ihrer Abfrage

7.5 Praktische JQL-Beispiele

7.5.1 Suche nach einem bestimmten Issuetyp:

issueType = Epic

7.5.2 Suche nach Issues, die zu einem bestimmten Epic gehören:

parent = SSP-24

Dabei ist “SSP-24” der Schlüssel des übergeordneten Epics.

7.5.3 Suche nach Issues in abgeschlossenen Sprints:

sprint IN closedSprints()

Dieses Beispiel verwendet die JQL-Funktion closedSprints().

7.6 Fortgeschrittene JQL-Operatoren

Besonders nützlich ist der WAS-Operator, der es ermöglicht, nach Issues zu suchen, die früher einen bestimmten Wert hatten:

7.6.1 Beispiel für den WAS-Operator:

status WAS "In Progress"

Findet alle Issues, die zu irgendeinem Zeitpunkt den Status “In Progress” hatten.

7.6.2 Noch komplexeres Beispiel:

status WAS "Resolved" BY currentUser() BEFORE "2023/01/01"

Findet alle Issues, die vom aktuellen Benutzer vor dem 1. Januar 2023 als “resolved” markiert wurden.

Hinweis: Bei komplexeren JQL-Abfragen wird die Option “Basic” in der Suchoberfläche automatisch deaktiviert, da solche Abfragen nur in JQL möglich sind.

7.7 JQL-Dokumentation und Ressourcen

Jira bietet eine umfassende Dokumentation zu JQL, die folgende Bereiche abdeckt:

• JQL-Funktionen: wie currentUser(), closedSprints() und viele mehr
• JQL-Felder: vollständige Liste aller verfügbaren Felder
• JQL-Schlüsselwörter: AND, OR, NOT, EMPTY etc.
• JQL-Operatoren: =, !=, IN, WAS etc.

7.8 Tipps für die Arbeit mit JQL

1. Nutzen Sie die Autovervollständigung: Sie hilft, Syntaxfehler zu vermeiden
2. Experimentieren Sie mit verschiedenen Operatoren: Besonders der WAS-Operator bietet mächtige Möglichkeiten
3. Nutzen Sie die Atlassian-Community: Viele komplexe Abfragen wurden bereits von anderen Benutzern erstellt
4. Speichern Sie häufig verwendete Abfragen als Filter: Dies spart Zeit bei wiederkehrenden Suchen

JQL ermöglicht es Ihnen, genau die Issues zu finden, die Sie benötigen, auch in komplexen Szenarien, die mit den grundlegenden Filteroptionen nicht abgedeckt werden können.