Einführung in JQL: Die Standard & erweiterte Suche in Jira

Was ist JQL & wofür wird es verwendet?

Definition: In der Jira-Suche können Sie mittels Jira Query Language (JQL) strukturierte Abfragen bauen, um Vorgänge zu suchen.

Vorteil: JQL hat das Ziel, auf schnellem Weg bestimmte Vorgänge zu finden, um sie für einen besseren Überblick, Berichte oder Boards zu verwenden. Mittels JQL Speicherung können Arbeitsschritte schneller durchgeführt werden, zum Beispiel wenn wöchentlich wiederkehrende Abfragen nötig sind und per JQL-Suche durchgeführt werden. 

Aufbau: In JQL spricht man von Abfragen, auch Klauseln genannt. Die Abfragen haben eine vorgegebene Form (Syntax), die je nach Ziel der Suche angepasst wird.

Einfache Standardsuche mit JQL: Im Rahmen der Jira-Standardsuche wird nach einem bestimmten Vorgang gesucht, zum Beispiel sollen alle Tickets ausgespielt werden, die zum aktuellen User gehören. Hierfür wird das zugehörige Feld entsprechend ausgefüllt. Die Standardsuche stößt jedoch schnell an ihre Grenzen, da nur die zur Verfügung stehenden Filter zur Abfrage dienen und lediglich AND-Verknüpfungen Teil der Abfrage sind. Hier kommt die erweiterte Suche und JQL ins Spiel.

Erweiterte Suche mit JQL: Bei der erweiterten Suche macht sich der Anwender die Power der JQL zunutze, die zusätzliche Elemente zur Durchführung der Abfrage ermöglicht. Die Syntax kann individuell formuliert, mit den Suchergebnissen für den erneuten Gebrauch in der Filterliste gespeichert und per Gadget zum Dashboard hinzugefügt werden. Im Dashboard stehen Exportingoptionen zur Verfügung.

Die Grundlagen der JQL-Syntax

Um die JQL-Abfragen zielgerichtet einsetzen zu können, muss die eingetragene Syntax bestimmten Regeln folgen. Einige davon sind:

• Der Standardoperator „=“ wird verwendet,  um einzelne Werte zu finden (siehe Beispiel 1)
• Der Operator „IN“ wird verwendet, wenn eine Liste gefragt ist (siehe Beispiel 2)
• Mit „AND“ kann die Abfrage zwei Kriterien beinhalten. Beide müssen erfüllt sein (siehe Beispiel 1 und 2)
• Mit „OR“ muss entweder das eine oder das andere Suchkriterium zutreffen (siehe Beispiel 3)

Beispiel 1: JQL-Suche für Tickets des aktuellen Users mit Fälligkeitsdatum „jetzt“

Beispiel 2: JQL-Suche für Tickets aus dem Projekt Marketing mit der Resolution „Erledigt“ oder „Nicht-erledigt“

Beispiel 3: JQL-Suche für Tickets des aktuellen User oder eines anderen Mitarbeiters, mit jeder Resolution außer „erledigt“

JQL-Suche in Systemen von Jira

Standardmäßig gibt es für Systeme wie Jira Core, Jira Software und Jira Service Management bereits Funktionen, die in der erweiterten JQL-Suche vorhanden sind. Bedeutet: Die Syntax kann eingetippt werden, wird im Index zur Schnellauswahl angezeigt und die Abfrage kann durchgeführt werden.

Um die Anforderungen an die Suchintentionen in Jira um ein vielfaches erweitern zu können, stehen auf dem Atlassian Marketplace Apps wie ScriptRunner und Xray bereit. Sie wurden aufgrund anderer Use Cases entwickelt, bringen in unserem Fall jedoch auch zusätzliche benutzerdefinierte Funktionen für JQL mit, die Ihre Arbeit in Jira erheblich erleichtern. Zudem erlauben sie auch mittels erweiterter JQL neue Möglichkeiten der Issuesuche sowie der Berichterstellung. Mit ScriptRunner profitieren Sie nicht nur von einer Vielzahl an neuen JQL-Befehlen, sondern können auch eigene JQL-Funktionen erstellen. Auch Actonic hat mit Power JQL eine App bereitgestellt, die zahlreiche JQL-Funktionen für die erweiterte Suche bereithält.

Wie Sie sehen, bringt JQL eine Vielzahl von Vorteilen und Funktionen für Jira-User mit sich, verlangt jedoch auch ein gewisses Maß an Expertise, um korrekt ausgeführt zu werden. Gerne unterstützt Actonic Sie bei diesen Belangen. Als Atlassianpartner konnten wir bereits zahlreichen Kunden die Welt rund um JQL in Form von Beratungen oder Trainingseinheiten näher bringen.