Een werkitemtype toevoegen of wijzigen

  • Artikel

Azure DevOps Server 2022 - Azure DevOps Server 2019

Uw project bevat een aantal werkitemtypen, op basis van het proces dat wordt gebruikt om uw project te maken, zoals Agile, Basic, Scrum of CMMI. Een werkitemtype is het object dat u gebruikt om verschillende soorten werk bij te houden.

Notitie

Zie Werkitemtypen toevoegen en beheren voor Azure DevOps Services of voor projectverzamelingen die gebruikmaken van het overgenomen procesmodel.

U kunt een bestaand type werkitem wijzigen of een aangepast werkitemtype toevoegen op basis van de traceringsvereisten of werkstroomprocessen van uw team. De meest voorkomende redenen voor het wijzigen van een type werkitem zijn het toevoegen of wijzigen van de set velden of veldregels, het wijzigen van de werkstroom of het aanpassen van het werkitemformulier.

Zie Een veld toevoegen of wijzigen als u een aangepast veld wilt toevoegen of de veldregels of -kenmerken van een bestaand veld wilt wijzigen.

De meeste aanpassingen van het type werkitem worden aangebracht in de XML-definitie van het werkitemtype, maar andere aanpassingen worden gemaakt via de definitie van de procesconfiguratie of via het opdrachtregelprogramma witadmin .

Notitie

Zie Werkitemtypen toevoegen en beheren voor Azure DevOps Services of voor verzamelingen die gebruikmaken van het overgenomen procesmodel.

Definitie van type werkitem

ProcessConfiguration-definitie

Opdrachtregelwijziging

Vereisten

  • Als u werkitemtypen wilt weergeven, moet u de machtiging Gegevens op projectniveau weergeven hebben voor het project in de verzameling ingesteld op Toestaan.
  • Als u een werkitemtype wilt toevoegen of aanpassen door een processjabloon aan te passen, moet u lid zijn van de groep Projectverzameling Beheer istrators of de machtiging Proces bewerken hebben ingesteld op Toestaan.

Zie Machtigingen op projectverzamelingsniveau wijzigen om te worden toegevoegd als beheerder.

Hoe zijn wijzigingen in werkitemtypen van invloed op bestaande werkitems?

De volgende tabel bevat een overzicht van het effect op bestaande werkitems wanneer u velden of definities van werkitems wijzigt.

Actie Effect op bestaande werkitems
Velden verwijderen uit een werkitemtype Gegevens voor de verwijderde velden blijven aanwezig in het gegevensarchief. Er kunnen echter geen nieuwe gegevens worden toegevoegd, omdat u ze hebt verwijderd uit de definitie van het type werkitem.
De naam van een veld wijzigen Gegevens voor de hernoemde velden blijven in het gegevensarchief onder de nieuwe beschrijvende naam.
Velden verwijderen Gegevens voor de verwijderde velden worden verwijderd uit het gegevensarchief.
De naam van een werkitemtype wijzigen Alle gegevens blijven intact onder de nieuwe naam.
Een werkitemtype verwijderen Alle gegevens voor werkitems die zijn gemaakt als het type verwijderde werkitem, worden definitief verwijderd zonder kans op herstel.

Als u de velden volledig uit het gegevensarchief wilt verwijderen, gebruikt witadmin deletefield u het opdrachtregelprogramma.

Definitiebestanden van het type werkitem importeren en exporteren

Notitie

Als u het gehoste XML-procesmodel gebruikt, moet u de processjabloon importeren en exporteren die door uw project wordt gebruikt. Zie Het webformulier voor het bijhouden van werkitems aanpassen voor meer informatie.

  1. Als u geen beheerdersmachtigingen voor uw project hebt, kunt u deze ophalen.

    1. Open een opdrachtpromptvenster volgens de instructies in wit Beheer: Objecten aanpassen en beheren voor het bijhouden van werk. Voorbeeld:

  2. Exporteer het definitiebestand van het type werkitem waar u een veld wilt wijzigen of toevoegen. Geef de naam op van het type werkitem en een naam voor het bestand.

    witadmin exportwitd /collection:CollectionURL /p:ProjectName /n:TypeName /f:"DirectoryPath/FileName.xml"

    Een voorbeeld van een CollectionURL is http://MyServer:8080/tfs/TeamProjectCollectionName.

  3. Bewerk bestand . Zie Index naar XML-elementdefinities voor meer informatie.

  4. Importeer het definitiebestand.

    witadmin importwitd /collection:CollectionURL /p:ProjectName /f:"DirectoryPath/FileName.xml"

  5. Open de webportal of vernieuw de pagina om de wijzigingen weer te geven.

    Zie Importeren, exporteren en beheren van werkitemtypen voor meer informatie over het gebruik.witadmin

Een werkitemtype toevoegen of wijzigen

Als u een aangepast werkitemtype wilt toevoegen of een bestaand type werkitem wilt wijzigen, definieert of wijzigt u het XML-definitiebestand en importeert u het vervolgens in uw project op basis van het procesmodel dat u gebruikt. U wijzigt een werkitemtype door de elementen op te geven die zijn gedefinieerd in de drie hoofdsecties van het definitiebestand: VELDEN, WERKSTROOM en FORMULIER.

Overzicht van elementen van het type werkitem

De eenvoudigste manier om een nieuw type werkitem toe te voegen, is door een bestaand type werkitem te kopiëren en vervolgens het definitiebestand te wijzigen.

Een veld, veldregel, label of lege tekst toevoegen of wijzigen

Elk veld dat u wilt gebruiken om gegevens bij te houden, moet worden toegevoegd aan het definitiebestand. Dit geldt voor alle velden behalve systeemvelden (velden waarvan de referentienaam begint met System.). Alle systeemvelden worden gedefinieerd voor alle typen werkitems, ongeacht of u ze in de definitie van het type werkitem opneemt. Zie de index van het veld Werkitem voor meer informatie over elk veld.

U voegt velden en veldregels toe aan de sectie VELDEN . Als u het veld wilt weergeven in het werkitemformulier, moet u het ook toevoegen aan de sectie FORM van de definitie.

Als u bijvoorbeeld de werkitem-id wilt toevoegen aan een formulier, geeft u de volgende XML-syntaxis in de FORM sectie op.

<Control FieldName="System.ID" Type="FieldControl" Label="ID" LabelPosition="Left" />

Zie Een veld toevoegen of wijzigen voor meer informatie over het definiëren van velden.

De werkstroom wijzigen

SectieS en REDENEN in de werkstroom geven de waarden voor de keuzelijst op in de velden Status en Reden. Ze volgen de status van werkitems. In de sectie OVERGANGEN worden de geldige overgangen tussen statussen opgegeven, zoals wordt weergegeven in de volgende afbeelding. U geeft zowel voorwaartse als regressieve overgangen op.

Voorbeeld van werkstroomstatusdiagram, Agile-gebruikersverhaal

U wijzigt de werkstroom om de volgende doelstellingen te bereiken:

  • Een status, reden of overgang toevoegen of verwijderen
  • Geef een waarde op voor het toepassen van een veld tijdens een wijziging in status, reden of overgang
  • Geef een aangepaste ACTIE op om veldtoewijzingen te automatiseren op basis van een wijziging in status, reden of overgang.

Wanneer u de werkstroom aanpast, volgt u deze twee stappen:

  1. Wijzig de WERKSTROOM van de definitie van het type werkitem.

  2. Wijzig de procesconfiguratie om nieuwe werkstroomstatussen toe te wijzen aan metastaten.

    Deze tweede stap is vereist wanneer u de werkstroom voor een werkitemtype wijzigt dat wordt weergegeven op een Agile-hulpprogrammapagina. Deze typen werkitems behoren tot de categorieën Vereiste of Taak.

Werkstroomveldregels

U kunt veldregels toepassen wanneer u de status wijzigt, een reden opgeeft of tijdens een werkstroomovergang.

Door bijvoorbeeld de lege regel toe te voegen wanneer de status is ingesteld op Actief, kunt u de velden Gesloten datum en Gesloten door automatisch nullen en alleen-lezen maken. Dit is handig bij het opnieuw activeren van een werkitem vanuit een gesloten status.

<STATE value="Active">
   <FIELDS>
. . .
      <FIELD refname="Microsoft.VSTS.Common.ClosedDate"><EMPTY/></FIELD>
      <FIELD refname="Microsoft.VSTS.Common.ClosedBy"><EMPTY/></FIELD>
   </FIELDS>
</STATE>

Werkstroomveldregels toepassen om de volgende acties uit te voeren:

  • De waarde die een veld kan hebben, kwalificeren door CANNOTLOSEVALUE, EMPTY, FROZEN, NOTSAMEAS, READONLY en REQUIRED op te geven
  • Een waarde naar een veld kopiëren met BEHULP van COPY, DEFAULT en SERVERDEFAULT
  • Beperken wie een veld kan wijzigen
  • Patroonkoppeling afdwingen in een tekenreeksveld met behulp van VERGELIJKEN
  • Regels voorwaardelijk toepassen op basis van waarden in andere velden met WHEN, WHENNOT, WHENCHANGED en WHENNOTCHANGED
  • Beperk regels die van toepassing zijn op specifieke gebruikers of groepen. De meeste regels ondersteunen de kenmerken voor of niet om zich te richten op wie de regel doet en niet van toepassing is op.

Zie de verwijzing naar het element FIELD (Workflow) en de evaluatie van regels en regels voor regels en regels voor meer informatie over het toepassen van werkstroomveldregels.

Het werkitemformulier aanpassen

In de volgende illustraties worden de meest voorkomende elementen van werkitemformulieren gemarkeerd. U kunt ze allemaal aanpassen, behalve het titelgebied en formulierbesturingselementen. De elementen die u gebruikt om het formulier aan te passen, zijn afhankelijk van of het nieuwe formulier al dan niet is ingeschakeld door uw beheerder.

Schermopname van het koptekstelement in het webformulier voor werkitems.

U kunt het formulier aanpassen om de volgende doelstellingen te bereiken:

Een werkitemtype toevoegen aan of verwijderen uit de achterstand of het takenbord

De Agile-planningshulpprogramma's( productachterstand, sprintachterstand en taakbordpagina's) geven specifieke typen werkitems weer op basis van de processjabloon die wordt gebruikt om uw project te maken. U kunt werkitemtypen toevoegen of verwijderen die op deze pagina's moeten worden weergegeven. Als uw project bijvoorbeeld gebruikmaakt van Scrum-werkitemtypen, worden zowel productachterstanditems als bugs weergegeven op de backlogpagina's. Als uw project echter is gemaakt met behulp van de Agile-, CMMI- of andere processjabloon, worden fouten niet weergegeven op uw achterstand of taakbord.

U kunt bijvoorbeeld bugs toevoegen vanaf de pagina met productachterstanden.

Zie Een werkitemtype toevoegen aan een achterstand en bord voor meer informatie over het toevoegen of verwijderen van werkitems uit de achterstand of het takenbord. Als u een nieuw type werkitem wilt toevoegen ter ondersteuning van een portfolioachterstand, raadpleegt u Een achterstandsniveau voor een portfolio toevoegen.

De kleur, het pictogram of de werkstroomstatuskleur van een werkitemtype wijzigen

In de webportal worden werkitems weergegeven in queryresultaten en op de achterstands- en bordpagina's van de Agile-hulpprogramma's. Als u de kleur of het pictogram wilt wijzigen dat is gekoppeld aan een bestaand type werkitem of de kleur wilt toevoegen die moet worden gebruikt voor een nieuw type werkitem, bewerkt u de procesconfiguratie. Als u de kleur voor een werkstroomstatus wilt wijzigen, bewerkt u ook de procesconfiguratie.

Schermopname van queryresultaten met de kleur, het pictogram en de statuskleur van het werkitemtype.

Het type van een bestaand werkitem wijzigen

Zie Werkitems bulksgewijs verplaatsen en het type werkitem wijzigen voor de functies die voor u beschikbaar zijn op basis van uw platform.

Een werkitemtype deactiveren of uitschakelen

Als u het maken van een specifiek type werkitem wilt beperken tot een groep gebruikers, voegt u het type werkitem toe aan de groep Verborgen categorieën om te voorkomen dat de meeste inzenders deze maken. Als u een groep gebruikers toegang wilt geven, kunt u een hyperlink maken naar een sjabloon waarmee het werkitemformulier wordt geopend en die koppeling wordt gedeeld met de teamleden die u wel wilt maken.

Notitie

U kunt geen veldregels toevoegen om de werkstroom te beperken, omdat u geen regels kunt toepassen op systeemvelden.

Een werkitemtype verwijderen

Als u wilt voorkomen dat teamleden een specifiek type werkitem gebruiken om een werkitem te maken, kunt u dit verwijderen uit het project. Wanneer u dit gebruikt witadmin destroywitd*, verwijdert u alle werkitems die zijn gemaakt met dat werkitemtype en het type werkitem zelf definitief. Als uw team bijvoorbeeld geen gebruik maakt van 'Impediment', kunt u het type werkitem met het label 'Impediment' verwijderen uit het fabrikam-websiteproject.

witadmin destroywitd /collection:"http://FabrikamPrime:8080/tfs/DefaultCollection" /p:"Fabrikam Web Site" /n:"Impediment"

Wanneer u een werkitemtype verwijdert dat deel uitmaakt van een categorie, moet u de categoriedefinitie voor het project bijwerken om de nieuwe naam weer te geven. Zie Importeren, exporteren en beheren van werkitemtypen en import- en exportcategorieën voor meer informatie.

De naam van een werkitemtype wijzigen

Als u de naam van een bestaand type werkitem wilt wijzigen, gebruikt witadmin renamewitdu . U kunt bijvoorbeeld de naam van een werkitemtype met het label 'QoS-item' wijzigen in 'Serviceovereenkomst'.

witadmin renamewitd /collection:"http://FabrikamPrime:8080/tfs/DefaultCollection" /p:"Fabrikam Web Site" /n:"QoS Item" /new:"Service Agreement"

Wanneer u de naam van een werkitemtype wijzigt dat deel uitmaakt van een categorie, moet u de categoriedefinitie voor het project bijwerken om de nieuwe naam weer te geven. Met name de achterstanden en borden werken pas wanneer u de definitie van de categorieën bijwerkt.

Zie Importeren, exporteren en beheren van werkitemtypen en import- en exportcategorieën voor meer informatie.

Dit artikel heeft betrekking op het toevoegen en aanpassen van werkitemtypen voor gehoste XML- en on-premises XML-procesmodellen. Zie Een proces aanpassen voor informatie over het toevoegen en aanpassen van werkitemtypen voor het overgenomen procesmodel.

Andere verwante onderwerpen of resources: