Delen via


Typen werkitems importeren, exporteren en beheren

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Belangrijk

Voor het on-premises XML-procesmodel kunt u witadmin gebruiken om een proces voor een project weer te geven, te importeren, te exporteren en te wijzigen. Voor de overgenomen en gehoste XML-procesmodellen kunt u alleen witadmin gebruiken om procesgegevens weer te geven en te exporteren. Zie Uw ervaring voor het bijhouden van werk aanpassen voor een overzicht van procesmodellen en wat wordt ondersteund.

U kunt werkitemtypen voor een project beheren met behulp van de volgende witadmin opdrachten:

  • destroywitd: Vernietigt een werkitemtype en vernietigt elk werkitem van dat type permanent zonder herstel.
  • exportwitd: hiermee exporteert u de definitie van een werkitemtype naar een XML-bestand of naar het opdrachtpromptvenster.
  • importwitd: Hiermee importeert u werkitemtypen uit een XML-definitiebestand in een project. Als er al een werkitemtype met dezelfde naam bestaat, wordt de bestaande overschreven door de nieuwe definitie van het werkitemtype. Als het type werkitem niet bestaat, wordt er een nieuw type werkitem gemaakt. Als u de XML wilt valideren waarmee een werkitemtype wordt gedefinieerd, maar het bestand niet importeert, gebruikt u de /v optie.
  • listwitd: Geeft de namen weer van de typen werkitems in het opgegeven project in het opdrachtpromptvenster.
  • renamewitd: Hiermee wijzigt u de weergavenaam van een werkitemtype binnen een specifiek project. Nadat u deze opdracht hebt uitgevoerd, geven werkitems van dit type de nieuwe naam weer.

Zie Uw werkitems bijhouden in Azure Boards-gebruikersverhalen, problemen, bugs, functies en epics voor meer informatie over hoe werkitems worden gebruikt voor het bijhouden van werkitems.

witadmin Het opdrachtregelprogramma uitvoeren

Als u het witadmin opdrachtregelprogramma wilt uitvoeren, opent u een opdrachtpromptvenster waarin Visual Studio is geïnstalleerd. Het witadmin opdrachtregelprogramma wordt geïnstalleerd met elke versie van Visual Studio. U kunt dit hulpprogramma openen door de gratis versie van Visual Studio Community of Visual Studio Team Explorer te installeren.

Notitie

Als u verbinding wilt maken met Azure DevOps Services, raden we u aan de nieuwste versie van Visual Studio of Visual Studio Community te gebruiken.

Notitie

Als u verbinding wilt maken met een on-premises server, raden we u aan om dezelfde of latere versie van Visual Studio te gebruiken als uw Azure DevOps-server. Als u bijvoorbeeld verbinding maakt met Azure DevOps Server 2019, maakt u vanuit een versie van Visual Studio 2019 verbinding met uw project.

Voor Visual Studio 2022

%programfiles(x86)%\Microsoft Visual Studio\2022\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer

of Professional Enterprise in plaats van , afhankelijk van Communityde versie die u hebt geïnstalleerd.

Voor Visual Studio 2019

%programfiles(x86)%\Microsoft Visual Studio\2019\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer

of Professional Enterprise in plaats van , afhankelijk van Communityde versie die u hebt geïnstalleerd.

Voor Visual Studio 2017

%programfiles(x86)%\Microsoft Visual Studio\2017\Enterprise\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer

of TeamExplorer Professional in plaats van , afhankelijk van Enterprisede versie die u hebt geïnstalleerd.

Vervang %programfiles(x86)% in een 32-bits versie van Windows door %programfiles%. U kunt Visual Studio Community (die gratis toegang biedt tot Team Explorer) of Visual Studio Team Explorer 2017 installeren.

Tip

Met witadmin kunt u definitiebestanden importeren en exporteren. Andere hulpprogramma's die u kunt gebruiken, zijn de proceseditor (hiervoor moet u een versie van Visual Studio hebben geïnstalleerd). Installeer de processjablooneditor vanuit Visual Studio Marketplace.

Vereisten

Voor het project waarin de typen werkitems zijn gedefinieerd, moet u de volgende machtigingen hebben ingesteld:

  • Als u werkitemtypen wilt exporteren of weergeven, moet u lid zijn van de groep Projectbeheerders of de machtiging Gegevens weergeven op projectniveau instellen op Toestaan.
  • Als u werkitemtypen wilt vernietigen, importeren of de naam ervan wilt wijzigen, moet u lid zijn van de beveiligingsgroep Team Foundation-beheerders of de beveiligingsgroep Projectbeheerders .

Zie Machtigingen op projectverzamelingsniveau wijzigen voor meer informatie.

Notitie

Zelfs als u zich aanmeldt met beheerdersmachtigingen, moet u een opdrachtpromptvenster met verhoogde bevoegdheid openen om deze functie uit te voeren op een server waarop Windows Server 2008 wordt uitgevoerd. Als u een opdrachtpromptvenster met verhoogde bevoegdheid wilt openen, kiest u Start, opent u het snelmenu voor de opdrachtprompt en kiest u Vervolgens Uitvoeren als administrator. Zie de Microsoft-website: Gebruikerstoegangsbeheer voor meer informatie.

Syntaxis

witadmin destroywitd /collection:CollectionURL /p:Project /n:TypeName [/noprompt]   
witadmin exportwitd /collection:CollectionURL /p:Project /n:TypeName [/f:FileName] [/e:Encoding] [/exportgloballists]  
witadmin importwitd /collection:CollectionURL [/p:Project] /f:FileName [/e:Encoding] [/v] 
witadmin listwitd /collection:CollectionURL /p:Project    
witadmin renamewitd /collection:CollectionURL /p:Project /n:TypeName /new:NewName [/noprompt]   

Parameters

Parameter Beschrijving
/collection:CollectionURL Hiermee geeft u de URI van de projectverzameling. Voorbeeld:

On-premises indeling: http://ServerName:Port/VirtualDirectoryName/CollectionName
Als er geen virtuele map wordt gebruikt, gebruikt u de volgende indeling: http://ServerName:Port/CollectionName
/p:Project Het project waarvoor de typen werkitems moeten worden beheerd. Dit project moet worden gedefinieerd in de projectverzameling die is opgegeven door de parameter /collection .

De parameter /p is vereist, tenzij u de importwitd-opdracht uitvoert met de optie /v .
/n:TypeName De naam van het type werkitem dat moet worden vernietigd, geëxporteerd, geïmporteerd of hernoemd.
/f:FileName Het pad en de bestandsnaam van het XML-definitiebestand met de typen werkitems die moeten worden geëxporteerd of geïmporteerd. Als u deze parameter weglaat wanneer u de opdracht exportwitd gebruikt, wordt de XML weergegeven in het opdrachtpromptvenster.

Opmerking: Als u Windows Vista gebruikt, hebt u mogelijk geen machtigingen voor bepaalde mappen. Als u probeert het type werkitem te exporteren naar een locatie waar u geen machtigingen hebt, wordt het geëxporteerde bestand automatisch omgeleid door de registervirtualisatietechnologie en opgeslagen in de virtuele opslag. Om deze omleiding te voorkomen, kunt u het bestand exporteren naar een locatie waar u machtigingen hebt. Zie de pagina Registervirtualisatie op de Website van Microsoft voor meer informatie.
/e:*Encoding De naam van een .NET Framework 2.0-coderingsindeling. De opdracht gebruikt de opgegeven codering om de XML-gegevens te exporteren of te importeren. Hiermee geeft u bijvoorbeeld /e:utf-7 Unicode-codering (UTF-7) op. Als u deze parameter weglaat, probeert witadmin de codering te detecteren en als de detectie mislukt, gebruikt witadmin UTF-8.
/exportgloballists Hiermee exporteert u de definities van globale lijsten waarnaar wordt verwezen door het type werkitem. De definities voor globale lijsten worden ingesloten in de definitie-XML van het type werkitem. Wanneer dit niet is opgegeven, worden de definities voor globale lijsten weggelaten.
/v Valideert de XML die het type werkitem definieert, maar importeert het XML-definitiebestand niet. Opmerking: U kunt de typedefinitie valideren zonder een project op te geven. Verwijzingen naar projectbereikgroepen worden genegeerd.
/new:NewName De nieuwe naam van het type werkitem.
/noprompt Hiermee wordt de prompt voor bevestiging uitgeschakeld.
/? of help Geeft help weer over de opdracht in het opdrachtpromptvenster.

Opmerkingen

Wanneer u de destroywitd opdracht gebruikt, worden alle volgende objecten vernietigd:

  • Het type werkitem
  • Alle werkitems van dat type
  • Overeenkomende vermeldingen in de werkitemtabellen, de lange teksttabellen en de koppelingstabellen
  • Objecten in de metagegevenscache van het werkitemtype

Voorbeelden

Tenzij anders opgegeven, zijn de volgende waarden in elk voorbeeld van toepassing:

  • URI voor de projectverzameling: http://AdventureWorksServer:8080/tfs/DefaultCollection
  • Projectnaam: AdventureWorks
  • Naam van invoer- of uitvoerbestand: myworkitems.xml
  • Naam van werkitemtype: myworkitem
  • Standaardcodering: UTF-8

De definitie van een WIT exporteren

Met de volgende opdracht wordt de definitie voor myworkitem geëxporteerd naar het bestand myworkitems.xml.

witadmin exportwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myworkitems.xml /n:myworkitem  

In het volgende voorbeeld wordt het werkitem geëxporteerd met behulp van Unicode-codering (UTF-7).

witadmin exportwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myworkitems.xml /n:myworkitem /e:utf-7  

De definitie van een WIT en de bijbehorende algemene lijsten exporteren

In het volgende voorbeeld wordt het werkitemtype en de bijbehorende algemene lijsten geëxporteerd.

witadmin exportwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myworkitems.xml /n:myworkitem /exportgloballists  

De definitie van een WIT weergeven

In het volgende voorbeeld wordt de definitie van het werkitemtype het opdrachtpromptvenster weergegeven.

witadmin exportwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /n:myworkitem  

De definitie van WIT's importeren

In het volgende voorbeeld wordt de definitie van het werkitem uit het XML-bestand geïmporteerd.

witadmin importwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:myworkitem.xml /p:AdventureWorks  

De XML-definitie van een WIT valideren

In het volgende voorbeeld wordt de XML gevalideerd waarmee het type werkitem wordt gedefinieerd, maar de definitie niet wordt geïmporteerd.

witadmin importwitd /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:myworkitem.xml /p:AdventureWorks /v  

Vragen en antwoorden

V: Welke aanpassingen kan ik maken en nog steeds de wizard Functies configureren gebruiken om mijn project bij te werken na een upgrade?

A: U kunt aangepaste WIT's toevoegen en de formulierindeling wijzigen. Met de wizard Functies configureren worden uw projecten bijgewerkt en krijgt u toegang tot de nieuwste functies.

Als u de werkstroom wijzigt of de naam van een WIT wijzigt, moet u mogelijk handmatige bewerkingen uitvoeren bij het bijwerken van uw project. Zie De ervaring voor het bijhouden van werk aanpassen voordat u deze aanpast, inzicht in de gevolgen voor onderhoud en upgrades voor meer informatie over welke aanpassingen u veilig kunt maken en wat u moet vermijden.

V: Hoe kan ik de kleur wijzigen die aan een WIT is gekoppeld?

A: In de webportal worden werkitems weergegeven in queryresultaten en op de achterstands- en bordpagina's van de Agile-planningshulpmiddelen. Als u de kleur die is gekoppeld aan een bestaande WIT wilt wijzigen of de kleur wilt toevoegen die moet worden gebruikt voor een nieuwe WIT, bewerkt u de procesconfiguratie.

Kleurtoewijzingen voor verschillende typen werkitems

V: Hoe kan ik een WIT deactiveren of uitschakelen? Hoe kan ik gebruikers beperken tot het maken van werkitems van een bepaald type?

A: Als u een werkitemtype hebt dat u buiten gebruik wilt stellen, maar de werkitems wilt behouden die op basis van dat type zijn gemaakt, kunt u een regel toevoegen waarmee alle geldige gebruikers het type werkitem kunnen opslaan.

    <TRANSITION from=" " to="New">  
       <FIELDS>  
         <FIELD refname="System.CreatedBy">  
              <VALIDUSER not="[Team Project Name]Project Valid Users" />  
         </FIELD>  
       </FIELDS>  
    </TRANSITION>     

Als u het maken van een specifieke WIT wilt beperken tot een groep gebruikers, zijn er twee manieren om de toegang te beperken:

  • Voeg de WIT toe aan de groep Verborgen categorieën om te voorkomen dat het merendeel van de inzenders deze kan 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.
  • Voeg een veldregel toe aan de werkstroom voor het veld System.CreatedBy om een groep gebruikers effectief te beperken tot het maken van een werkitem van een specifiek type. Zoals in het volgende voorbeeld wordt weergegeven, moet de gebruiker die het werkitem maakt, tot het Allowed Group werkitem behoren om het werkitem op te slaan.
<TRANSITION from=" " to="New">  
   <FIELDS>  
     <FIELD refname="System.CreatedBy">  
         <VALIDUSER for="Allowed Group" not="Disallowed Group" />  
     </FIELD>  
   </FIELDS>  
</TRANSITION>  

V: Hoe kan ik een WIT verwijderen?

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

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

Wanneer u een WIT verwijdert die deel uitmaakt van een categorie, moet u de categoriedefinitie voor het project bijwerken om de nieuwe naam weer te geven. De Agile-planningshulpprogramma's werken met name pas wanneer u de definitie van de categorieën bijwerkt.

Zie Import- en exportcategorieën voor meer informatie.