Hantera arbetsobjektfält

Azure DevOps Services | Azure DevOps Server 2022 – Azure DevOps Server 2019

Du kan hantera de fält som definierats för arbetsobjekttyper som har definierats för en projektsamling (lokal XML) med hjälp av följande witadmin-kommandon . Om du vill lägga till ett globalt fält (giltigt för lokal XML) kan du göra det genom att ändra den globala arbetsflödesfilen och importera den till samlingen.

witadmin Kör kommandoradsverktyget

Om du vill köra witadmin kommandoradsverktyget öppnar du ett kommandotolkfönster där Visual Studio är installerat. Kommandoradsverktyget witadmin installeras med valfri version av Visual Studio. Du kan komma åt det här verktyget genom att installera den kostnadsfria versionen av Visual Studio Community eller Visual Studio Team Explorer.

För Visual Studio 2022

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

eller Professional Enterprise i stället för Community, beroende på vilken version du har installerat.

För Visual Studio 2019

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

eller Professional Enterprise i stället för Community, beroende på vilken version du har installerat.

För Visual Studio 2017

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

eller TeamExplorer Professional i stället för Enterprise, beroende på vilken version du har installerat.

I en 32-bitarsversion av Windows ersätter du %programfiles(x86)% med %programfiles%. Du kan installera Visual Studio Community (som ger åtkomst till Team Explorer) eller Visual Studio Team Explorer 2017 utan kostnad.

En översikt över de fält som definierats i en standardprocessmall finns i Index för arbetsobjektfält.

Förutsättningar

• Om du vill visa fält måste du ha behörigheten Visa information på projektnivå för projektet i samlingen som Tillåt.
• Om du vill ta bort eller byta namn på fält eller ändra ett attribut för ett fält måste du vara medlem i säkerhetsgruppen Team Foundation-administratörer eller säkerhetsgruppen Administratörer för projektsamling.

Mer information finns i Ändra behörigheter på projektsamlingsnivå.

Syntax

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]  

Parametrar

Synkronisera personnamn med Active Directory

Du måste aktivera synkronisering manuellt av alla anpassade arbetsobjektfält som används för att tilldela personnamn som refererar till Active Directory. Du måste aktivera synkronisering för varje fält för varje projektsamling som innehåller de anpassade fälten.

Alla systemreferensfält som visar personnamn har attributet syncnamechanges inställt på true. Sådana fält är System.AuthorizedAs, System.AssignedTo, System.ChangedBy och System.CreatedBy. Synkronisering i aktiverat för varje personnamnfält som definieras i någon av standardprocessmallarna. Mer information finns i Tilldelningar och arbetsflödesfält.

När synkroniseringen har aktiverats visar fältet inte längre en statisk sträng. I stället visar fältet namnet som är associerat med ett användarkonto. När du ändrar användarnamnet i Active Directory eller i Workgroup visas det nya namnet automatiskt i ett fält med syncnamechanges inställt på true .

När du tilldelar syncnamechanges attributet till ett strängfält accepterar fältet alltid giltiga användarnamn. Fältet tillåter dock inte gruppnamn som lagras i Team Foundation Server eller i Active Directory om något av följande villkor är true:

• Regeln VALIDUSER anges för alla typer av arbetsobjekt

• Regeln VALIDUSER anges för en typ av arbetsobjekt

• Regeln ALLOWEDVALUES anges för en typ av arbetsobjekt och regeln har ett filtervillkor som exkluderar grupper

  Mer information finns i Alla FÄLT-element.

Attribut som du kan ändra för varje typ av arbetsobjekt

Du ändrar följande attribut eller värden som definierats för ett fält genom att ändra definitionen för arbetsobjekttyp där fältet visas:

• Namn som visas i arbetsobjektsformuläret. Se Referens för WebLayout- och Kontrollelement eller Kontroll-XML-element.
• Hjälptext. Se Regler och regelutvärdering.
• Tillåtna värden eller objekt i en listruta eller listruta. Se XML-elementen ALLOWEDVALUES, SUGGESTEDVALUES och PROHIBITEDVALUES.

Exempel

Om inget annat anges gäller följande värden i varje exempel:

• URI för projektsamlingen: http://AdventureWorksServer:8080/tfs/DefaultCollection
• Namn på arbetsobjektfält: AdventureWorks.Field
• Standardkodning: UTF-8

Listfält

Använd witadmin listfields för att se vilken uppsättning fält som används för att välja en som ska läggas till i en arbetsobjektstyp. Du kan också lista de attributtilldelningar som definierats för ett visst fält och avgöra vilka fält som används av vilka projekt.

Visa attributen för ett arbetsobjektfält

• Ange följande kommando för att visa de attribut som definierats för ett angivet fält, till exempel Microsoft.VSTS.Common.Issue.

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

  Fält- och attributinformation visas för det namngivna fältet, som du ser i det här exemplet.

  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  
  

  Parametern Använd anger namnet på varje projekt och arbetsobjekttypen där fältet används. Mer information om fältattribut finns i Index för arbetsobjektfält.

Visa en lista över alla fält i en projektsamling

• Ange följande kommando för att visa en lista över alla fält som har definierats för en projektsamling.

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

  Fältinformation för alla fält för den namngivna projektsamlingen visas. Se Index för arbetsobjektfält.

Lista fält som inte används

• Ange följande kommando för att visa de fält som inte längre används i projektsamlingen av någon typ av arbetsobjekt.

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

  Fält- och attributinformation visas för varje fält som inte används, som du ser i det här exemplet.

  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  
  

Byt namn på ett fält

Du kan ändra det egna namnet på ett arbetsobjektfält så att det uppfyller de namngivningskonventioner som ditt team använder. Observera att det nya namnet tillämpas på alla typer av arbetsobjekt som refererar till det ändrade fältet i alla projekt i projektsamlingen. Det egna namnet visas när du definierar filtervillkor i en arbetsobjektfråga. Namnet som visas i ett arbetsobjektformulär kan skilja sig från det eget namn som definierats för fältet.

Byta namn på ett arbetsobjektfält

1. Ange följande kommando för att byta namn på det egna namn som tilldelats till Microsoft.VSTS.Common.Rank Viktig rangordning.

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

2. I bekräftelsemeddelandet skriver du y och trycker sedan på RETUR. Vänta tills du får följande meddelande:

   Fältet har bytt namn.

Så här verifierar du ändringar som importerats till ett enskilt projekt

1. I Team Explorer väljer du Uppdatera.

   De senaste uppdateringarna laddas ned från servern, som innehåller de ändringar som du precis har gjort i fältnamnet. Vänta några sekunder tills uppdateringen har slutförts.

2. Välj Ny fråga för att skapa en fråga.

3. I Uređivač upita väljer du länken Klicka här för att lägga till en satslänk för att lägga till en rad, markerar den tomma fältcellen och skriver Rank i cellen. Följande meddelande visas ovanför resultatlistan. Det här meddelandet anger att rankningen inte kan hittas.

   Kör frågan för att se frågeresultatet. TF51005: Frågan refererar till ett fält som inte finns. Felet orsakas av <<rankning>>.

4. Ta bort värdet Rank från cellen Fält och skriv Viktig rangordning i cellen.

5. Välj <> i cellen Operator och skriv 1 i cellen Värde .

6. I verktygsfältet Fråga väljer du Kör.

7. Öppna snabbmenyn för valfri rad i resultatet och välj Kolumnalternativ. Rulla nedåt i listan Tillgängliga kolumner . Observera att fältet Rank inte längre finns men att fältet Viktig rankning finns.

8. Välj Viktig rangordning i rutan Tillgängliga kolumner och välj > sedan knappen (lägg till valda kolumner). Välj OK.

   Observera att det egna namnet för Microsoft.VSTS.Common.Rank har bytt namn från Rank till Viktig rangordning i frågeverktyget och resultatlistan.

9. Stäng frågan. Välj Nej när du uppmanas att spara frågan.

10. Skapa ett nytt uppgiftsarbetsobjekt. Välj länken Nya arbetsobjekt och välj sedan Aktivitet.

    Det här arbetsobjektet skapas från den arbetsobjekttyp som du har ändrat och importerat.

11. Observera i rutan Status att etiketten för det omdöpta fältet Rank inte har ändrats. Det beror på att fältetiketterna i arbetsobjektsformulären är begränsade till det överordnade projektet och är oberoende av det serveromfattande fältnamn som just angetts.

    Kommentar

    Mer information om hur du ändrar fältetiketter i arbetsobjektsformulär finns i Referens för kontroll av XML-element.

12. Stäng den nya aktiviteten och välj Nej när du uppmanas att spara arbetsobjektet.

Ändra rapporten som värde för ett fält

Följande kommando anger möjligheten att rapportera typen av DateTime-fältet AdventureWorks.CreatedOn till dimension. Det här fältets data anger informationslagret och Analysis Services-databaserna så att de kan användas för att filtrera rapporter.

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

Följande kommando anger möjligheten att rapportera typen av fältet Double AdventureWorks.Field som ska mätas. Alla mått aggregeras med summa.

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

Aktivera synkronisering av ett anpassat namnfält

Följande kommando aktiverar synkronisering för arbetsobjektfältet AW. CustomerName har definierats för Collection1 på AdventureWorksServer.

Kontrollera datatypen för det fält som du vill konvertera

1. Kontrollera den datatyp som tilldelats fältet, till exempel MyCompany.CustomerName, som du vill synkronisera genom att ange följande kommando:

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

Aktivera synkronisering

1. Om du vill aktivera synkronisering för ett personnamnsfält skriver du följande kommando och ersätter dina data med de argument som visas här:

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

2. Följande bekräftelsefråga visas:

   Detta ändrar egenskaperna för fältet {0} på Team Foundation Server. Vill du fortsätta?

3. Skriv 0 för att bekräfta att du vill ändra fältet eller 1 för att avbryta begäran.

   Om ändringsbegäran lyckas visas följande bekräftelsemeddelande:

   Fältet uppdaterades.

   Om ändringsbegäran misslyckas visas ett felmeddelande. De vanligaste misstagen som kan göras är att försöka ändra ett systemreferensfält eller försöka ändra ett fält av en annan datatyp än Sträng. Dessa åtgärder stöds inte.

Ta bort ett fält

Innan du tar bort ett fält kontrollerar du att fältet inte används. Om fältet används måste du först ta bort fältet från de arbetsobjekttyper som använder det innan du tar bort det från projektsamlingen. Följande kommando tar bort fältet AdventureWorks.Field från Collection1:

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

Kontrollera att ett fält inte används

1. Ange följande kommando och ange referensnamnet för arbetsobjektfältet, till exempel MyCompany.MyProcess.MyField.

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

   I den information som visas för fältet kontrollerar du att värdet för Använd är "Inte använd" enligt följande i det här exemplet.

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

2. Om fältet Använd anger att fältet används måste du ta bort det från varje arbetsobjekttyp för varje projekt som visas. Fältet anger till exempel Microsoft.VSTS.TCM.SystemInfo att det används av arbetsobjekttyperna Fel- och kodfel för fyra projekt: Arroyo, Desert, Palm och 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  
   

   Innan du kan ta bort det här fältet måste du ta bort det från var och en av de arbetsobjekttyper som anges för varje projekt som det har definierats för. Om du vill ta bort fältet ändrar du definitionen för arbetsobjekttypen genom att ta bort elementen FIELD och Control som innehåller fältets referensnamn. Se Importera, exportera och hantera arbetsobjekttyper, FÄLT-elementreferens (Definition) och Kontroll.

Ta bort ett fält från en projektsamling

Ange följande kommando för att ta bort fältet MyCompany.MyProcess.MyField och välj sedan Retur.

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

Ange y i bekräftelseprompten för att slutföra det här steget.

Relaterade artiklar

• Anpassa din arbetsspårningsupplevelse
• Index för arbetsuppgiftsfält
• witAdmin: Anpassa och hantera objekt för spårningsarbete