Was ist JQL: Funktionen, History und Sortierung

share

Wie im Matheunterricht fassen die Funktionen in Jira komplexe Logik zusammen und machen sie für Sie auf einfache Weise zugänglich und nutzbar. Hier ist, wie sie in JQL funktionieren.

Funktionen: Was tun sie?

Jira unterstützt zum Beispiel eine Funktion namens membersof(), mit der Sie alle Aufgaben anzeigen können, die MitgliederInnen einer Gruppe zugewiesen sind. Gruppen können innerhalb von Jira definiert werden oder aus bestehenden Gruppen in den bereits vorhandenen Verzeichnisservern Ihres Unternehmens stammen.

project = Pipeline AND assignee in membersof(‘test-engineering’)

Diese Abfrage gibt alle Fragen zurück, die Testingenieuren zugewiesen sind. Die Funktionen reagieren auch dynamisch, wenn sich die Umgebung ändert. Wenn weitere Benutzer zur Gruppe der Testingenieure hinzugefügt werden, wird diese Abfrage dynamisch aktualisiert.

Schauen wir uns an, wie wir sehen können, welche Probleme in der letzten Version behoben wurden.

project = Pipeline AND status in (resolved, closed) and fixversion = Sprint A

Dies gibt alle Probleme zurück, die in dieser bestimmten Version behoben wurden. Was, wenn wir eine Liste wollen, die immer die in der letzten Version behobenen Probleme anzeigt, wann immer sie ausgeführt wurde? Das ist mit einer Funktion sehr einfach zu bewerkstelligen.

status in (resolved, closed) and fixVersion = latestReleasedVersion(Pipeline)

Was ist hier der Unterschied? Die erste Abfrage gibt nur die Liste der in Sprint A gelösten Probleme zurück. Die zweite Abfrage fragt Jira ab, um die letzte freigegebene Version für Projekt Pipeline zu finden. Wenn also die Sprints B, C und D veröffentlicht werden, zieht diese Abfrage die richtigen Daten für diese Releases. Ziemlich cool, nicht wahr?

History: Was geschah damals?

Sie können JQL auch verwenden, um zu sehen, wie sich die Arbeit von Atlassian im Laufe der Zeit entwickelt hat. Wenn Sie zum Beispiel die Fehler sehen möchten, die John Smith im Pipeline-Projekt behoben hat, können Sie die folgende Abfrage verwenden:

project = Pipeline AND status CHANGED FROM In Progress TO Resolved BY jsmith

Manchmal sind Probleme, die bei der Überprüfung scheitern oder wieder geöffnet werden, von besonderem Interesse, um herauszufinden, warum eine Änderung nicht wie vorgesehen funktioniert hat. Um diese Fehler zu finden, ist es einfach, diese Abfrage auszuführen:

status CHANGED FROM In Progress TO Open

Um zu sehen, welche Ausgaben in der aktuellen Woche im Umlauf waren, können wir die folgende JQL verwenden:

status was (“In Progress”) DURING (startofweek(), endofweek());

Am Ende des Jahres kann es schön sein, zu sehen, wie viele Probleme Sie im Laufe des Jahres gelöst haben. Dazu brauchen Sie nur ein wenig JQL:

resolution changed to Fixed by currentUser()

during (startOfYear(), endOfYear())

Scoping und Sortieren: Ihre neue Geheimwaffe

Wenn Sie mit der Suche in Ihren Jira-Problemen beginnen, erhalten Sie oft eine MENGE an Informationen. Wenn Sie Ihre Abfragen einschränken und sortieren, können Sie sich genau die Informationen anzeigen lassen, die Sie benötigen.

  • Scoping – Fokussierung der Abfrage auf die richtige Menge an Daten, damit der Benutzer nur die Informationen sieht, die für das aktuelle Element relevant sind
  • Sortieren – die Daten so ordnen, dass die wichtigsten Daten zuerst aufgelistet werden

Scoping

Mit offenen Fragen beginnen:

project = Pipeline AND status = open

Es kann sein, dass diese Abfrage zu viele Probleme zurückgibt, da sie sowohl alles aus Ihrem Rückstand als auch Probleme, an denen Sie gerade arbeiten, enthält. Sie können die Abfrage etwas straffen, indem Sie die rückständigen Probleme eliminieren.

project = Pipeline AND status = open AND fixVersion = Current Sprint

Dieses Ergebnis ist besser, aber Sie können es noch weiter eingrenzen. Schauen wir uns an, was im letzten Sprint nicht geschafft wurde und in diesen Sprint verschoben wurde.

project = Pipeline AND status = open AND fixVersion = Current Sprint
AND fixVersion WAS Last Sprint

Jetzt, wo Sie die Themen, die Ihnen wirklich wichtig sind, vor sich haben, ist es einfach, jedes dieser Themen mit einem hohen Grad an Fokus zu betrachten und zu sehen, warum sie es nicht in den letzten Sprint geschafft haben. War es ein Schätzungsproblem, die Anforderungen oder etwas anderes? Die Probleme waren schon in der ersten Abfrage vorhanden, aber es war zu schwierig, sie manuell zu finden. Eine gute Abfrageerstellung ist ein iterativer Prozess: Abfrage, Überprüfung, Prüfung, ob Sie die Ergebnisse konzentrieren können. Je mehr Sie das tun, desto einfacher wird es.

Sortieren

Nehmen wir an, Sie möchten alle Fehler sehen, die in einem bestimmten Sprint für das Team offen sind:

project = Pipeline AND fixVersion = Current Sprint AND status = open

Was wollen Sie aus diesen Daten herauslesen? Wenn Sie versuchen, das Risiko zu verstehen, möchten Sie vielleicht die Liste nach Priorität und dann nach einem Ingenieur sortiert sehen, damit Sie leicht erkennen können, ob ein Ingenieur zwei Fehler mit hoher Priorität hat. JQL hat ein Schlüsselwort ORDER BY, das Jira anweist, die Ergebnisse zu sortieren. Die obige Abfrage könnte erweitert werden, um die Sortierung einzuschließen:

project = Pipeline AND fixVersion = Current Sprint AND status = open ORDER BY priority, assignee

Jira ordnet die Liste zunächst nach Priorität und sortiert dann alle Fehler mit der gleichen Priorität nach Zuweiser. Schauen wir uns ein weiteres Beispiel an, bei dem wir die neu eingegangenen Bugs in unserem Projekt untersuchen. Wir wollen alle neuen kritischen oder blockierenden Bugs sehen, die in letzter Zeit eingegangen sind, um festzustellen, ob die jüngsten Checkins die Stabilität verringert haben.

project = Pipeline AND priority in (blocker, critical) AND created > -2w ORDER BY created DESC

Die Abfragekontrollen für die Priorität und die Begrenzung der Erstellungszeit decken die Abfrage richtig ab. Die Sortierung zeigt uns die neuesten Ausgaben zuerst an. Verwenden Sie das Schlüsselwort DESC, um in umgekehrter Reihenfolge zu sortieren (von der neuesten zur ältesten Ausgabe). Auf diese Weise können Sie Ihre Leser auf die wichtigsten Themen lenken. Nicht jeder wird sich jede Ausgabe in Ihren Berichten ansehen. Sortieren Sie Ihre Abfragen immer so, dass die wichtigsten Themen zuerst angezeigt werden.

Fazit

An diesem Punkt sollten Sie sich mit der Abfrage von Jira zum Abrufen von Problemen mit JQL ziemlich gut auskennen. Atlassian hat die Grundstruktur, Funktionen, aktuelle Daten, historische Daten, Sortierung und Scoping behandelt. Wenn Sie mehr über JQL erfahren möchten, werfen Sie einen Blick in die JQL-Referenz. Hier sind einige großartige JQL-Ressourcen, die Sie weiter lesen sollten:

Und wenn Sie noch mehr über JQL erfahren möchten, sehen Sie sich das Produkthandbuch an. Oder kontaktieren Sie uns um mehr Informationen zu erhalten.

Author

Paoula Chotzoli

Atlassian Consultant

View all Articles

Blog category

Blog Categories

Top Authors

Andrii Kulshan

Andrii Kulshan

Consultant, Business Solutions

Oleksandra Skybina

Oleksandra Skybina

Manager, Quality Assurance

Marek Galant

Marek Galant

Manager, Sales Enablement

Thomas Griesser

Thomas Griesser

Senior Marketing Consultant

Anchit Sharma

Anchit Sharma

Director, Engineering