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.
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.
W tym przykładzie filtr zwraca wszystkie elementy robocze przypisane do ścieżki obszaru, której ostatni węzeł zawiera słowo "Azure".
Oto inny przykład, który używa nazwy węzła i operatora In.
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.
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.
Powiązane artykuły
- Krótki przewodnik dotyczący zapytań
- Definiowanie ścieżek obszarów i przypisywanie do zespołu
- Definiowanie ścieżek iteracji (przebiegu) i konfigurowanie iteracji zespołu
- Ustawianie uprawnień i dostępu do śledzenia pracy
Interfejs API REST
Aby programowo korzystać z zapytań, zobacz jeden z następujących zasobów interfejsu API REST: