Werkitemtags toevoegen om lijsten en borden te categoriseren en te filteren

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

Tag werkitems om snel de productachterstand of een werkitemquery te filteren op categorieën die u definieert. Een tag komt overeen met een of twee trefwoordtermen die u definieert. Een tag helpt bij het filteren van een backlog of query, of bij het definiëren van een query.

U kunt tags toevoegen en wijzigen vanuit de webportal of vanuit de Team Explorer-invoegtoepassing voor Visual Studio. U kunt ook een query openen in Excel om tags bulksgewijs te wijzigen.

Tags zijn een betere keuze voor het filteren van werkitems dan het gebruik van tekenreeksen, zoals beschreven in Een werkitemquery definiëren. Tags zijn een gedeelde bron die is gekoppeld aan een project en niet aan een team. Als uw project meerdere teams bevat, voegen alle teams toe aan en werken ze vanuit dezelfde set tags.

Prerequisites

Category	Requirements
Permissions	- Werkitems weergeven, volgen en bewerken: Werkitems weergeven in dit knooppunt en Werkitems bewerken in dit knooppunt machtigingen ingesteld op Toestaan. De groep Inzenders heeft standaard deze machtigingen. Voor meer informatie, zie Machtigingen voor het bijhouden van werk instellen. - De tags toevoegen aan werkitems: Op projectniveau Nieuwe tagdefinitie maken machtiging instellen op Toestaan. De groep Inzenders heeft standaard deze machtiging.
Toegangsniveaus	- Projectlid. - Om nieuwe tags toe te voegen aan werkitems of om pull-aanvragen te bekijken of te volgen: ten minste Basic toegang. - Werkitems weergeven of volgen: minimaal Stakeholder toegang. Zie Over toegangsniveaus voor meer informatie. - Alle projectleden, inclusief leden in de groep Lezers , kunnen e-mailberichten met werkitems verzenden.

Note

• Geef leden Stakeholder toegang die een bijdrage willen leveren aan de discussie en de voortgang willen bekijken. Deze leden dragen doorgaans niet bij aan code, maar willen werkitems, achterstanden, borden en dashboards bekijken.
• Standaard kunnen alle inzenders en belanghebbenden in openbare projecten nieuwe en bestaande tags toevoegen. In privéprojecten kunnen belanghebbenden alleen bestaande tags toevoegen. Om de mogelijkheid te beheersen om nieuwe tags te maken, stelt u de machtigingen voor Tagdefinitie maken op projectniveau in. Voor meer informatie, zie Projectniveau machtigingen wijzigen.

Tags toevoegen aan een werkitem

Tags moeten 400 tekens of minder zijn en mogen geen scheidingstekens bevatten, zoals een , (komma), ; (puntkomma) of een ander opmaakteken.

Aanbeveling: gebruik het @ teken niet in een tag. Tags die beginnen met het @ teken kunnen niet worden gebruikt in een werkitemquery. Het @ teken geeft een macro in een query aan en daarom wordt de tag niet herkend als een tag.

Open vanuit de webportal een werkitem en voeg een tag toe. Kies Tag toevoegen en typ uw trefwoord. Of selecteer in de lijst met eerder toegewezen tags.

Als u meerdere tags tegelijk wilt toevoegen, typt u een komma tussen tags. Tags zijn hoofdlettergevoelig.

Tags die worden weergegeven in de tagbalk, zijn al toegewezen aan het werkitem. Als u een tag wilt intrekken, kiest u de x op de tag.

Tags bulksgewijs toevoegen of verwijderen

U kunt werkitems bulksgewijs bijwerken om tags toe te voegen aan of te verwijderen uit de webportal. U wijzigt tags bulksgewijs op dezelfde manier als u andere velden bulksgewijs wijzigt met behulp van de webportal. Of u kunt Excel gebruiken om tags bulksgewijs toe te voegen of te verwijderen.

Note

Borden bieden geen ondersteuning voor het bulksgewijs wijzigen van tags vanuit Visual Studio of andere clients.

Query's uitvoeren op werkitems op basis van tags

Als u een query wilt uitvoeren op werkitems op basis van tags, voegt u een voorwaarde toe voor elke tag die u wilt gebruiken.

Tip

Zie Groepsclausules voor meer informatie over AND/OR de groepering van componenten. Als u de WIQL-syntaxis voor een query wilt weergeven, installeert u de EXTENSIE van de WIQL-queryeditor, waarmee u de WIQL-versie van een queryeditor-vermelding kunt zien.

U kunt de operatoren Bevat of Bevat Niet gebruiken. Tags die beginnen met het @ teken kunnen niet worden gebruikt in een werkitemquery, omdat de queryeditor het @ teken interpreteert als een macro. Zie Een werkitemquery definiëren voor meer informatie.

Hier volgt bijvoorbeeld een query voor alle werkitems die zijn gelabeld als Web of Service.

Note

U kunt geen query's uitvoeren op werkitems waaraan geen tags zijn gekoppeld. Als u wilt stemmen op de aanvraag om deze functie te ondersteunen, kunt u dit doen op onze pagina ontwikkelaarscommunity, kunt u zoeken naar lege tags.

Tags weergeven in uw achterstands- of queryresultaten

Kies Kolomopties om het veld Tags toe te voegen aan de productachterstand of een query voor werkitems. Als de optie niet wordt weergegeven, kiest u Meer opdrachten om deze te selecteren in het menu met opties.

Alle tags die zijn toegevoegd aan de vermelde werkitems, worden weergegeven.

Lijsten filteren met behulp van tags

Vanuit de webportal kunt u achterstanden, borden en queryresultaten filteren met behulp van tags.

Begin met het kiezen van Filter .

Selecteer de tags waarop u wilt filteren. Behoud de OR-selectie om een logische OR uit te voeren voor alle tags die u hebt geselecteerd. Of kies de optie AND om een logische AND uit te voeren op alle geselecteerde tags.

Tags verwijderen, verwijderen of beheren

U kunt tags niet verwijderen met behulp van de Azure DevOps-webgebruikersinterface.

Als u een tag wilt verwijderen, maakt u een script of toepassing die kan worden verwijderd met behulp van de Azure DevOps REST API of de .NET-clientbibliotheken. Zie Azure-DevOps-Admin-CLI voor meer voorbeelden.

Een andere optie is om Marketplace Tags Manager te installeren, waarmee een pagina Tags wordt toegevoegd onder Borden of Werk voor het beheren van tags, inclusief verwijderingen.

Kleurcodetags op borden

Markeer tags op bordkaarten door ze een kleurcode te geven. Deze kleuren worden alleen weergegeven op het bord dat u configureert. Ze worden niet weergegeven op backlogs of taakborden. Zie Tagkleuren toewijzen voor meer informatie.

Werkitems in kaart brengen en groeperen op tags

U kunt een grafiek op basis van query's niet groeperen op tags, maar u kunt een widget Grafiek voor Werkitems groeperen op tags die u aan een dashboard toevoegt. Deze functie is beschikbaar voor openbare preview. Als u dit wilt inschakelen, gaat u naar Functies beheren of inschakelen en zet u Groeperen op tags voor de werkitemgrafiekwidget op het dashboard inschakelen aan.

Als u een widget Grafiek voor Werkitems op tags wilt groeperen, voert u dezelfde stappen uit als in Een grafiek toevoegen aan een dashboard. Zorg ervoor dat uw platte-lijstquery Tags bevat, ofwel in de queryclausule of als kolomoptie. Kies vervolgens Tags voor de groeperen op selectie. Als u de grafiek wilt filteren om slechts enkele tags weer te geven, kiest u het keuzerondje Geselecteerde tags en kiest u vervolgens de tags die u in de grafiek wilt weergeven.

Limieten voor het aantal tags

Hoewel er geen vaste limiet bestaat, kan het maken van meer dan 100.000 tags voor een projectverzameling de prestaties negatief beïnvloeden. In het automatisch aanvullen-menu voor de tagcontrole worden maximaal 200 tags weergegeven. Wanneer er meer dan 200 tags zijn gedefinieerd, begint u met invoeren om ervoor te zorgen dat het labelbeheer relevante tags weergeeft.

U kunt niet meer dan 100 tags toewijzen aan een werkitem of u ontvangt het volgende bericht:

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

Sla het werkitem op met de tags (100 of minder) die u hebt toegevoegd en vervolgens kunt u meer tags toevoegen.

Beperk query's tot minder dan 25 tags. Meer dan die hoeveelheid dan loopt de query waarschijnlijk vast.

Verwante inhoud

• Een werkitemquery definiëren
• Kaarten op een bord aanpassen
• Werkitems bulksgewijs wijzigen vanuit de webportal
• Werkitems in bulk wijzigen van Excel

Marketplace-extensie

• Marketplace Tags Manager