Udostępnij za pośrednictwem


Wykonywanie zapytań według pól liczbowych

Azure DevOps Services | Azure DevOps Server 2022 — Azure DevOps Server 2019

Dowiedz się, jak wykonywać zapytania według pól liczbowych na podstawie nakładu pracy, harmonogramu, punktów scenariusza lub pól śledzenia czasu w usługach Azure Boards i Azure DevOps.

Najbardziej typowe pola liczbowe śledzą nakład pracy dla elementów w kategorii Wymagania lub szacowane, pozostałe i ukończone zadania dla elementów w kategorii Zadanie. Za pomocą zapytań można wyświetlić interesujące elementy robocze, a następnie zdefiniować wykres przedstawiający liczbę elementów roboczych lub sumę pola liczbowego.

Warunki wstępne

Kategoria Wymagania
poziomy dostępu - Aby wyświetlić i uruchomić udostępnione zapytania: członek projektu.
— Aby dodać i zapisać udostępnione zapytanie: co najmniej dostęp podstawowy.
uprawnienia uprawnienia Contribute ustawione na Zezwalaj dla folderu, do którego chcesz dodać zapytanie. Domyślnie grupa współautorów nie ma tego uprawnienia.

Notatka

Użytkownicy z dostępem Stakeholder dla projektu publicznego mają pełny dostęp do funkcji zapytań, takich jak użytkownicy z dostępem Basic. Aby uzyskać więcej informacji, zobacz Szybkie odniesienie dostępu interesariuszy.

Kategoria Wymagania
poziomy dostępu - Aby wyświetlić i uruchomić udostępnione zapytania: członek projektu.
— Aby dodać i zapisać udostępnione zapytanie: co najmniej dostęp podstawowy .
uprawnienia uprawnienia do Współtworzenia ustawione na Zezwalaj dla folderu, do którego chcesz dodać zapytanie. Domyślnie grupa współautorów nie ma tego uprawnienia.

Używanie operatorów i makr

Obsługiwane klauzule zapytania określające pole liczbowe mogą używać następujących operatorów.

  • = , <> , > , < , >= , <=
  • =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field]
  • In, Not In
  • Was Ever

Opracowywanie zapytań opartych na wykresach

Poniższe porady mogą pomóc w tworzeniu zapytań:

  • Dodaj wykresy tylko dla list płaskich.
  • Odwoływanie się do filtrów zapytań lub pól wyświetlanych za pomocą opcji kolumny.
  • Zapisz zmiany wprowadzone w zapytaniu przed dodaniem lub zmodyfikowaniem wykresu.
  • Grupuj co najmniej jedną klauzulę, wybierając je, a następnie ikonę Klauzula kwerendy grupy ikonę klauzul grupy. Aby rozgrupować, zaznacz pogrupowaną klauzulę.

Aby uzyskać więcej informacji, zobacz Użyj edytora zapytań do tworzenia i zarządzania zapytaniami oraz wykresy i dodaj lub zmodyfikuj pole.

Używanie filtrów

W poniższej tabeli przedstawiono przydatne filtry zapytań.

Filtr dla

uwzględnij te klauzule zapytania

Scenariusze użytkownika lub usterki

Work Item Type In User Story,Bug

Zadania lub usterki

Work Item Type In Task,Bug

Elementy, które są aktywne lub zamknięte

State In Active,Closed

Elementy w kategorii Wymagania

Work Item Type In Group Microsoft.RequirementCategory

Nieszacowane historie użytkowników

Story Points <> (leave Value field blank)


Zapytanie dotyczące liczby elementów roboczych

Wszystkie zapytania pokazują liczbę elementów podczas uruchamiania zapytania. W tym miejscu definiujemy zapytanie flat-list, które filtruje błędy w dowolnym stanie.

Zrzut ekranu przedstawiający błędy zapytań w dowolnym stanie, liczba elementów roboczych.

Ponadto wszystkie wykresy zawierają opcję Wartości, która służy do wyświetlania liczby elementów roboczych w wykresie.

Zapytanie o liczbę usterek na programistę

Aby wyświetlić pola "Przypisane do" i "Stan", utwórz zapytanie o aktywne błędy i zmodyfikuj opcje kolumn. Następnie dodaj wykres przestawny, który wyświetla przypisania i stan.

Zrzut ekranu przedstawiający dialog Konfigurowanie wykresu, przestawienie według przypisania i stanu.

Zapytanie dotyczące liczby usterek według stanu i obszaru

Korzystając z tego samego zapytania flat-list, które filtruje błędy wyświetlane w poprzedniej sekcji, można wyświetlić liczbę na podstawie obszaru. Zmodyfikuj opcje kolumny, aby wyświetlić ścieżkę obszaru. Następnie dodaj wykres przestawny, który wyświetla ścieżkę stanu i obszaru.

Zrzut ekranu przedstawiający okno dialogowe Konfigurowanie wykresu, przestawne według stanu i obszaru.

Zapytanie o niezdefiniowane wartości pól

Elementy robocze, które mają niezdefiniowaną wartość pola, można znaleźć przy użyciu operatora równego, =i pozostawiając wartość pola pustego. Na przykład poniższe filtry zawierają listę wszystkich elementów roboczych typu Scenariusze użytkownika, których pole Story Points jest puste.

Zrzut ekranu przedstawiający filtr na podstawie pustych wpisów.

Aby wyświetlić listę elementów roboczych na podstawie pola, które nie jest puste, użyj operatora nie, <>i pozostaw wartość pustą.

Wykonywanie zapytań dotyczących nakładu pracy lub punktów scenariusza

Punkty opowieści można przypisywać do historyjek użytkowników lub usterek podczas pracy w procesie Agile. Alokacja wysiłku na elementy zaległości produktowej i usterki podczas pracy w procesie Scrum. Aby uzyskać więcej informacji, zobacz artykuły dotyczące typów elementów roboczych i przepływów pracy: Basic, Agile, Scrumlub CMMI.

Wykonywanie zapytań o sumę punktów scenariuszy i ich stan

Utwórz zapytanie, które filtruje element User Story jako typ elementu roboczego i zmodyfikuj opcje kolumny, aby wyświetlić punkty scenariusza i stan.

Zrzut ekranu przedstawiający edytor zapytań, płaską listę i otwarte scenariusze.

Następnie dodaj skumulowany wykres słupkowy, który sumuje punkty historii.

Zrzut ekranu przedstawiający okno dialogowe Konfigurowanie wykresu, słupek skumulowany, suma punktów historii.

Aby uzyskać więcej informacji na temat diagramów przepływu skumulowanego zdefiniowanego przez system, zobacz Skumulowany przepływ.

Zapytanie o wykres narastający historii użytkowników dla iteracji

Utwórz zapytanie filtrujące historię użytkownika jako typ elementu roboczego i w stanie Aktywny lub Zamknięty. Aby wyświetlić punkty historii, zmodyfikuj opcje kolumny.

Zrzut ekranu przedstawiający edytor zapytań, płaską listę, historie użytkowników — aktywne lub zamknięte.

Następnie dodaj skumulowany wykres trendu warstwowego, który sumuje punkty historii.

Zrzut ekranu przedstawiający okno dialogowe konfiguracji wykresu, trend oraz suma punktów historii.

Zapytanie dotyczące pozostałej i ukończonej pracy

Na podstawie procesu, do którego odwołuje się projekt, można przypisać następujące pola do zadań lub usterek.

Proces Dostępne pola
Agile Oryginalne oszacowanie, praca pozostała, ukończona praca
Scrum Praca pozostała
CMMI Oryginalne oszacowanie, praca pozostała, ukończona praca

Suma pozostałej pracy dla każdego dewelopera

Jeśli stosujesz praktyki Scrum i szacujesz pozostałą pracę dla swoich zadań i błędów, możesz uzyskać zestawienie tej pracy za pomocą następującego zapytania i wykresu. Użyj operatora In i dołącz zarówno zadanie, jak i usterkę, aby uwzględnić wszystkie usterki śledzone jako zadania.

Zrzut ekranu przedstawiający zapytanie o zadania i usterki sprintu.

Dodaj opcję Pozostała praca jako kolumna do zapytania i zapisz. Aby wyświetlić sumę pozostałej pracy, dodaj wykres przestawny, jak pokazano w poniższym przykładzie.

Zrzut ekranu przedstawiający okno dialogowe konfigurowania wykresu, przestawny, suma pozostałej pracy na dewelopera.

Aby uzyskać informacje na temat wykresów spalania sprintu zdefiniowanych przez system, zobacz Wykres spalania sprintu.

Pola używane do szacowania i śledzenia pracy

W poniższej tabeli opisano pola oparte na działaniach i liczbowe, których można użyć do śledzenia pracy. Aby uzyskać informacje na temat pól związanych z datą, takich jak Data rozpoczęcia, Data zakończenia i Data docelowa, zobacz Zapytanie według daty lub bieżącej iteracji.

nazwa pola

Opis

typ elementu roboczego


Działanie 1, 2

Typ działania wymaganego do wykonania zadania. Aby uzyskać więcej informacji na temat sposobu użycia tego pola, zobacz Planowanie pojemności. Dozwolone wartości to:

  • Wdrażania
  • Wzornictwo
  • Rozwój
  • Dokumentacja
  • Wymagania
  • Testowanie

Pole Działanie jest przypisywane do Activity w pliku ProcessConfiguration.3

Nazwa odwołania=Microsoft.VSTS.Common.Activity, Typ danych=Ciąg

Zadanie, usterka4 (Agile i Scrum)

Wartość biznesowa

Subiektywna jednostka miary, która przechwytuje względną wartość biznesową elementu lub funkcji listy prac produktu w porównaniu z innymi elementami tego samego typu. Element, który ma przypisaną wyższą liczbę, powinien być traktowany jako o większej wartości biznesowej niż element, któremu przypisano niższą liczbę.

Nazwa odwołania=Microsoft.VSTS.Common.BusinessValue, Typ danych=Liczba całkowita

Epos, funkcja

Zakończona praca

Ilość pracy poświęcanej na implementowanie zadania. Możesz określić pracę w godzinach lub w dniach. Nie ma żadnych nieodłącznych jednostek czasu skojarzonych z tym polem.

Nazwa odwołania=Microsoft.VSTS.Scheduling.CompletedWork, Typ danych=Double

Zadanie, usterka4

Dyscyplina 1, 2

Typ działania lub dyscypliny przypisanej do zadania. Aby dowiedzieć się więcej na temat sposobu użycia tego pola, zobacz Planowanie pojemności. Dozwolone wartości to:

  • Analiza
  • Rozwój
  • Sprawdzian
  • Edukacja użytkowników
  • Środowisko użytkownika

Pole Dyscyplina jest przypisywane do Activity w pliku ProcessConfiguration.3

Nazwa odwołania=Microsoft.VSTS.Common.Dyscyplina, Typ danych=Łańcuch znaków

Zadanie, usterka 4 (CMMI)

Wysiłek

Subiektywna jednostka miary, która odzwierciedla rozmiar usterki lub elementu rejestru prac nad produktem. Jeśli przypiszesz więcej wysiłku do elementu, oznaczasz, że do zaimplementowania tego elementu jest wymagana większa praca.

To pole 3 służy również do obliczania szybkości zespołu i prognozowania. Zostanie on przypisany do Effort w pliku ProcessConfiguration.

Nazwa odwołania=Microsoft.VSTS.Scheduling.Effort, Typ danych=Double

Element backlogu produktu, usterka 4 (Scrum)

Funkcja, Epika

Punkty historii

Subiektywna jednostka miary, która przechwytuje rozmiar historii użytkownika. Jeśli przypiszesz więcej punktów do scenariusza użytkownika, oznacza to, że do jej zaimplementowania jest wymagana większa praca.

To pole 3 służy również do obliczania szybkości zespołu i prognozowania. Zostanie on przypisany do Effort w pliku ProcessConfiguration.

Nazwa odwołania= Microsoft.VSTS. Scheduling.StoryPoints, Typ danych= Double

Historia użytkownika, usterka 4 (Agile)

Rozmiar

Subiektywna jednostka miary, która przechwytuje rozmiar wymagania. Im większy rozmiar, tym więcej pracy jest wymagane do jego zaimplementowania.

To pole3 służy również do obliczania szybkości i prognozowania zespołu. Zostanie on przypisany do Effort w pliku ProcessConfiguration.

Nazwa odwołania= Microsoft.VSTS. Harmonogramowanie. Rozmiar, Typ danych= Podwójne

Wymaganie, usterka 4 (CMMI)

Oryginalne oszacowanie

Ilość pracy wymaganej do wykonania zadania. Możesz określić pracę w godzinach lub w dniach. Nie ma żadnych nieodłącznych jednostek czasu skojarzonych z tym polem.

Nazwa odwołania=Microsoft.VSTS.Scheduling.OriginalEstimate, Typ danych=Double

Zadanie, usterka 4 (Agile i CMMI)

Pozostała praca

Ilość pracy, która pozostaje do ukończenia zadania. Możesz określić pracę w godzinach lub w dniach. Nie ma żadnych nieodłącznych jednostek czasu skojarzonych z tym polem. To pole 3 służy również do obliczania spalenia. Zostanie on przypisany do type="RemainingWork" w pliku ProcessConfiguration.

Notatka

W przypadku usługi Azure Boards tablica zadań zawsze wyświetla wartość "h" w relacji z pozostałymi zadaniami. W przypadku serwera TFS można zmodyfikować plik ProcessConfiguration dla pola Pozostały typ pracy, aby określić wartość "d" dla dni lub inną preferowaną etykietę.

Nazwa odwołania=Microsoft.VSTS.Scheduling.RemainingWork, Typ danych=Double

Zadanie, usterka4

Wymaga przeglądu

Wskazuje, że zadanie wymaga przeglądu. Możesz określić Tak lub Nie (ustawienie domyślne).

Nazwa odwołania=Microsoft.VSTS.CMMI.RequiresReview, Typ danych=String

Zadanie (CMMI)

Wymaga testu

Wskazuje, że zadanie wymaga testu. Możesz określić Tak lub Nie (ustawienie domyślne).

Nazwa odwołania=Microsoft.VSTS.CMMI.RequiresTest, Typ danych=Ciąg

Zadanie (CMMI)

Typ zadania1

Określa rodzaj zadania do zaimplementowania. Dozwolone wartości to:

  • Akcja naprawcza
  • Działanie zaradcze
  • Zaplanowany

Nazwa odwołania=Microsoft.VSTS.CMMI.TaskType, Typ danych=Ciąg

Zadanie, usterka4 (proces CMMI)

Notatka

  1. Aby zmienić wybór menu: w przypadku usług w chmurze lub procesu dziedziczonego zobacz Dodawanie pól i zarządzanie nimi; i w przypadku lokalnego procesu XML zobacz Dodawanie lub modyfikowanie pola, dostosowywanie listy wyboru.
  2. Wartości wyświetlane na stronie Kapacitet dla Działania (Agile lub Scrum) lub Dyscyplina (CMMI) odzwierciedlają połączenie wszystkich wartości zdefiniowanych dla pola dla wszystkich projektów w ramach danej kolekcji projektów. W związku z tym, aby ograniczyć wyświetlane wartości dla zdolności na stronach spisu prac sprintu, należy uzgodnić wartości we wszystkich projektach dla pola przypisanego do type="Activity".
  3. Aby zmienić przypisanie pola ProcessConfiguration (tylko lokalnie), zobacz odniesienie do elementu XML konfiguracji procesu.
  4. Każdy zespół może skonfigurować swoje narzędzia Agile, aby określić, czy usterki są traktowane podobnie do wymagań lub zadań. Ponieważ usterki mogą pojawiać się z wymaganiami lub zadaniami, pola używane do szacowania nakładu pracy na poziomie wymagań i poziomu zadania są uwzględniane w formularzu elementu roboczego.

Następne kroki

REST API

Aby programowo korzystać z zapytań, zobacz jeden z następujących zasobów interfejsu API REST: