Dodawanie tagów elementów roboczych w celu kategoryzowania i filtrowania list i tablic

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Oznaczaj elementy robocze, aby szybko filtrować backlog produktu lub zapytanie o element roboczy według zdefiniowanych przez ciebie kategorii. Tag odpowiada jednej lub dwóch zdefiniowanych fraz kluczowych. Tag obsługuje potrzeby filtrowania listy prac lub zapytania albo definiowania zapytania.

Tagi można dodawać i modyfikować z poziomu portalu internetowego lub z poziomu wtyczki programu Team Explorer dla Visual Studio. A także można otworzyć w programie Excel zapytanie w celu zbiorczego modyfikowania tagów.

Tagi są lepszym wyborem do filtrowania elementów roboczych niż używanie ciągów tekstowych zgodnie z opisem w artykule Definiowanie zapytania elementu roboczego. Tagi są zasobem udostępnionym skojarzonym z danym projektem, a nie zespołem. Jeśli projekt zawiera wiele zespołów, wszystkie zespoły dodają i pracują z tego samego zestawu tagów.

Tip

Możesz użyć sztucznej inteligencji, aby pomóc w tym zadaniu w dalszej części tego artykułu lub zapoznać się z Włączenie pomocy dotyczącej sztucznej inteligencji przy użyciu serwera Azure DevOps MCP.

Prerequisites

Category	Requirements
uprawnienia	— Aby wyświetlać, śledzić i edytować elementy robocze: Wyświetl elementy robocze w tym węźle i Edytuj elementy robocze w tym węźle uprawnienia ustawione na Zezwalaj. Domyślnie grupa Współautorzy ma te uprawnienia. Aby uzyskać więcej informacji, zobacz Ustaw uprawnienia do śledzenia pracy. — Aby dodać tagi do elementów roboczych: Utwórz nową definicję tagu na poziomie projektu z uprawnieniem ustawionym na Zezwalaj. Domyślnie grupa Współautorzy ma to uprawnienie.
Poziomy dostępu	- członek projektu. — Aby dodać nowe tagi do elementów roboczych lub wyświetlić lub śledzić pull requesty: podstawowy dostęp, co najmniej. - Aby wyświetlić lub śledzić elementy robocze: wymagany jest co najmniej poziom dostępu interesariusza. Aby uzyskać więcej informacji, zobacz About access levels (Informacje o poziomach dostępu). — Wszyscy członkowie projektu, w tym członkowie grupy Czytelnicy , mogą wysyłać wiadomości e-mail zawierające elementy robocze.

Note

• Zapewnij dostęp dla interesariuszy członkom, którzy chcą wziąć udział w dyskusji i przeglądzie postępów. Ci członkowie zazwyczaj nie współtworzyją kodu, ale chcą wyświetlać elementy robocze, listy prac, tablice i pulpity nawigacyjne.
• Domyślnie wszyscy Współautorzy i Uczestnicy w projektach publicznych mogą dodawać tagi, zarówno nowe, jak i istniejące. W projektach prywatnych uczestnicy projektu mogą dodawać tylko istniejące tagi. Aby kontrolować możliwość tworzenia nowych tagów, na poziomie projektu należy ustawić uprawnienie Utwórz definicję tagu. Aby uzyskać więcej informacji, zobacz Zmiana uprawnień na poziomie projektu.

Dodawanie tagów do elementu roboczego

Tagi powinny zawierać maksymalnie 400 znaków i nie zawierać separatorów, takich jak , (przecinek), ; (średnik) ani inny znak formatowania.

Zalecenie: nie używaj @ znaku w tagu. Tagi zaczynające się od znaku @ nie mogą być używane w zapytaniu elementu roboczego. Znak @ oznacza makro w zapytaniu i dlatego tag nie jest rozpoznawany jako tag.

W portalu internetowym otwórz element roboczy i dodaj tag. Wybierz pozycję Dodaj tag i wpisz słowo kluczowe. Możesz też wybrać z listy wcześniej przypisanych tagów.

Aby dodać kilka tagów jednocześnie, wpisz przecinek między tagami. Tagi są rozróżniane według wielkości liter.

Tagi wyświetlane na pasku tagu są już przypisane do elementu roboczego. Aby cofnąć przypisanie tagu, wybierz znak x w tagu .

Zbiorcze dodawanie lub usuwanie tagów

Możesz zbiorczo aktualizować elementy robocze, aby dodawać lub usuwać tagi z portalu internetowego. Tagi są modyfikowane zbiorczo w taki sam sposób, jak zbiorcze modyfikowanie innych pól przy użyciu portalu internetowego. Możesz też użyć programu Excel do zbiorczego dodawania lub usuwania tagów.

Note

Tablice nie obsługują zbiorczego modyfikowania tagów z Visual Studio lub innych klientów.

Wykonywanie zapytań o elementy robocze na podstawie tagów

Aby wykonywać zapytania dotyczące elementów roboczych na podstawie tagów, dodaj klauzulę dla każdego tagu, którego chcesz użyć do obsługi zapytania.

Tip

Aby zrozumieć sposób AND/OR grupowania klauzul, zobacz Klauzule grupy. Aby wyświetlić składnię WIQL dla zapytania, zainstaluj rozszerzenie edytora zapytań WIQL, które umożliwia wyświetlenie wersji WIQL dowolnego wpisu edytora zapytań.

Możesz użyć operatorów Zawiera lub Nie zawiera . Tagi rozpoczynające się od @ znaku nie mogą być używane w zapytaniu elementu roboczego, ponieważ edytor zapytań interpretuje @ znak jako makro. Aby uzyskać więcej informacji, zobacz Definiowanie zapytania elementu roboczego.

Oto zapytanie dotyczące wszystkich elementów roboczych oznaczonych jako Web lub Service.

Note

Nie można wykonywać zapytań dotyczących elementów roboczych, które nie mają dołączonych tagów. Jeśli chcesz zagłosować na prośbę o wprowadzenie tej funkcji, możesz to zrobić na naszej stronie Społeczności Deweloperów, Bądź w stanie wyszukać puste tagi.

Pokaż tagi w backlogu lub wynikach zapytania

Wybierz Opcje kolumny, aby dodać pole Tagi do listy prac produktu lub zapytania elementu roboczego. Jeśli opcja nie zostanie wyświetlona, wybierz pozycję Więcej poleceń, aby ją wybrać z menu opcji.

Zostaną wyświetlone wszystkie tagi dodane do wymienionych elementów roboczych.

Filtrowanie list przy użyciu tagów

W portalu internetowym można filtrować listy prac, tablice i wyniki zapytań przy użyciu tagów.

Zacznij od wybrania opcji Filtruj .

Wybierz tagi, dla których chcesz filtrować. Zachowaj zaznaczenie opcji OR, aby uruchomić logiczne OR dla wszystkich wybranych tagów. Możesz też wybrać opcję AND , aby uruchomić operator logiczny AND na wszystkich wybranych tagach.

Usuwanie, usuwanie tagów lub zarządzanie nimi

Nie można usunąć tagów przy użyciu interfejsu użytkownika sieci Web Azure DevOps.

Jeśli musisz usunąć tag, utwórz skrypt lub aplikację, która może zostać usunięta przy użyciu interfejsu API REST Azure DevOps lub biblioteki klienta .NET. Aby uzyskać więcej przykładów, zobacz Azure-DevOps-Admin-CLI.

Inną opcją jest zainstalowanie Menedżera Tagów Marketplace, który dodaje stronę Tagi w obszarze Tablice lub Praca w celu zarządzania tagami, w tym także możliwość usuwania.

Oznaczanie tagów kolorami na tablicach

Wyróżnianie tagów na kartach tablicy przez ich kodowanie kolorami. Te kolory są wyświetlane tylko na skonfigurowanej tablicy. Nie są one wyświetlane na listach prac ani na tablicach zadań. Aby uzyskać więcej informacji, zobacz Przypisywanie kolorów tagów.

Wykres elementów roboczych i grupowanie według tagów

Nie można grupować wykresu opartego na zapytaniach według tagów, ale możesz pogrupować widżet Wykres dla elementów roboczych według tagów dodanych do pulpitu nawigacyjnego. Ta funkcja jest dostępna w publicznej wersji zapoznawczej. Aby ją włączyć, zobacz Zarządzaj funkcjami i włącz opcję Włącz grupowanie według tagów dla widżetu wykresu elementów roboczych na pulpicie nawigacyjnym.

Aby pogrupować widżet Wykres dla elementów roboczych według tagów, wykonaj te same kroki opisane w temacie Dodawanie wykresu do pulpitu nawigacyjnego. Upewnij się, że zapytanie flat-list zawiera tagi w klauzuli query lub jako opcję kolumny. Następnie wybierz opcję Tagi w opcji Grupuj według. Aby przefiltrować wykres w celu wyświetlenia tylko niektórych tagów, wybierz przycisk radiowy Wybrane tagi , a następnie wybierz tagi, które mają być wyświetlane na wykresie.

Limity liczby tagów

Chociaż nie istnieje żaden twardy limit, tworzenie ponad 100 000 tagów dla kolekcji projektów może negatywnie wpłynąć na wydajność. Ponadto menu rozwijane autouzupełniania dla kontrolki tagu wyświetla maksymalnie 200 tagów. Gdy zdefiniowano więcej niż 200 tagów, zacznij wprowadzać, aby spowodować wyświetlenie odpowiednich tagów przez kontrolkę tagu.

Nie można przypisać więcej niż 100 tagów do elementu roboczego lub otrzymasz następujący komunikat:

TF401243: Failed to save work item because too many new tags were added to the work item.

Zapisz element roboczy z dodanymi tagami (co najmniej 100), a następnie możesz dodać więcej tagów.

Ogranicz zapytania do mniej niż 25 tagów. Jeśli ilość przekracza tę wartość, zapytanie prawdopodobnie przekroczy limit czasu.

Używanie sztucznej inteligencji do wykonywania zapytań dotyczących tagów elementów roboczych i zarządzania nimi

Jeśli masz Azure Boards MCP Server połączony z agentem sztucznej inteligencji w trybie agenta, możesz użyć monitów języka naturalnego, aby znaleźć i zaktualizować elementy robocze na podstawie tagów.

Zadanie	Przykładowy monit
Znajdowanie elementów oznakowanych	Find all active work items tagged with "security" in my project
Zbiorcze dodawanie tagów	Add the tag "tech-debt" to all active bugs in the current sprint
Znajdowanie nieoznakowanych elementów	List work items with no tags assigned in the <Contoso> area path
Wykonywanie zapytań według wielu tagów	Find user stories tagged with both "performance" and "P1"
Wyświetlanie listy wszystkich używanych tagów	Show all distinct tags used on work items in project <Contoso> sorted by usage count
Czyszczenie przestarzałych tagów	List tags in <Contoso> that are used on fewer than 2 work items
Zamień tag	Find all work items in <Contoso> tagged "wontfix" and replace that tag with "by-design"
Taguj według kryteriów	Add tag "needs-review" to all user stories in <Contoso> that were resolved in the last week but have no linked pull request
Analizowanie wzorców tagów	Show the count of active work items per tag in area path <Contoso\\Frontend>
Znajdowanie niezgodności tagów	List work items in <Contoso> tagged "sprint-goal" that aren't assigned to the current sprint

Note

Tryb agenta i serwer MCP używają języka naturalnego, dzięki czemu można dostosować te wskazówki lub zadać pytania w celu doprecyzowania wyników.

Treści powiązane

• Zdefiniowanie zapytania dla elementu roboczego
• Dostosowywanie kart na tablicy
• Zbiorcze modyfikowanie elementów roboczych z internetowego portalu
• Zbiorcze modyfikowanie elementów roboczych za pomocą Excela

Rozszerzenie witryny Marketplace

• Menedżer tagów witryny Marketplace