JQL-Merkzettel
Nutze diesen Jira JQL-Merkzettel als umfassenden Leitfaden für den Umgang mit der Jira Query Language für erweitertes Suchen und Filtern im Projektmanagement-Tool von Atlassian.
Einführung in Jira Query Language (JQL)
JQL ist eine leistungsstarke Suchsprache, die speziell für Jira entwickelt wurde und Benutzern ermöglicht, komplexe Abfragen für die Vorgangsverfolgung, die erweiterte Filterung und die Berichterstattung zu erstellen. Die Flexibilität von JQL in Jira hilft Projektmanagern und agilen Teams bei der Verwaltung großer Datensätze.
Grundstruktur von JQL-Abfragen
Eine typische JQL-Abfrage besteht aus den folgenden Komponenten:
- Feld: JQL-Felder stehen für verschiedene Arten von Informationen wie "Priorität", "fixVersion" oder "Vorgangstyp".
- Operator: Operatoren sind das Herzstück jeder Abfrage. Sie weisen dem Feld einen Wert zu. Gängige Operatoren sind unter anderem "gleich" (=), "ungleich" (!=), "weniger als" (<).
- Wert und Funktion: Werte sind die spezifischen Datenpunkte, nach denen du suchst. JQL-Funktionen führen Berechnungen durch oder geben dynamische Ergebnisse zurück.
- Schlüsselwörter: JQL-Schlüsselwörter sind spezielle Wörter mit vordefinierten Bedeutungen, etwa AND (und) und OR (oder). Sie werden verwendet, um komplexere Abfragen zu erstellen.
Beispiel: Projekt = "Marketingkampagne" AND Status = "In Arbeit"
Diese Struktur ermöglicht Benutzern, schnell Abfragen zu formulieren, die auf bestimmte Vorgänge oder Gruppen in Jira abzielen.
Allgemeine JQL-Operatoren
JQL-Operatoren zu verstehen ist entscheidend für effektive Abfragen. Sie bilden das Rückgrat von JQL und ermöglichen Benutzern, präzise Suchvorgänge in großen Datenmengen durchzuführen, um das Gesuchte zu finden. Gängige Operatoren in JQL sind:
=
: Genaue Übereinstimmung. Beispiel:Projekt = "Marketingkampagne"
. Dadurch werden alle Vorgänge zurückgegeben, die zum Projekt "Marketingkampagne" gehören.!=
: Entspricht nicht. Beispiel:Zugewiesene Person != currentUser( )
. Diese Abfrage findet alle Vorgänge, die nicht dem aktuellen Benutzer zugewiesen sind, und hilft so, Tasks zu identifizieren, die die Aufmerksamkeit anderer erfordern könnten.AND
: Kombiniert mehrere Bedingungen (alle müssen wahr sein). Beispiel:Priorität = Hoch AND Status = Offen
. Dadurch werden nur Vorgänge mit hoher Priorität und dem Status "Offen" angezeigt, was bei der Identifizierung kritischer Tasks, die sofortige Aufmerksamkeit erfordern, hilfreich ist.OR
: Kombiniert mehrere Bedingungen (mindestens eine muss wahr sein). Beispiel:Komponente = "Benutzeroberfläche" OR Komponente = "API"
. Hier werden Vorgänge im Zusammenhang mit der Benutzeroberfläche oder den API-Komponenten gefunden, sodass du verwandte Vorgänge in verschiedenen Systemteilen einsehen kannst.IN
: Entspricht einem beliebigen Wert in einer angegebenen Liste. Beispiel:Status IN ("In Arbeit", "Wird überprüft", "Wird getestet")
. Dadurch werden alle Vorgänge mit einem dieser drei Status zurückgegeben, sodass du schnell alle aktiven Vorgänge sehen kannst.
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:
-
ORDER BY
: Sortiert die Ergebnisse. Beispiel:Projekt = "Marketing" ORDER BY erstellte DESC
. Zurückgegeben werden alle Vorgänge im Marketingprojekt, sortiert nach Erstellungsdatum vom neuesten zum ältesten, sodass du die neuesten Tasks schnell identifizieren kannst. WAS
: Findet Vorgänge, die sich in einem bestimmten Status befanden. Beispiel:Status WAS "Erledigt" AND Status = "Offen"
. Hier werden alle Vorgänge gefunden, die zwar gelöst, inzwischen aber wieder geöffnet wurden. Dies hilft, wiederkehrende Probleme zu verfolgen.CHANGED
: Identifiziert Vorgänge, die innerhalb eines Zeitrahmens geändert wurden. Beispiel:Status CHANGED AFTER -1w.
. Diese Abfrage gibt alle Vorgänge zurück, deren Status sich in der letzten Woche geändert hat. Das ist nützlich, um die letzten Fortschritte oder Änderungen in einem Projekt zu überprüfen.MEMBERSOF
: Filtert nach Gruppenzugehörigkeit. Beispiel:Zugewiesene Person IN MEMBERSOF("Entwickler")
. Zurückgegeben werden alle Vorgänge, die einer Person in der Gruppe "Entwickler" zugewiesen wurden, sodass du die Arbeitsbelastung in einem Team sehen kannst.
JQL-Beispiele für gängige Jira-Anwendungsfälle
Hier sind ein paar Möglichkeiten, wie du JQL in Jira verwenden kannst.
- Alle dir zugewiesenen Probleme mit hoher Priorität finden:
Priorität = Hoch AND Zugewiesene Person = currentUser()
- Überfällige Vorgänge in einem bestimmten Projekt auflisten:
Projekt = "Kundensupport" AND Fälligkeitsdatum < now() AND Status != Geschlossen
- Kürzlich erstellte Tasks anzeigen:
Erstellt >= -7d ORDER BY erstellte DES
Fortgeschrittene JQL-Techniken
Mit der erweiterten Suche mit JQL kannst du benutzerdefinierte Felder und komplexe Abfragen nutzen.
- Benutzerdefinierte Felder verwenden:
"Name des benutzerdefinierten Felds" ~ "Suchbegriff"
. Verwende JQL, um in benutzerdefinierten Feldern zu suchen. Das ermöglicht individuellere und spezifischere Abfragen, die auf der einzigartigen Datenstruktur deines Unternehmens basieren. - Unterabfragen:
Projekt IN subTaskIssueTypes() AND Zugewiesene Person = currentUser()
. Verwende JQL, um verschachtelte Abfragen zu erstellen, sodass du Vorgänge anhand der Ergebnisse einer anderen Abfrage filtern kannst, was besonders für komplexe hierarchische Beziehungen in deinen Projekten nützlich ist. - Spezifische Vorgangstypen:
Vorgangstyp = Epic AND Status != Erledigt
. Verwende JQL, um bestimmte Vorgangstypen und deren Status anzusprechen und bestimmte Kategorien von Vorgängen in deinen Projekten einfacher nachzuverfolgen und zu verwalten.
JQL-Experte werden
Mit diesem JQL-Merkzettel von Atlassian bist du gut gerüstet, um die erweiterte Suche mit JQL zu verwenden und deine Projektmanagement-Fähigkeiten zu verbessern.
Wenn du JQL beherrschst, kannst du wichtige Projekteinblicke gewinnen und wichtige Fragen beantworten, die für dein Team relevant sind. Die drei Varianten der Suche in Jira – schnell, einfach und erweitert – können dir helfen, wichtige Informationen zu deinen Projekten zu finden. Die Abfrageergebnisse lassen sich speichern und als Filter und Ansichten in Jira verwenden (auch in Boards).
Bist du bereit, mehr über die Flexibilität von JQL in Jira zu erfahren?