Ściągawka JQL

Używaj tej ściągawki Jira JQL jako kompleksowego przewodnika pozwalającego opanować język Jira Query Language na potrzeby zaawansowanego wyszukiwania i filtrowania w narzędziu Atlassian do zarządzania projektami.

Wprowadzenie do języka Jira Query Language (JQL)

JQL to potężny język wyszukiwania zaprojektowany specjalnie z myślą o systemie Jira, który umożliwia użytkownikom tworzenie złożonych zapytań na potrzeby śledzenia zgłoszeń, zaawansowanego filtrowania i raportowania. Elastyczność JQL w systemie Jira pomaga kierownikom projektów i zespołom Agile poruszać się po dużych zbiorach danych.

Pobierz Jirę za darmo

Podstawowa struktura zapytań JQL

Typowe zapytanie JQL składa się z następujących komponentów:

Pole: pola JQL reprezentują różne typy informacji, takie jak priorytet, wersja poprawki czy typ zgłoszenia.
Operator: operatory są rdzeniem zapytania. Stanowią one powiązanie między polem a wartością. Do często stosowanych operatorów należą: równa się (=), nie równa się (!=) czy mniej niż (<).
Wartość i funkcja: wartości to konkretne punkty danych, których szukasz. Funkcje JQL wykonują obliczenia lub zwracają dynamiczne wyniki.
Słowa kluczowe: słowa kluczowe JQL to specjalne słowa o predefiniowanych znaczeniach, takie jak np. AND i OR. Służą one do konstruowania bardziej złożonych zapytań.

Przykład: project = “Kampania marketingowa” AND status = “In Progress”

Struktura ta umożliwia użytkownikom szybkie formułowanie zapytań ukierunkowanych na określone zgłoszenia lub grupy w systemie Jira.

Popularne operatory JQL

Zrozumienie sposobu korzystania z operatorów JQL jest kluczowe z punktu widzenia tworzenia efektywnych zapytań. Stanowią one trzon języka JQL, umożliwiając użytkownikom precyzyjne wyszukiwanie, w ramach którego mogą filtrować duże ilości danych w celu znalezienia dokładnie tego, czego potrzebują. Popularnymi operatorami w JQL są:

=: dokładne dopasowanie. Przykład: Project = “Marketing Campaign”. Spowoduje to zwrócenie wszystkich zgłoszeń przypisanych do projektu „Marketing Campaign”.
!=: nie równa się. Przykład: assignee != currentUser( ). Pozwoli to znaleźć wszystkie zgłoszenia nieprzypisane do bieżącego użytkownika, pomagając zidentyfikować zadania, które mogą wymagać uwagi innych osób.
AND: łączy wiele warunków (wszystkie muszą być prawdziwe). Przykład: priority = High AND status = Open. Spowoduje to zwrócenie tylko otwartych zgłoszeń o wysokim priorytecie, co pomoże zidentyfikować krytyczne zadania wymagające natychmiastowej uwagi.
OR: łączy wiele warunków (przynajmniej jeden musi być prawdziwy). Przykład: component = “User Interface” OR component = “API”. Pozwoli to znaleźć zgłoszenia związane z interfejsem użytkownika lub API, umożliwiając przeglądanie powiązanych prac w różnych częściach systemu.
IN: dopasowuje dowolną wartość z określonej listy. Przykład: status IN (“In Progress”, “Under Review”, “Testing”). Spowoduje to zwrócenie wszystkich zgłoszeń o dowolnym z tych trzech statusów, zapewniając szybki sposób wyświetlenia wszystkich aktywnych zgłoszeń.

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ą:

ORDER BY: sortuje wyniki. Przykład: project = "Marketing" ORDER BY created DESC. Spowoduje to zwrócenie wszystkich zgłoszeń w projekcie Marketing — posortowanych według daty utworzenia od najnowszej do najstarszej — umożliwiając szybką identyfikację najnowszych zadań.
WAS: znajduje zgłoszenia, które miały określony status. Przykład: status WAS "Resolved" AND status = "Open". Pozwoli to znaleźć wszystkie zgłoszenia, które były rozwiązane, ale od tego czasu zostały ponownie otwarte, pomagając śledzić powtarzające się problemy.
CHANGED: identyfikuje zgłoszenia zmodyfikowane w określonym przedziale czasowym. Przykład: status CHANGED AFTER -1w. Spowoduje to zwrócenie wszystkich zgłoszeń, których status zmienił się w ciągu ostatniego tygodnia, co jest przydatne w przypadku przeglądania ostatnich postępów lub zmian w projekcie.
MEMBERSOF: filtruje według członkostwa w grupie. Przykład: assignee IN MEMBERSOF("developers"). Spowoduje to znalezienie wszystkich zgłoszeń przypisanych do dowolnej osoby w grupie „developers”, co pozwala sprawdzić obciążenie pracą w całym zespole.

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

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

Znalezienie wszystkich przypisanych do Ciebie zgłoszeń o wysokim priorytecie: priority = High AND assignee = currentUser()
Utworzenie listy zaległych zgłoszeń w danym projekcie: project = "Customer Support" AND duedate < now() AND status != Closed
Wyświetlenie ostatnio utworzonych zgłoszeń: 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ń.

Korzystanie z pól niestandardowych: "Custom Field Name" ~ "search term". Używaj JQL do wyszukiwania w polach niestandardowych, co pozwala tworzyć bardziej dopasowane i szczegółowe zapytania w oparciu o unikalną strukturę danych Twojej firmy.
Podzapytania: project IN subTaskIssueTypes() AND assignee = currentUser(). Używaj JQL do tworzenia zapytań zagnieżdżonych, które umożliwiają filtrowanie zgłoszeń na podstawie wyników innego zapytania — jest to szczególnie przydatne w przypadku projektów ze złożonymi relacjami hierarchicznymi.
Określone typy zgłoszeń: issuetype = Epic AND status != Done. Używaj JQL, aby wskazywać konkretne typy zgłoszeń i ich statusy, co pomaga śledzić określone kategorie pracy w projektach i nimi zarządzać.

Zostań ekspertem w zakresie języka JQL

Dzięki tej ściągawce Atlassian JQL przygotujesz się do zaawansowanego wyszukiwania za pomocą języka JQL i poprawisz swoje umiejętności zarządzania projektami.

Dzięki znajomości JQL można uzyskać kluczowe informacje na temat projektu i odpowiedzieć na najważniejsze pytania dotyczące zespołu. Trzy rodzaje wyszukiwania w systemie Jira — szybkie, podstawowe i zaawansowane — ułatwiają znalezienie ważnych informacji o projektach. Ponadto wyniki zapytań można zapisywać i używać ich w charakterze filtrów oraz widoków w systemie Jira (także na tablicach).

Chcesz dowiedzieć się więcej o elastyczności języka JQL w systemie Jira?

Pobierz Jirę za darmo

Ściągawka JQL

Wprowadzenie do języka Jira Query Language (JQL)

Podstawowa struktura zapytań JQL

Popularne operatory JQL

Kluczowe funkcje języka JQL i sposoby ich wykorzystania

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

Zaawansowane techniki JQL

Zostań ekspertem w zakresie języka JQL

produkty

Zasoby

Uczenie się