Udostępnij za pośrednictwem

Wykonywanie zapytań według obszaru lub ścieżki iteracji

  • Artykuł

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

Ścieżka obszaru i ścieżka iteracji to dwa pola, które są wyświetlane w formularzu śledzenia zadań dla wszystkich rodzajów elementów pracy. Definiujesz je dla projektu — ścieżki obszarui oraz ścieżki iteracji i— a następnie wybierasz te, które chcesz skojarzyć z zespołem.

Aby lepiej zrozumieć, jak pracować ze ścieżkami obszaru i iteracji, zobacz sekcję Informacje o zespołach i narzędziach Agile.

Warunki wstępne

  • 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:Contribute uprawnienia 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 do projektu publicznego mają pełny dostęp do funkcji zapytań, tak jak użytkownicy z dostępem Basic. Aby uzyskać więcej informacji, zobacz Szybkie odniesienie dla interesariuszy.

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

Notatka

Następujące makra są obsługiwane tylko w portalu internetowym: @CurrentIteration, @CurrentIteration +/- n, @Follows, @MyRecentActivity, @RecentMentions, @RecentProjectActivityi @TeamAreas. Zapytania zawierające te makra nie będą działać po otwarciu w programie Visual Studio/Team Explorer, Microsoft Excel lub Microsoft Project.

Obsługiwane operatory i makra

Podczas tworzenia zapytań i określania pól Ścieżka obszaru i Ścieżka iteracji można użyć następujących operatorów:

Operator Użyj, kiedy chcesz...
= Określ jeden konkretny obszar lub ścieżkę iteracji
<> Odfiltruj jeden, konkretny obszar lub ścieżkę iteracji.
In Filtruj dla zestawu ścieżek obszaru lub iteracji.
Not In Wyklucz elementy przypisane do zestawu ścieżek obszaru lub iteracji.
Under Określ wszystkie ścieżki znajdujące się pod wybranym obszarem lub ścieżką iteracji.
Not Under Wyklucz elementy przypisane do określonego obszaru lub ścieżki iteracji.

Wraz z tymi operatorami można użyć następujących makr po wybraniu ścieżki iteracji. Aby zapoznać się z przykładami, zobacz Zapytanie według daty lub bieżącej iteracji.

Makro Użyj, gdy chcesz...
@CurrentIteration Określ bieżącą iterację, która jest skojarzona z wybranym kontekstem zespołu.
@CurrentIteration +/- n Filtruj elementy na podstawie przypisania do zmieniającego się okna sprintów powiązanych z wybranym kontekstem zespołowym.
@TeamAreas Filtruj elementy na podstawie ścieżek obszaru przypisanych do określonego zespołu.

Notatka

Makra @CurrentIteration +/- n i @TeamAreas są obsługiwane w przypadku usługi Azure DevOps Server 2019 i nowszych wersji. Te makra są obsługiwane tylko w portalu internetowym. Zapytania zawierające te makra nie będą działać po otwarciu w programie Visual Studio/Team Explorer, Microsoft Excel lub Microsoft Project.

Zapytania dotyczące ścieżki obszaru

Można określić, aby filtrować elementy robocze przypisane do kilku ścieżek obszaru przy użyciu operatora W, jak pokazano w poniższym przykładzie.

zapytanie dotyczące ścieżki obszaru dla różnych obszarów

Nazwa węzła i zapytania oparte na słowach kluczowych

Użyj pola Nazwa węzła, aby przefiltrować elementy robocze przypisane do określonych ścieżek obszaru zgodnie ze słowem kluczowym przy użyciu operatora Zawiera. Nazwa węzła określa ostatni węzeł ścieżki obszaru , który odpowiada ostatniemu węźle w hierarchii drzewa.

Poniższe zapytanie daje taki sam wynik jak w poprzednim przykładzie.

zapytanie dotyczące nazw węzłów dla kilku obszarów

W tym przykładzie filtr zwraca wszystkie elementy robocze przypisane do ścieżki obszaru, której ostatni węzeł zawiera słowo "Azure".

Zapytanie o kilka sprintów

Oto inny przykład, który używa nazwy węzła i operatora w.

zapytanie o nazwę węzła dla kilku obszarów

Zapytania dotyczące ścieżki obszaru zespołu

Użyj makra @TeamAreas, aby szybko znaleźć elementy przypisane do ścieżek obszaru przypisanych do określonego zespołu. Określ operator =. Edytor zapytań automatycznie monituje o wprowadzenie nazwy zespołu. Możesz go dodać, wprowadzając nazwę zespołu i wybierając wartość zespołu wyświetlaną w kryteriach filtru wyszukiwania.

Zapytanie dotyczące ścieżek obszaru przypisanych do zespołu

Odniesienie do pola klasyfikacji

nazwa pola Opis nazwa odwołania
ścieżki obszaru Elementy robocze są grupowane w obszary związane z funkcjami produktu lub zespołu. Obszar musi być prawidłowym węzłem w hierarchii projektu. System.AreaPath
ścieżka iteracji Grupuje elementy robocze według zdefiniowanych sprintów lub okresów czasu. Iteracja musi być prawidłowym węzłem w hierarchii projektu. System.IterationPath

Dla każdego pola ścieżka danych =TreePath, typ raportu =Dimension, atrybut indeksu =True.

Jeśli zdefiniujesz nazwę ścieżki, która jest dłuższa niż 256 znaków, nie można jej określić w programie Microsoft Project. Aby uniknąć tego problemu, zdefiniuj nazwy ścieżek nie przekraczające 10 znaków i nie zagnieżdżaj węzłów na więcej niż 14 poziomach.

Nie można zastosować większości reguł pól do pól systemowych, takich jak Pola System.AreaPath i System.IterationPath. Aby uzyskać więcej informacji, zobacz Reguły i ocena reguł.

Następujące pola nie są wyświetlane w formularzach elementów roboczych, ale są śledzone dla każdego typu elementu roboczego. Te pola zawierają wartość liczbową dla każdej wartości klasyfikacji zdefiniowanej dla projektu. Tych pól można używać do filtrowania zapytań i tworzenia raportów.

nazwa pola Opis nazwa odwołania typ danych
Identyfikator obszaru Unikatowy identyfikator obszaru, do którego przypisano ten element roboczy. System.AreaId Liczba całkowita
Identyfikator iteracji Unikatowy identyfikator iteracji, do której przypisano ten element roboczy. System.IterationId Liczba całkowita
Nazwa węzła Nazwa ostatniego węzła ścieżki obszaru. Jeśli na przykład ścieżka obszaru to "Projekt\A1\B2\C3", nazwa węzła to C3. System.NodeName Struna

Domyślny typ do zgłoszenia to brak. Identyfikator obszaru i identyfikator iteracji są indeksowane, nazwa węzła nie jest indeksowana. Aby dowiedzieć się więcej o atrybutach pól, zobacz Pola i atrybuty elementu roboczego.

REST API

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