Udostępnij za pośrednictwem


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

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 pracy dla wszystkich typów elementów roboczych. Definiujesz je dla projektu — ścieżki obszaru i ścieżki iteracji — a następnie wybierasz te, które chcesz skojarzyć z zespołem.

Aby lepiej zrozumieć, jak pracować ze ścieżkami obszaru i iteracji, zobacz About teams and Agile tools (Informacje o zespołach i narzędziach Agile).

Uwaga

Następujące makra są obsługiwane tylko w portalu internetowym: @CurrentIteration, @CurrentIteration +/- n, @Follows, @MyRecentActivity, @RecentMentions, @RecentProjectActivity i @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 polecenia , gdy chcesz...
= Określ jeden konkretny obszar lub ścieżkę iteracji
<> Odfiltruj jedną, konkretną ścieżkę obszaru lub 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 w obszarze zaznaczenia lub ścieżki iteracji.
Not Under Wyklucz elementy przypisane w określonym obszarze lub ścieżce 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 polecenia , gdy chcesz...
@CurrentIteration Określ bieżącą iterację skojarzoną z wybranym kontekstem zespołu.
@CurrentIteration +/- n Filtruj elementy na podstawie przypisania do przesuwanego okna przebiegów skojarzonych z wybranym kontekstem zespołu.
@TeamAreas Filtruj elementy na podstawie ścieżek obszaru przypisanych do określonego zespołu.

Uwaga

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 In , jak pokazano w poniższym przykładzie.

Zapytanie dotyczące ścieżki obszaru dla kilku obszarów

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

Użyj pola Nazwa węzła, aby filtrować elementy robocze przypisane do ścieżek obszaru na podstawie słowa kluczowego przy użyciu operatora Contains. Nazwa węzła określa ostatni węzeł ścieżki obszaru, który odpowiada ostatniemu węzłowi w hierarchii drzewa.

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

Zapytanie w polu Nazwa węzła 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".

Wykonywanie zapytań dotyczących kilku przebiegów

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

Zapytanie w polu Nazwa 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 Power Query 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.

Wykonywanie zapytań dotyczących ścieżek obszaru przypisanych do zespołu

Dokumentacja pola klasyfikacji

Nazwa pola Opis Nazwa odwołania
Ścieżka obszaru Grupuje elementy robocze w obszarach funkcji 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 nazwanych przebiegów lub okresów. 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 więcej niż 10 znaków i nie zagnieżdżaj więcej niż 14 poziomów głębokości.

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 Integer
Identyfikator iteracji Unikatowy identyfikator iteracji, do której przypisano ten element roboczy. Identyfikator System.IterationId Integer
Nazwa węzła Nazwa ostatniego węzła ścieżki obszaru. Jeśli na przykład ścieżka obszaru to Project\A1\B2\C3, nazwa węzła to C3. System.NodeName String

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

Interfejs API REST

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