Ściągawka z języka Jira Query Language (JQL)

Język Jira Query Language (JQL) umożliwia wyszukiwanie, filtrowanie i generowanie raportów zgłoszeń w przestrzeni roboczej Jiry za pomocą elastycznych i zaawansowanych zapytań, które pozwalają uzyskać precyzyjne wyniki. Jest to sposób na wyszukiwanie w Jirze, gdy przełączanie się między filtrami nie jest wystarczające.

JQL opracowano z myślą o wszystkich, którzy potrzebują precyzyjnych, powtarzalnych wyszukiwań w zgłoszeniach — od menedżerów projektów pobierających raport o statusie przez administratorów przeprowadzających audyt backlogu po programistów szukających błędów związanych z konkretnym wydaniem.

Pobierz Jira za darmo

Cztery podstawowe elementy zapytania JQL

Każde zdanie JQL składa się z tych samych czterech elementów:

Część

Co to robi

Przykład

Pole

Atrybut, według którego odbywa się wyszukiwanie

priority, assignee, fixVersion

Operator

Przypisuje pole do wartości

=, !=, <, IN

Wartość lub funkcja

Element, z którym następuje porównanie

"High", currentUser()

Słowo kluczowe

Łączy kilka zdań

AND, OR, ORDER BY

Popularne operatory

Operatory określają, w jaki sposób Jira porównuje pole z wyszukiwaną wartością. Można ich użyć do znajdowania dokładnych dopasowań, łączenia warunków, wyszukiwania na liście wartości lub sprawdzania, czy pole jest puste.

Operator

Znaczenie

Przykład

=

Dokładne dopasowanie

project = "Marketing Campaign"

!=

Nie równa się

assignee != currentUser()

AND

Łączy warunki, wszystkie muszą być spełnione

priority = High AND status = Open

LUB

Łączy warunki, każdy może być spełniony

status = Open OR status = Reopened

IN

Pasuje do dowolnej wartości na liście

priority IN (High, Highest)

~

Zawiera (wyszukiwanie tekstowe)

summary ~ "login error"

IS EMPTY

Pole nie zawiera wartości

assignee IS EMPTY

Kluczowe funkcje języka JQL i sposoby ich wykorzystania

Funkcje języka JQL zwiększają możliwości w zakresie zapytań, umożliwiając użytkownikom wykonywanie bardziej złożonych operacji, sortowanie wyników i filtrowanie na podstawie dynamicznych kryteriów. Funkcje te obejmują:

Funkcja

Opis

Przykład

ORDER BY

Sortuje wyniki według pola.

project = "Marketing" ORDER BY created DESC

WAS

Wyszukuje zgłoszenia, które wcześniej znajdowały się w określonym stanie.

status WAS "Resolved" AND status = "Open"

CHANGED

Wskazuje zgłoszenia zmodyfikowane w określonym przedziale czasu.

status CHANGED AFTER -1w

MEMBERSOF

Filtruje zgłoszenia według członkostwa w grupie.

assignee IN MEMBERSOF("developers")

Przykłady JQL dla typowych przypadków użycia w systemie Jira

Oto kilka sposobów korzystania z języka JQL w Jirze.

Przypadek użycia

Zapytanie JQL

Znajdź wszystkie przypisane do Ciebie zgłoszenia o wysokim priorytecie

priority = High AND assignee = currentUser()

Wyświetl zaległe zgłoszenia w konkretnym projekcie

project = "Customer Support" AND duedate < now() AND status != Closed

Pokaż ostatnio utworzone zgłoszenia

created >= -7d ORDER BY created DES

Zaawansowane techniki JQL

Zaawansowane wyszukiwanie przy użyciu języka JQL pozwala korzystać z pól niestandardowych i złożonych zapytań.

Technika

Przykład

Jak używać

Korzystanie z pól niestandardowych

"Custom Field Name" ~ "search term"

Wyszukuj w polach niestandardowych, aby tworzyć bardziej dopasowane zapytania.

Zapytania podrzędne

project IN subTaskIssueTypes() AND assignee = currentUser()

Filtruj zgłoszenia na podstawie wyników innego zapytania.

Określone typy zgłoszeń

issuetype = Epic AND status != Done

Wybierz na cel określone typy zgłoszeń i statusy.

Jak wychwycić błędy przed uruchomieniem wyszukiwania

Wychwytywanie błędów w edytorze JQL

Obecny edytor JQL w Jira Cloud został zaprojektowany tak, aby wykrywać błędy podczas pisania, a nie dopiero po uruchomieniu funkcji wyszukiwania:

  • Sprawdzanie błędów: nieprawidłowa składnia jest natychmiast oznaczana wraz ze wskazówkami, jak ją poprawić

  • Podświetlanie składni: pola, operatory, wartości i funkcje są oznaczone kolorami

  • Automatyczne uzupełnianie: podczas pisania pojawiają się odpowiednie słowa kluczowe i funkcje

  • Edycja wielowierszowa: powiększ edytor i wykorzystuj numery wierszy w celu znajdowania błędów

  • Czytelne odniesienia do użytkowników: imiona, nazwiska i awatary zastępują surowe identyfikatory kont

  • Narzędzie do usuwania błędów JQL: gdy zapytanie zwraca błąd, Rovo proponuje poprawioną wersję zapytania, którą można przejrzeć i zaakceptować

Wyszukiwanie za pomocą Rovo

Nie trzeba zapamiętywać żadnej z powyższych składni JQL, aby przeprowadzić precyzyjne wyszukiwanie. Rovo, oparte na sztucznej inteligencji narzędzie firmy Atlassian, automatycznie tłumaczy tekst wpisywany do JQL. Na pasku wyszukiwania Jiry wybierz opcję Zapytaj Rovo i wpisz pytanie tak, jakby było wypowiadane na głos. Przykład:

„Znajdź wszystkie błędy zgłoszone w projekcie aplikacji mobilnej w tym miesiącu”

Rovo przekształca je na pasujący język JQL, uruchamia wyszukiwanie i wyświetla zarówno wyniki, jak i wygenerowany poniżej JQL. Ważne jest to ostatnie: to naprawdę przydatny sposób nauki JQL na przykładzie, ponieważ można dokładnie zobaczyć, do jakich pól, operatorów i funkcji zostało przypisane pytanie w języku angielskim. Jeśli zapytanie jest zbyt złożone, aby narzędzie Rovo mogło je rozwiązać w trybie podstawowym, automatycznie przełącza się ono na tryb JQL, aby zapewnić dokładniejszy wynik. W każdej chwili można przełączyć się z powrotem na tryb podstawowy z poziomu menu Więcej działań.

Kiedy wyszukiwanie Rovo działa najlepiej

Kiedy przełączyć się bezpośrednio na JQL

Wiesz mniej więcej, czego potrzebujesz, ale nie znasz dokładnych nazw pól ani składni

Potrzebne są precyzyjne, powtarzalne zapytania dotyczące zapisanych filtrów, tablic lub pulpitów.

Wyszukiwanie odbywa się za pomocą codziennego języka oraz słów kluczowych ze zgłoszeń, przestrzeni lub tablic

Zapytanie wymaga funkcji lub logiki, których nie da się wiarygodnie wyrazić w języku naturalnym

Chcesz stopniowo poznawać składnię JQL

Wyszukujesz w języku innym niż angielski

JQL: często zadawane pytania

W jaki sposób JQL może pomóc w wyszukiwaniu konkretnych zgłoszeń w Jirze?

JQL umożliwia tworzenie własnych zapytań w celu filtrowania zgłoszeń według pól, takich jak osoba przypisana (assignee), status, projekt (project) czy data (date), dzięki czemu można szybko znajdować najważniejsze zgłoszenia.

Czy można zapisywać i udostępniać zapytania JQL swojemu zespołowi?

Można zapisywać wyszukiwania JQL jako filtry i udostępniać je kolegom z zespołu, co ułatwia wszystkim dostęp do tego samego zestawu zgłoszeń.

Jakie są typowe przykłady zastosowania JQL w zarządzaniu projektami?

Zespoły często korzystają z JQL, aby śledzić zaległe zadania, monitorować postęp sprintu, identyfikować blokery oraz generować raporty dostosowane do ich przepływów pracy.

Czy istnieją jakieś wskazówki dotyczące tworzenia bardziej zaawansowanych zapytań JQL?

Korzystając z operatorów i funkcji oraz łącząc wiele kryteriów za pomocą wyrażenia AND/OR, można tworzyć złożone zapytania umożliwiające szczegółowe śledzenie i raportowanie zgłoszeń.