JQL-Abfragen haben eine Reihenfolge von Elementen, die bei der Erstellung von SLAs (Service Level Agreements) beachtet werden müssen. Außerdem gibt es Funktionen, die bei der Erstellung von SLA-Abfragen häufig verwendet werden, häufig verwendete Operatoren und bestimmte Zeichen und Wörter, die in Jira reserviert wurden, um bestimmte Funktionen in der Abfrage auszuführen. Hier erfährst du mehr über die erweiterte Suchreferenz - JQL-Felder.

In JQL hat eine Abfrage vier grundlegende Elemente:

Feld

Felder sind verschiedene Arten von Informationen im System. Ein Jira Service Management-Feld kann zum Beispiel Priorität, Vorgangstyp, Erstellungsdatum und Projekt sein.

Operator

Operatoren sind das Herzstück einer Abfrage. Sie stellen eine Beziehung zwischen dem Feld und dem Wert her. Gängige Operatoren sind Gleich (=), Nicht-Gleich (!=) und Kleiner als (<).

Wert

Werte sind die konkreten Daten in der Abfrage. Zum Beispiel paused() und remaining(„2h“).

Funktionen

Funktionen sind spezielle Berechnungen in Jira, um auf bestimmte Daten zuzugreifen. Zum Beispiel Vorgänge, die gegen SLAs verstoßen haben.

Du kannst eine Abfrage optional mit ein paar ausgewählten Stichwörtern verknüpfen. Stichwörter sind bestimmte Wörter in der Sprache, die eine besondere Bedeutung haben. Das können zum Beispiel AND und OR sein.

Eine einfache Abfrage in JQL besteht aus einem Feld, gefolgt von einem Operator, gefolgt von einem oder mehreren Werten oder Funktionen.

Zum Beispiel: project = Test

Diese Abfrage findet alle Vorgänge im Projekt Test. Sie verwendet project (Feld), das Gleichheitszeichen = (Operator) und Test (Wert).

Nachfolgend sind Funktionen aufgeführt, die beim Schreiben von JQL-Abfragen für ein SLA häufig verwendet werden:

breached()

Damit werden Vorgänge herausgefiltert, bei denen der letzte SLA-Zyklus sein Ziel nicht erreicht hat.

everBreached()

Damit werden Vorgänge herausgefiltert, die ihr Ziel nicht erreicht haben.

paused()

Diese Funktion filtert Vorgänge, bei denen der aktuelle SLA-Zyklus aufgrund einer bestimmten Bedingung angehalten wurde. Du kannst zum Beispiel den SLA-Zyklus eines Vorgangs anhalten, wenn der Status des Vorgangs auf Warten auf Kunden gesetzt ist.

completed()

Damit werden Vorgänge gefiltert, bei denen der SLA-Zyklus abgeschlossen ist, d.h. der Vorgang hat eines seiner Stop-Ereignisse erreicht.

running()

Damit werden Vorgänge herausgefiltert, bei denen die aktuelle SLA-Uhr läuft, d.h. der Vorgang hat noch nicht eines der Stop-Ereignisse erreicht.

withincalendarhours()

Dies filtert Vorgänge, deren SLA-Uhr nach dem SLA-Kalender läuft oder nicht läuft, nicht nach Bedingungen.

elapsed()

Damit werden Vorgänge gefiltert, bei denen die Uhr des SLA-Zyklus seit dem Start-Ereignis des laufenden SLA-Zyklus eine bestimmte Zeitspanne erreicht hat.

remaining()

Damit werden Vorgänge gefiltert, deren SLA-Zyklus eine bestimmte Zeitspanne einhält, bevor der Vorgang ein SLA-Ziel überschreitet.

Hier sind einige gängige Zeichen- und Wortoperatoren, die du in deiner SLA-JQL-Abfrage verwenden kannst:

Zeichen

=, >, >=, ~, !=, <, <=, !~

Wörter

not, in, is not, not, was not, not in, is, was, was in, changed

Hier sind einige reservierte Zeichen und Wörter in Jira, die auf eine bestimmte Weise verwendet werden müssen, wenn du sie in einer Abfrage benutzt.

Zeichen

space (" "), +, ., ;, ?, |, *, /, %, ^, $, #, @, [ ], ,

Wörter

a, and, are, as, at, be, but, by, for, if, in, into, is, it, no, not, of, on, or, s, such, t, that, the, their, then, there, these, they, this, to, was, will, with

Wenn du zum Beispiel alle Vorgänge in deinem Projekt finden möchtest, die deine First-Response-Ziele erfolgreich abgeschlossen haben, kannst du die folgende Abfrage verwenden:

"Time to first response" != everBreached()

Wenn du zum Beispiel Anfragen finden willst, die seit weniger als 10 Minuten auf eine erste Antwort warten, verwende die folgende Abfrage:

"Time to first response" < elapsed("10m")

Oder wenn du Vorgänge finden willst, die ihr Lösungsziel innerhalb der nächsten zwei Stunden überschreiten werden, verwende diese Abfrage:

"Time to resolution" < remaining("2h")