Werkitemvelden beheren

  • Artikel

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 de velden beheren die zijn gedefinieerd voor werkitemtypen die zijn gedefinieerd voor een projectverzameling (on-premises XML) met behulp van de volgende witadmin-opdrachten . Als u een globaal veld (geldig voor on-premises XML) wilt toevoegen, kunt u dit doen door het algemene werkstroombestand te wijzigen en te importeren in de verzameling.

  • changefield: Hiermee wijzigt u een of meer kenmerken van een veld. Wanneer u een van de volgende kenmerken wijzigt, wijzigt u deze voor alle typen werkitems en projecten in de projectverzameling:

    • Gegevenstype voor PlainText of HTML velden.

      Belangrijk

      Wanneer u Team Foundation Server bijwerkt van een eerdere versie naar de huidige versie, wordt de typetoewijzing voor het veld Beschrijving (System.Description) automatisch geconverteerd naar PlainTextHTML. Met de changefield opdracht kunt u de inhoud van dit veld herstellen om tekst zonder opmaak weer te geven.

    • Beschrijvende naam die wordt weergegeven in de query van het werkitem. Deze naam kan afwijken van de naam die wordt weergegeven in het werkitemformulier.

    • Rapportagekenmerken die de naam van het veld bevatten zoals het wordt weergegeven in een rapport, de naam van het referentierapport en het rapportagetype.

    • Synchronisatie met Active Directory: u kunt synchronisatie van naamvelden van personen in- of uitschakelen.

  • deletefield: Hiermee verwijdert u het opgegeven veld.
  • listfields: geeft een lijst van de kenmerken voor alle velden of een opgegeven veld.

Notitie

De witadmin indexfield opdracht is afgeschaft met Azure DevOps Server 2019 en latere versies. Indexeringsvelden zijn niet meer vereist.

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 ProfessionalEnterprise 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 ProfessionalEnterprise 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 TeamExplorerProfessional 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.

Zie de veldindex Werkitem voor een overzicht van de velden die zijn gedefinieerd in een standaardprocessjabloon.

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

  • Als u velden wilt weergeven, moet u de machtiging Gegevens op projectniveau weergeven hebben voor het project in de verzameling ingesteld op Toestaan.
  • Als u velden wilt verwijderen of een andere naam wilt geven of een kenmerk van een veld wilt wijzigen, moet u lid zijn van de beveiligingsgroep Team Foundation Beheer istrators of de beveiligingsgroep projectverzameling Beheer istrators.

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 van de opdrachtprompt en kiest u Uitvoeren als Beheer istrator. Zie de Microsoft-website: Gebruikerstoegangsbeheer voor meer informatie.

Syntaxis

witadmin changefield /collection:CollectionURL /n:RefName   [/name:NewName]    [/syncnamechanges:true | false]   [/reportingname:ReportingName]    [/reportingrefname:ReportingRefName]   [/reportingtype:Type]   [/reportingformula:Formula]   [/type:PlainText | HTML]   [/noprompt]  

witadmin deletefield /collection:CollectionURL /n:RefName [/noprompt]  

witadmin listfields /collection:CollectionURL /n:RefName [/unused]

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
/n:RefName
/n:Name		 De verwijzingsnaam van een werkitemtypeveld.
/index Hiermee geeft u het in- of uitschakelen van indexering voor het opgegeven veld. Geef aan op om indexering in te schakelen en uit te schakelen voor het uitschakelen van indexering.
/name:NewName Hiermee geeft u de nieuwe naam voor het veld.
/syncnamechanges Hiermee geeft u het veld werkitem om namen op te slaan en bij te werken als wijzigingen worden aangebracht in Active Directory of een werkgroep. Deze optie is alleen geldig wanneer een veld met het gegevenstype Tekenreeks is opgegeven voor de typename.

Geef true op om synchronisatie in te schakelen voor het gegevensveld, geef false op om synchronisatie voor het gegevensveld uit te schakelen.
/reportingname:ReportingName Hiermee geeft u de naam op van het veld in het datawarehouse dat moet worden gebruikt voor rapportage.
/reportingrefname:ReportingRefName Hiermee geeft u de verwijzingsnaam op van het veld in het datawarehouse dat moet worden gebruikt voor rapportage.
/reportingtype:Type Hiermee geeft u op hoe het veld wordt gebruikt in het magazijn voor rapportage. De volgende waarden zijn geldig:

- dimension: Wordt gebruikt voor de velden Integer, Tekenreeks of Datum/tijd.
- detail: Wordt gebruikt voor de velden Integer, Double, String of DateTime.
- measure: Wordt gebruikt voor de velden Integer en Double. Het standaardaggregatietype is som. U kunt een ander aggregatietype opgeven met behulp van de formuleparameter .
- none: Wordt gebruikt om de rapportbaarheid van het veld uit te schakelen.

Zie Over werkitemvelden en -kenmerken voor meer informatie.
/reportingformula:Formula Hiermee geeft u de aggregatieformule op die moet worden gebruikt wanneer het veld wordt gerapporteerd als een measure. De enige ondersteunde formule is sum.
/type:HTML | PlainText Hiermee geeft u de inhoud van het veld van PlainText naar HTML of van HTML naar PlainTextte converteren. U kunt deze optie alleen opgeven voor velden waarvan het type toewijzing is PlainText of HTML. Zie de verwijzing naar het ELEMENT FIELD (Definition).
/unused Een lijst met alle velden die niet worden gebruikt door een project dat is gedefinieerd in de projectverzameling.
/noprompt Hiermee wordt een bevestigingsprompt uitgeschakeld.
/? of help Geeft help weer over de opdracht in het opdrachtpromptvenster.

Namen van personen synchroniseren met Active Directory

U moet handmatig synchronisatie inschakelen van aangepaste werkitemvelden die worden gebruikt om namen van personen toe te wijzen die verwijzen naar Active Directory. U moet synchronisatie inschakelen voor elk veld voor elke projectverzameling die de aangepaste velden bevat.

Alle systeemverwijzingsvelden met persoonsnamen hebben het kenmerk syncnamechanges ingesteld op true. Dergelijke velden omvatten System.AuthorizedAs, System.AssignedTo, System.ChangedBy en System.CreatedBy. Synchronisatie ingeschakeld voor elk naamveld dat is gedefinieerd in een van de standaardprocessjablonen. Zie Toewijzingen en werkstroomvelden voor meer informatie.

Nadat synchronisatie is ingeschakeld, wordt in het veld geen statische tekenreeks meer weergegeven. In plaats daarvan wordt in het veld de naam weergegeven die is gekoppeld aan een gebruikersaccount. Wanneer u de gebruikersnaam wijzigt in Active Directory of in Werkgroep, wordt de nieuwe naam automatisch weergegeven in een veld dat syncnamechanges is ingesteld op true de nieuwe naam.

Wanneer u het syncnamechanges kenmerk toewijst aan een tekenreeksveld, accepteert het veld altijd geldige gebruikersnamen. Het veld staat echter geen groepsnamen toe die zijn opgeslagen in Team Foundation Server of in Active Directory als een van de volgende voorwaarden is true:

  • De VALIDUSER regel wordt opgegeven voor alle typen werkitems

  • De VALIDUSER regel wordt opgegeven voor een werkitemtype

  • De ALLOWEDVALUES regel wordt opgegeven voor een werkitemtype en die regel heeft een filtercriteria die groepen uitsluit

    Zie Alle VELD-elementen voor meer informatie.

Kenmerken die u voor elk type werkitem kunt wijzigen

U wijzigt de volgende kenmerken of waarden die voor een veld zijn gedefinieerd door de definitie van het type werkitem te wijzigen waarin het veld wordt weergegeven:

Voorbeelden

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

  • URI voor de projectverzameling: http://AdventureWorksServer:8080/tfs/DefaultCollection
  • Veldnaam werkitem: AdventureWorks.Field
  • Standaardcodering: UTF-8

Lijstvelden

Gebruik witadmin listfields deze optie om de set velden in gebruik weer te geven om er een te selecteren die u wilt toevoegen aan een werkitemtype. U kunt ook de kenmerktoewijzingen weergeven die zijn gedefinieerd voor een specifiek veld en bepalen welke velden worden gebruikt door welke projecten.

De kenmerken van een werkitemveld weergeven

  • Voer de volgende opdracht in om de kenmerken weer te geven die zijn gedefinieerd voor een opgegeven veld, zoals Microsoft.VSTS.Common.Issue.

    witadmin listfields /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:Microsoft.VSTS.Common.Issue

    Veld- en kenmerkgegevens worden weergegeven voor het benoemde veld, zoals in dit voorbeeld wordt weergegeven.

    Field: Microsoft.VSTS.Common.Issue  
Name: Issue  
Type: String  
Reportable As: dimension  
Use: Adventure Works (Shared Steps), AW Future (Shared Steps), AW Current (Shared Steps)  
Indexed: False

    De parameter Use geeft de naam aan van elk project en het type werkitem waarin het veld wordt gebruikt. Zie Index van werkitemvelden voor meer informatie over veldkenmerken.

Alle velden in een projectverzameling weergeven

  • Voer de volgende opdracht in om alle velden weer te geven die zijn gedefinieerd voor een projectverzameling.

    witadmin listfields /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection

    Veldgegevens voor alle velden voor de benoemde projectverzameling worden weergegeven. Zie Index van werkitemvelden.

Lijstvelden die niet worden gebruikt

  • Voer de volgende opdracht in om de velden weer te geven die niet meer worden gebruikt in de projectverzameling door een werkitemtype.

    witadmin listfields /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /unused

    Veld- en kenmerkgegevens worden weergegeven voor elk veld dat niet wordt gebruikt, zoals in dit voorbeeld wordt weergegeven.

    Field: Microsoft.VSTS.CMMI.TaskType  
Name: Task Type  
Type: String  
Reportable As: dimension  
Use: Not In Use  
Indexed: False  

Field: Microsoft.VSTSUE.Common.Flag  
Name: Flag  
Type: String  
Reportable As: dimension  
Use: Not In Use  
Indexed: False  

Field: Microsoft.VSTSUE.Common.Progress  
Name: Progress  
Type: String  
Reportable As: dimension  
Use: Not In Use  
Indexed: False

De naam van een veld wijzigen

U kunt de beschrijvende naam van een werkitemveld wijzigen om te voldoen aan de naamconventies die uw team gebruikt. De nieuwe naam wordt toegepast op alle typen werkitems die verwijzen naar het gewijzigde veld in alle projecten in de projectverzameling. De beschrijvende naam wordt weergegeven wanneer u filtercriteria definieert in een werkitemquery. De naam die in een werkitemformulier wordt weergegeven, kan afwijken van de beschrijvende naam die voor het veld is gedefinieerd.

De naam van een werkitemveld wijzigen

  1. Voer de volgende opdracht in om de beschrijvende naam te wijzigen die is toegewezen aan Microsoft.VSTS.Common.RankBelangrijke rangschikking.

    witadmin changefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:Microsoft.VSTS.Common.Rank /name:"Important Rank"

  2. Typ y bij de bevestigingsprompt en druk op Enter. Wacht totdat u het volgende bericht ontvangt:

    De naam van het veld is gewijzigd.

Wijzigingen controleren die in één project zijn geïmporteerd

  1. Kies VernieuwenVernieuwen in Team Explorer.

    De meest recente updates worden gedownload van de server, inclusief de wijzigingen die u zojuist hebt aangebracht in de veldnaam. Wacht enkele seconden totdat het vernieuwen is voltooid.

  2. Kies Nieuwe query om een query te maken.

  3. Kies in de Power Query-editor de koppeling Klik hier om een componentkoppeling toe te voegen om een rij toe te voegen, selecteer de lege veldcel en typ rangschikking in de cel. Het volgende bericht dat boven de lijst met resultaten wordt weergegeven. Dit bericht geeft aan dat de positie niet kan worden gevonden.

    Voer de query uit om de queryresultaten te bekijken. TF51005: De query verwijst naar een veld dat niet bestaat. De fout wordt veroorzaakt door <<Rang>>.

  4. Verwijder de waarde Rank uit de cel Veld en typ Belangrijke rangschikking in de cel.

  5. Selecteer <> in de cel Operator en typ 1 in de cel Waarde .

  6. Kies Query uitvoerenUitvoeren op de werkbalk Query.

  7. Open het snelmenu voor een rij in de resultaten en selecteer Kolomopties. Schuif omlaag in de lijst beschikbare kolommen . U ziet dat het veld Positie niet meer aanwezig is, maar het veld Belangrijke rangschikking aanwezig is.

  8. Selecteer Belangrijke rangschikking in het vak Beschikbare kolommen en kies vervolgens de > knop (geselecteerde kolommen toevoegen). Kies OK.

    U ziet dat de beschrijvende naam voor Microsoft.VSTS.Common.Rank is gewijzigd van Rank in Important Rank in de opbouwfunctie voor query's en de lijst met resultaten.

  9. Sluit de query. Kies Nee wanneer u wordt gevraagd de query op te slaan.

  10. Maak een nieuw taakwerkitem. Kies de koppeling Nieuwe werkitems en kies vervolgens Taak.

    Dit werkitem wordt gemaakt op basis van het werkitemtype dat u hebt gewijzigd en geïmporteerd.

  11. U ziet dat in het vak Status het label voor het hernoemde veld Rangschikking niet is gewijzigd. Dit komt doordat de veldlabels in de werkitemformulieren zijn afgestemd op het bovenliggende project en onafhankelijk zijn van de serverbrede veldnaam die zojuist is opgegeven.

    Notitie

    Zie Voor meer informatie over het wijzigen van veldlabels in werkitemformulieren control XML-element verwijzing.

  12. Sluit de nieuwe taak en kies Nee wanneer u wordt gevraagd het werkitem op te slaan.

Het rapport wijzigen als waarde voor een veld

Met de volgende opdracht geeft u de mogelijkheid om het type datum/tijd veld AdventureWorks.CreatedOn te rapporteren aan dimensie. Met de gegevens van dit veld worden de warehouse- en Analysis Services-databases ingevoerd, zodat deze kunnen worden gebruikt om rapporten te filteren.

witadmin changefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:AdventureWorks.CreatedOn /reportingtype:dimension

Met de volgende opdracht geeft u de mogelijkheid om het type dubbel veld AdventureWorks.Field te meten. Alle metingen worden geaggregeerd op som.

witadmin reportfield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:AdventureWorks.Field /reportingtype:measure

Synchronisatie van een aangepast veld voor de naam van een persoon inschakelen

Met de volgende opdracht schakelt u synchronisatie in voor het werkitemveld AW. CustomerName gedefinieerd voor Collection1 op de AdventureWorksServer.

Controleer het gegevenstype van het veld dat u wilt converteren

  1. Controleer het gegevenstype dat is toegewezen aan het veld, zoals MyCompany.CustomerName, dat u wilt synchroniseren door de volgende opdracht in te voeren:

    witadmin listfields /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:MyCompany.CustomerName

Synchronisatie inschakelen

  1. Als u synchronisatie wilt inschakelen voor een veld met de naam van een persoon, typt u de volgende opdracht, waarbij u uw gegevens vervangt door de argumenten die hier worden weergegeven:

    witadmin changefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:MyCompany.CustomerName /syncnamechanges:true

  2. De volgende bevestigingsprompt wordt weergegeven:

    Hiermee worden eigenschappen voor het veld {0} op de Team Foundation-server gewijzigd. Wilt u doorgaan?

  3. Typ 0 om te bevestigen dat u het veld wilt wijzigen of 1 om de aanvraag te annuleren.

    Als de wijzigingsaanvraag slaagt, wordt het volgende bevestigingsbericht weergegeven:

    Het veld is bijgewerkt.

    Als de wijzigingsaanvraag mislukt, wordt er een foutbericht weergegeven. De meest voorkomende fouten die kunnen worden gemaakt, zijn het wijzigen van een systeemverwijzingsveld of het wijzigen van een veld van een ander gegevenstype dan Tekenreeks. Deze bewerkingen worden niet ondersteund.

Een veld verwijderen

Voordat u een veld verwijdert, controleert u of het veld niet in gebruik is. Als het veld in gebruik is, moet u eerst het veld verwijderen uit de typen werkitems die het gebruiken voordat u het uit de projectverzameling verwijdert. Met de volgende opdracht wordt het veld AdventureWorks.Field uit Collection1 verwijderd:

witadmin deletefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:AdventureWorks.Field

Controleren of een veld niet wordt gebruikt

  1. Voer de volgende opdracht in, waarbij u de verwijzingsnaam voor het werkitemveld opgeeft, zoals MyCompany.MyProcess.MyField.

    witadmin listfields /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:MyCompany.MyProcess.MyField

    Controleer in de informatie die voor het veld wordt weergegeven of de waarde voor Gebruik 'Niet in gebruik' is als volgt in dit voorbeeld.

    Field: MyCompany.MyProcess.MyField  
Name: MyField  
Type: String  
Reportable As: dimension  
Use: Not In Use  
Indexed: False

  2. Als het veld Gebruiken aangeeft dat het veld in gebruik is, moet u dit verwijderen uit elk werkitemtype voor elk project dat wordt weergegeven. Het veld geeft bijvoorbeeld Microsoft.VSTS.TCM.SystemInfo aan dat het wordt gebruikt door de werkitemtypen Bug en Code Defect voor vier projecten: Arroyo, Desert, Palm en Springs.

    Field: Microsoft.VSTS.TCM.SystemInfo  
Name: System Info  
Type: Html  
Reportable As: None  
Use: Arroyo (Bug), Desert (Bug), Palm (Bug), Springs (Bug, Code Defect)  
Indexed: False

    Voordat u dit veld kunt verwijderen, moet u het verwijderen uit elk van de werkitemtypen die worden vermeld voor elk project waarvoor het is gedefinieerd. Als u het veld wilt verwijderen, wijzigt u de definitie voor het type werkitem door de FIELD en Control elementen te verwijderen die de veldverwijzingsnaam bevatten. Zie Naslaginformatie over werkitems importeren, exporteren en beheren, veldelementreferenties (definitie) en Beheer.

Een veld verwijderen uit een projectverzameling

Voer de volgende opdracht in om het MyCompany.MyProcess.MyField veld te verwijderen en kies Vervolgens Enter.

witadmin deletefield /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /n:RefName

Voer y in bij de bevestigingsprompt om deze stap te voltooien.