Werkitemsjablonen gebruiken

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

Visual Studio 2022 | Visual Studio 2019 | Visual Studio 2017 | Visual Studio 2015

Gebruik werkitemsjablonen om werkitems met vooraf gedefinieerde waarden te maken en consistente updates toe te passen op vergelijkbare items. Dit artikel bevat informatie over sjabloonwerkstromen in de webportal en, voor verouderde omgevingen, in Visual Studio 2015 of eerder. Zie Voorbeeldsjablonen voor werkitems voor voorbeelden.

Gebruik voor de meeste teams de webportal. Gebruik Visual Studio 2015 alleen met Power Tools als u nog steeds afhankelijk bent van sjabloonbeheer op basis van Team Explorer.

Sjablonen voor werkitems verschillen van processjablonen. Zie Voor achtergrondinformatie over processen en processjablonen en de standaardprocesrichtlijnen voor Basic, Agile, Scrum en Capability Maturity Model Integration (CMMI).

Tip

U kunt AI gebruiken om bij deze taak te helpen verderop in dit artikel, of zie AI-assistentie inschakelen met Azure DevOps MCP Server om te beginnen.

Uw werkstroom kiezen

Gebruik deze tabel om de beste werkstroom voor uw scenario te kiezen.

Als je wilt... Gebruik... Waarom
Sjablonen maken, beheren en toepassen in de huidige Azure DevOps Webportaal (primair) Ondersteunt sjablonen met teambereik in de standaardwebervaring.
Gedeelde standaardinstellingen opnieuw gebruiken op team- en werkitemtype Opgeslagen sjablonen Helpt teams consistente velden en waarden toe te passen.
Een directe koppeling delen waarmee een vooraf ingevuld werkitem wordt geopend Sjabloon-URL's Ideaal voor eenvoudig delen in dashboards, wiki’s en chats.
Werkstromen voor sjablonen op basis van Team Explorer voortzetten Visual Studio 2015 met Power Tools (verouderd) Gebruik alleen wanneer uw omgeving nog steeds afhankelijk is van verouderde hulpprogramma's.

Vereisten

Workflow Requirements
Webportaal (primair) - Toegang tot een Azure DevOps organisatie en project.
- Als u sjablonen wilt beheren, moet u lid zijn van het team dat eigenaar is van de sjablonen.
- Als u sjablonen wilt toepassen, hebt u inzendertoegang tot het project.
- Gebruik een ondersteunde browser en open Azure DevOps in de webportal.
Visual Studio 2015 met Power Tools (verouderd) - Gebruik deze werkstroom alleen als uw omgeving nog steeds afhankelijk is van teamverkenner-sjabloonbeheer.
- Installeer Microsoft Visual Studio Team Foundation Server 2015 Power Tools.
- Sjablonen die in deze werkstroom zijn gemaakt, hebben een gebruikersbereik en worden alleen weergegeven in Team Explorer.

Beperkingen voor het gebruik van sjablonen

Webportalsjablonen en Visual Studio sjablonen zijn afzonderlijke winkels. Een sjabloon die in de ene client is gemaakt, wordt niet weergegeven in de andere client.

Sjabloontype Scope Waar u deze kunt beheren Waar u deze kunt toepassen
Sjabloon voor webportal Teamgebonden Webportal Webportal
sjabloon voor Visual Studio Gebruikersbereik Visual Studio Visual Studio

U kunt de URL van beide sjabloontypen nog steeds gebruiken om werkitems te maken in de webportal.

Ondersteunde sjabloontaken

De beschikbaarheid van taken is afhankelijk van de client die u gebruikt. Gebruik de webportal voor primaire Azure DevOps werkstromen en gebruik Visual Studio 2015 met Power Tools alleen voor oudere scenario's.

In de volgende tabel ziet u ondersteuning per client.

Sjabloontaak Webportal Visual Studio
Een werkitem vastleggen als sjabloon ✅ Ondersteund ✅ Ondersteund
Sjablonen voor werkitems beheren
(Definieer, bewerken, verwijderen, koppeling kopiëren, kopie maken, hernoemen)
✅ Ondersteund ✅ Ondersteund
De koppeling (URL) van een sjabloon kopiëren ✅ Ondersteund ✅ Ondersteund
Een werkitem toevoegen met behulp van een sjabloon ✅ Ondersteund ✅ Ondersteund
Een werkitemsjabloon definiëren ✅ Ondersteund ✅ Ondersteund
Een sjabloon toepassen op een of meer werkitems ✅ Ondersteund ✅ Ondersteund
Tags toevoegen aan of verwijderen uit sjablonen ❌ Niet ondersteund ✅ Ondersteund
Een sjabloon definiëren met een hyperlink ✅ Ondersteund ❌ Niet ondersteund

Een werkitem vastleggen als sjabloon

Gebruik de procedure die overeenkomt met uw client: webportal (primair) of Visual Studio 2015 en eerder (verouderd).

Elke sjabloon die u in de webportal vastlegt, krijgt een unieke GUID. Gebruik de volgende stappen om een werkitem als sjabloon vast te leggen en de koppeling ervan te kopiëren.

  1. Open in de webportal het werkitem dat u wilt gebruiken als sjabloonbron.

  2. Selecteer aan de rechterkant Meer acties>Sjablonen>Vastleggen:

    Schermopname van het selecteren van de definitie van werkitemvelden als sjabloonoptie in het menu Meer acties.

  3. Configureer in Capture Template de vereiste en optionele velden:

    • Team (vereist): Selecteer het team dat u aan de sjabloon wilt koppelen.

    • Naam (vereist): Voer een sjabloonnaam in.

    • Velden: Gebruik Toevoegen om velden op te nemen, Verwijderen om velden te verwijderen en stel indien nodig veldwaarde in.

    • Notities: Sjablooncontext toevoegen. Wanneer u een werkitem maakt op basis van de sjabloon, wordt deze tekst weergegeven als het eerste item in de discussiethread .

    Schermopname van het configureren van velden in het dialoogvenster Capture-sjabloon in de webportal.

  4. Selecteer Opslaan en selecteer vervolgens Koppeling kopiëren om de sjabloon-URL te kopiëren.

    Gebruik de URL om werkitems van hetzelfde type te maken met vooraf gedefinieerde waarden. Zie Een werkitem maken op basis van een sjabloon-URL en een sjabloonkoppeling toevoegen aan een teamdashboard voor algemene scenario's voor delen.

  5. Controleer of de sjabloon wordt weergegeven in de sjabloonlijst van het geselecteerde team voor dat type werkitem. Met de gekopieerde koppeling wordt een nieuw werkitemformulier geopend met vooraf gedefinieerde waarden.

Sjablonen voor werkitems beheren

Voor elk type werkitem kunt u sjablonen bekijken en beheren die zijn gedefinieerd door uw team. U kunt een sjabloonkoppeling toevoegen, bewerken, kopiëren, verwijderen, hernoemen en kopiëren.

Gebruik deze stappen om werkitemsjablonen te openen in de webportal:

  1. Open Project instellingen in de webportal.

  2. Selecteer Onder Boardsde optie Teamconfiguratie.

  3. Als u een ander team wilt gebruiken, gebruikt u de selector Team in het kruimelpad.

  4. Selecteer Sjablonen op de pagina Borden:

    Schermopname waarin wordt getoond hoe u toegang hebt tot de lijst met opgeslagen sjablonen in Azure DevOps van Project-instellingen, Boards, Teamconfiguratie, Sjablonen.

  5. Selecteer een werkitemtype, zoals Bug, Feature of Test Case, om sjablonen voor dat type weer te geven of toe te voegen:

    Schermopname van sjablonen die zijn gedefinieerd voor het type bugwerkitem.

Een werkitemsjabloon maken

Gebruik deze stappen om een werkitemsjabloon te maken in de webportal:

  1. Selecteer nieuwe sjabloon op de pagina type werkitem:

    Schermopname die laat zien hoe u een nieuwe sjabloon toevoegt voor het werkitemtype Bug.

    Opmerking

    Als u markdown in een groot tekstveld wilt gebruiken, voegt u tags toe <br> om regeleinden te beheren en ervoor te zorgen dat markdown correct wordt weergegeven.

  2. Voer in het dialoogvenster Nieuwe sjabloon een naam in (vereist) en voeg vervolgens optionele velden en waarden toe.

  3. Selecteer Opslaan. De optie Koppeling kopiëren is beschikbaar.

  4. Selecteer Koppeling kopiëren om de sjabloon-URL te kopiëren.

  5. Controleer of de sjabloon wordt weergegeven voor het geselecteerde type werkitem en of met de gekopieerde koppeling een nieuw werkitemformulier met sjabloonwaarden wordt geopend.

Nadat u een sjabloon hebt opgeslagen, kunt u deze bijwerken, verwijderen, de koppeling kopiëren of een kopie maken.

Selecteer op de pagina type werkitem meer acties voor een sjabloon en kies vervolgens een van de volgende opties:

Schermopname van de menuopties Meer acties voor een geselecteerde sjabloon.

  1. Controleer of de sjabloonlijst uw actie weerspiegelt (bijgewerkte waarden, hernoemd item, gekopieerde sjabloon of verwijderde sjabloon).

  2. Controleer of de koppeling Kopiëren een nieuw werkitemformulier met de verwachte sjabloonwaarden opent.

Een werkitem toevoegen met behulp van een sjabloon

Gebruik de sjabloonkoppeling in een browser om een werkitem met vooraf gedefinieerde waarden te maken.

  1. Haal de sjabloonlink op. Zie Bewerken, verwijderen, koppeling kopiëren, een kopie maken voor meer informatie.

  2. Plak de sjabloonkoppeling in een browser, vul de vereiste velden in en sla de wijzigingen op.

  3. Controleer of het nieuwe werkitem wordt geopend met door een sjabloon gedefinieerde waarden voordat u het opslaat.

Een sjabloon toepassen op nieuwe of bestaande werkitems

Pas een sjabloon toe op een nieuw of bestaand werkitem of gebruik een sjabloon voor bulkupdates.

In de webportal kunt u een sjabloon toepassen in een geopend werkitem of op geselecteerde werkitems.

Een sjabloon binnen een werkitem toepassen

Gebruik deze stappen om een sjabloon toe te passen op een nieuw of bestaand werkitem:

  1. Open een nieuw of bestaand werkitem dat u wilt bijwerken met door een sjabloon gedefinieerde waarden.

  2. Selecteer Meer actiessjablonen> en selecteer vervolgens de naam van een vooraf gedefinieerde sjabloon:

    Schermopname van het toepassen van een sjabloon op een bestaand werkitem in het formulier.

    Opmerking

    De lijst Sjablonen bevat sjablonen die zijn gedefinieerd voor teams waarvan u lid bent. Als de lijst leeg is, zijn er mogelijk geen sjablonen voor het type werkitem. Vernieuw uw browser om de meest recente beschikbare sjablonen te ontdekken.

  3. Selecteer Opslaan om de sjabloon toe te passen. Veldwijzigingen worden vastgelegd in het veld Geschiedenis van werkitems.

  4. Controleer of de velden in het formulier worden bijgewerkt en de geschiedenis van het werkitem registreert de opgeslagen wijzigingen.

Een sjabloon toepassen op verschillende werkitems

Gebruik deze stappen om een sjabloon toe te passen op geselecteerde werkitems voor een bulkupdate:

  1. Selecteer werkitems in de backlog of een lijst met resultaten van query's . Alle geselecteerde items moeten hetzelfde type werkitem zijn, zoals Bug of Feature.

  2. Selecteer Meer actiessjablonen> voor een van de geselecteerde werkitems en selecteer de sjabloon die u wilt toepassen.

    Schermopname van het toepassen van een sjabloon op meerdere werkitems voor een bulkupdate.

    De veldwijzigingen worden automatisch toegepast en opgeslagen. Veldwijzigingen worden vastgelegd in het veld Geschiedenis van werkitems. Voor meer informatie over bulkupdates, zie Werkitems bulksgewijs wijzigen.

  3. Controleer of elk geselecteerd werkitem bijgewerkte veldwaarden en bijbehorende geschiedenisvermeldingen weergeeft.

Tags toevoegen aan of verwijderen uit sjablonen

In Visual Studio 2015 of eerdere versies kunt u tags toevoegen aan een sjabloon. Wanneer u de sjabloon gebruikt, worden de tags automatisch toegepast op het werkitem. Als u twee of meer tags wilt toevoegen, scheidt u deze met een komma (,). U kunt geen tags toevoegen in de webportal.

Schermopname van het dialoogvenster Sjabloon bewerken waarin wordt getoond hoe u tags toevoegt of verwijdert.

Als u geen tags opgeeft die u wilt verwijderen, blijven alle tags in een werkitem gedefinieerd. De tags blijven gedefinieerd, zelfs wanneer u een werkitemsjabloon toepast op een bestaand werkitem.

Controleer in Visual Studio of de sjabloon de geconfigureerde tags behoudt en of werkitems waarop die tags zijn toegepast, deze tags bevatten nadat u hebt opgeslagen.

Een werkitem maken op basis van een sjabloon-URL

Maak een URL waarmee een nieuw werkitem wordt geopend met vooraf gedefinieerde veldwaarden. Gebruik deze methode als u een deelbare snelkoppeling naar een algemene configuratie van een werkitem wilt.

Gebruik opgeslagen sjablonen voor herbruikbare, door het team beheerde standaardwaarden. Sjabloon-URL's gebruiken wanneer het delen van directe koppelingen de primaire ervaring is.

  • Gebruik opgeslagen sjablonen wanneer uw team centraal beheerde standaardinstellingen nodig heeft.
  • Gebruik sjabloon-URL's wanneer u lichtgewicht delen in dashboards, wiki's of berichten nodig hebt.
https://dev.azure.com/<Organization_Name>/<Project_Name>/_workItems/create/<Work_Item_Type>?
[FieldReferenceName 1]={FieldValue 1}&
[FieldReferenceName 2]={FieldValue 2}&
[FieldReferenceName 3]={FieldValue 3}&
. . .
http://<Server_Name>:8080/tfs/DefaultCollection/<Project_Name>/_workItems/create/<Work_Item_Type>?
[FieldReferenceName 1]={FieldValue 1}&
[FieldReferenceName 2]={FieldValue 2}&
[FieldReferenceName 3]={FieldValue 3}&
. . .

In het volgende voorbeeld wordt een taakwerkitem gemaakt met een vooraf gedefinieerde titel, toegewezen aan, beschrijving, tags, activiteit en iteratiepad.

https://dev.azure.com/<Organization_Name>/<Project_Name>/_workItems/create/Task?
[System.Title]=TaskTitle&
[System.AssignedTo]=Jamal+Hartnett&
[System.Description]=<p>Always+include+Remaining+Work+and+links+to+any+related+bugs+or+user+stories.</p>&
[System.Tags]=Web;+Phone;+Service&
[Microsoft.VSTS.Common.Activity]=Development&
[System.IterationPath]=Fabrikam+Fiber%5CIteration+1
http://<Server_Name>:8080/tfs/DefaultCollection/<Project_Name>/_workItems/create/Task?
[System.AssignedTo]=Jamal+Hartnett&
[System.Description]=<p>Always+include+Remaining+Work+and+links+to+any+related+bugs+or+user+stories.</p>&
[System.Tags]=Web;+Phone;+Service&
[Microsoft.VSTS.Common.Activity]=Development&
[System.IterationPath]=Fabrikam+Fiber%5CIteration+1

Opmerking

Sommige browserclients leggen een limiet van 2000 tekens op voor veldwaarden.

U kunt de URL opslaan als tekstbestand of deze toevoegen als hyperlink op een dashboard of webpagina.

Controleer of het openen van de URL het juiste type werkitem laadt en dat vooraf gedefinieerde veldwaarden worden weergegeven in het formulier voor nieuwe werkitems.

Voeg sjabloonkoppelingen toe aan een Markdown-widget op uw teamdashboard in de webportal. Elke koppeling opent een nieuw werkitem met vooraf gedefinieerde sjabloonwaarden.

In het volgende voorbeeld ziet u een Markdown-widget met koppelingen naar drie sjablonen:

Schermopname van een Markdown-widget met koppelingen naar sjablonen.

Zie Markdown toevoegen aan een dashboard, Markdown-widgets voor installatiestappen.

Sjabloonproblemen oplossen

  • Het menu Sjablonen wordt niet weergegeven: Controleer of u toegang hebt tot het project en of u de werkstroom gebruikt die door uw client wordt ondersteund.
  • De lijst met sjablonen is leeg in de webportal: controleer of er sjablonen bestaan voor het geselecteerde type werkitem en dat u lid bent van het team dat eigenaar is van de sjablonen. Vernieuw de browser om de meest recente sjablonen te laden.
  • Kan een teamsjabloon niet beheren: Controleer of u lid bent van het team dat eigenaar is van de sjabloon.
  • Een sjabloon kan niet worden toegepast op verschillende werkitems: Controleer of alle geselecteerde werkitems hetzelfde type werkitem zijn.
  • Visual Studio sjabloonopties zijn niet beschikbaar: controleer of u de verouderde Visual Studio 2015-werkstroom gebruikt en of Microsoft Visual Studio Team Foundation Server 2015 Power Tools zijn geïnstalleerd.
  • Sjabloon-URL wordt geopend zonder verwachte waarden: controleer of elke veldverwijzingsnaam geldig is voor het type doelwerkitem en dat de waarden URL-gecodeerd zijn (bijvoorbeeld spaties als + of %20).
  • Sjabloon-URL kan niet worden geladen: controleer of de URL het juiste type organisatie, project en werkitem gebruikt en of u bent aangemeld bij een account met projecttoegang.
  • Sommige velden van een sjabloon worden niet ingevuld: controleer of de velden nog bestaan op het type werkitem en niet worden beperkt door regels voor procesaanpassing.

AI gebruiken om werkitemsjablonen te maken en toe te passen

Als u de Azure DevOps MCP-server configureert, kunt u sjabloongerelateerde taken in natuurlijke taal beschrijven in plaats van elke stap handmatig uit te voeren in de webportal of Team Explorer.

Behandel de volgende prompts als scenariovoorbeelden. Beschikbare bewerkingen kunnen variëren per MCP Server-versie, ingeschakelde hulpprogramma's en uw machtigingen.

Voordat u een prompt uitvoert, vervangt u tijdelijke aanduidingen door waarden uit uw omgeving: <ProjectName>, <TeamName>, <TemplateName>, <WorkItemId>en <IterationPath>.

Task Voorbeeldprompt
Een sjabloon maken op basis van een item Capture work item <WorkItemId> in project <ProjectName> as a template named "Security bug" for team <TeamName>
Een nieuwe sjabloon maken Create a Bug template named "Regression" for team <TeamName> in project <ProjectName> with Priority 2 and tag "regression"
Een sjabloon toepassen op één item Apply the "<TemplateName>" template to work item <WorkItemId> in project <ProjectName>
Een sjabloon bulksgewijs toepassen Apply the "<TemplateName>" template to all active Bugs tagged "regression" in project <ProjectName>
Werkitems maken op basis van een sjabloon Create 5 Bugs in project <ProjectName> for team <TeamName> using the "<TemplateName>" template with the titles I provide
Een sjabloon-URL genereren Generate a template URL that creates a Task in project <ProjectName> with Activity=Development and Iteration=<IterationPath>
Een sjabloon bewerken Update the "<TemplateName>" template for team <TeamName> in project <ProjectName> to set Severity to 2 - High
Een sjabloon kopiëren Create a copy of the "<TemplateName>" template named "Regression - Mobile" for team <TeamName> in project <ProjectName>
Teams zoeken die een sjabloon missen List teams in project <ProjectName> that don't have a Bug template defined
Gebruik van sjabloon controleren Show which work items in iteration <IterationPath> were created from the "<TemplateName>" template in project <ProjectName>

Opmerking

Als u Visual Studio Code gebruikt, is de agentmodus vooral handig voor complexe sjabloonbewerkingen.