Lista fält och attribut för arbetsobjekt

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

En beskrivning av varje fält som definierats med en systemprocess finns i Index för arbetsobjektfält.

Prerequisites

Lista eller granska fält

Om du vill visa eller granska fält använder du något av följande verktyg baserat på din processmodell – Ärvd, värdbaserad XML eller lokal XML. Ett index över fält som definierats i standardprocesserna finns i Fältindex för arbetsobjekt.

Fältdatatyper och namn

Varje typ av arbetsobjekt anger de fält som ingår i arbetsobjekt av den typen. Varje fält har flera attribut, varav många är systemdefinierade och oföränderliga.

Tre attribut definierar fält:

• Datatyp: Anger vilken typ av data som du kan ange i fältet, till exempel boolesk, dubbel, heltal, HTML eller sträng. Detaljerade beskrivningar av varje datatyp finns i Frågefält, operatorer och makron.
• Eget namn: Det användarvänliga namn som tilldelats fältet, som används när du väljer ett fält i en frågesats. Det här namnet kan skilja sig från namnet som visas i arbetsobjektsformuläret.
• Referensnamn: Identifieraren som används när du skapar WIQL-frågor, improviserade arbetsobjektmallar, kör REST API-kommandon eller definierar definitioner av XML-arbetsobjektstyp. Referensnamnet är permanent och kan inte ändras när det har angetts.

En detaljerad beskrivning av varje fältattribut och instruktioner för hur du listar dem finns i Fältattribut och Listfältattribut senare i den här artikeln. En översikt över typer av arbetsobjekt (WIT) och arbetsobjekt finns i Spåra arbete med användarberättelser, problem, buggar, funktioner och epos.

Vad är ett fält? Hur fungerar fältnamn?

Varje typ av arbetsobjekt innehåller 31 systemfält och flera typspecifika fält. Arbetsobjekt hjälper dig att planera och spåra ditt projekt.

Varje fält samlar in specifik information om det arbete som ska utföras. De värden som du tilldelar till dessa fält lagras i datalagret för arbetsspårning, så att du kan skapa frågor som fastställer status och trender.

Beskrivningar och användning av varje fält som definierats för kärnsystemprocesserna – Agile, Basic, Scrum och CMMI – finns i fältindexet Arbetsobjekt.

Fältnamn

Ett fältnamn för arbetsobjekt identifierar unikt varje arbetsobjektfält. Se till att fältnamnen följer följande riktlinjer:

• Unikhet: Fältnamn måste vara unika i kontot eller projektsamlingen.
• Längd: Fältnamn måste innehålla 128 Unicode-tecken eller färre.
• Avstånd: Fältnamn får inte ha inledande eller avslutande blanksteg eller innehålla två eller flera blanksteg i följd.
• Sammansättning: Fältnamn måste innehålla minst ett alfabetiskt tecken.
• Otillåtna tecken: Fältnamn kan inte innehålla följande tecken: .,;':~/*|?" &%$!+=()[]{}<>'.

Eftersom anpassade fält definieras på organisations- eller samlingsnivå kan du inte lägga till ett anpassat fält med samma namn i flera processer.

Mer information finns i Namngivningsbegränsningar och konventioner.

System- och fördefinierade fält

Ett fältnamn för arbetsobjekt identifierar unikt varje fält i Azure DevOps. Se till att fältnamnen följer följande riktlinjer:

• Unikhet: Fältnamn måste vara unika i ett konto eller en projektsamling.
• Längd: Fältnamn måste vara 128 Unicode-tecken eller färre.
• Avstånd: Fältnamn kan inte ha inledande eller avslutande blanksteg eller innehålla flera blanksteg i följd.
• Sammansättning: Fältnamn måste innehålla minst ett alfabetiskt tecken.
• Otillåtna tecken: Fältnamn kan inte innehålla följande tecken: .,;':~/*|?" &%$!+=()[]{}<>'.

Eftersom anpassade fält definieras på organisations- eller samlingsnivå kan du inte lägga till ett anpassat fält med samma namn i flera processer.

Mer information finns i Namngivningsbegränsningar och konventioner.

Anpassade fält

Eftersom anpassade fält definieras på organisations- eller projektsamlingsnivå kan du inte lägga till ett anpassat fält med samma namn i flera processer.

Observera följande gränser när du lägger till anpassade fält:

• Maximalt antal fält per arbetsobjekttyp (WIT): 64
• Maximalt antal fält per process: 512

Fältdatatypen avgör typ och storlek på data som du kan lagra i fältet. Varje fält kan bara ha en typ som definierats i en projektsamling, vilket uppmuntrar till användning av gemensamma fält i olika projekt och arbetsobjekttyper.

När du lägger till ett anpassat fält i en ärvd process tilldelar Azure DevOps ett referensnamn med prefixet Anpassat följt av fältnamnet utan blanksteg. Om du till exempel lägger till ett fält med namnet DevOps Triage resulterar det i referensnamnet Custom.DevOpsTriage. Blanksteg tillåts inte i referensnamn.

Mer information finns i Namngivningsbegränsningar och konventioner.

Hur kan jag fastställa fältdatatypen?

Granska fältlista

Följ dessa steg om du vill granska listan över fält som definierats för en organisation eller samling:

1. Välj Azure DevOps-logotypen för att öppna Projekt. Välj sedan Organisationsinställningar.

   

2. Välj Process.

   

3. Välj Fält.

   Fälten i listan motsvarar alla fält som definierats för organisationen eller samlingen, som innehåller alla anpassade fält och de fält som definierats för systemprocesser.

   

   Note

   Om du inte ser Fält använder samlingen den lokala XML-processen. Fältsidan stöds inte för den processen.

   Beskrivningar, användning och referensnamn för varje fält finns i fältindexet Arbetsobjekt. Dessutom kan du hämta fältreferensnamn med hjälp av REST API för arbetsobjekttyper – lista.

Fältutforskaren för arbetsobjekt

Du kan söka efter tilldelningar av fältattribut med hjälp av verktyget Fältutforskaren för arbetsobjekt.

Om du vill komma åt Fältutforskaren för arbetsobjekt installerar du verktyget Processredigeraren. Baserat på den installerade versionen av Visual Studio hämtar du verktyget Processredigeraren från något av följande tillägg.

• Visual Studio 2019 & 2022: Från och med nu finns det inget specifikt tillägg för processmallsredigeraren. Men du kan fortfarande anpassa processmallar med andra verktyg, till exempel valfri textredigerare eller XML-redigerare. Du kan också använda Azure DevOps-webbportalen för vissa anpassningar, särskilt för ärvda processer.
• Visual Studio 2017: TFS Process Template Editor. Du kan också använda den här versionen av processredigeraren för att ändra de gamla arbetsobjektsformulären. Du kan inte använda den för att redigera formulär som är associerade med de nya webbformulären.
• Visual Studio 2015: TFS Power Tools.

Fältattribut

Det finns många icke-föränderliga och dolda attribut för varje arbetsobjektfält. I följande tabell beskrivs alla attribut. Attribut har olika namn beroende på om du hämtar dem via Fält – Hämta REST API eller visa dem via verktyget Work Item Field Explorer (WIFE).

Attribut som tilldelats ett fält beror på vilken plattform och version du använder. Vissa attribut stöds till exempel inte med arvsprocessen. Information om hur du söker efter ett fälts referensnamn finns i fältindexet Arbetsobjekt.

Lista fältattribut

https://dev.azure.com/OrganizationName/_apis/wit/fields/FieldReferenceName

https://dev.azure.com/fabrikam/_apis/wit/fields/System.IterationPath

{
"name": "Iteration Path",
"referenceName": "System.IterationPath",
"description": "The iteration within which this bug will be fixed",
"type": "treePath",
"usage": "workItem",
"readOnly": false,
"canSortBy": true,
"isQueryable": true,
"supportedOperations": [
{
"referenceName": "SupportedOperations.Under",
"name": "Under"
},
{
"referenceName": "SupportedOperations.NotUnder",
"name": "Not Under"
},
{
"referenceName": "SupportedOperations.Equals",
"name": "="
},
{
"referenceName": "SupportedOperations.NotEquals",
"name": "<>"
},
{
"referenceName": "SupportedOperations.In",
"name": "In"
},
{
"name": "Not In"
}
],
"isIdentity": false,
"isPicklist": false,
"isPicklistSuggested": false,
"url": "https://dev.azure.com/mseng/_apis/wit/fields/System.IterationPath"
}

https://{ServerName:Port}/tfs/{Collection}/_apis/wit/fields/FieldReferenceName?api-version={version}

https://fabrikam:8080/tfs/DefaultCollection/_apis/wit/fields/System.IterationPath?api-version=4.1

{
"name": "Iteration Path",
"referenceName": "System.IterationPath",
"description": "The iteration within which this bug will be fixed",
"type": "treePath",
"usage": "workItem",
"readOnly": false,
"canSortBy": true,
"isQueryable": true,
"supportedOperations": [
{
"referenceName": "SupportedOperations.Under",
"name": "Under"
},
{
"referenceName": "SupportedOperations.NotUnder",
"name": "Not Under"
},
{
"referenceName": "SupportedOperations.Equals",
"name": "="
},
{
"referenceName": "SupportedOperations.NotEquals",
"name": "<>"
},
{
"referenceName": "SupportedOperations.In",
"name": "In"
},
{
"name": "Not In"
}
],
"isIdentity": false,
"isPicklist": false,
"isPicklistSuggested": false,
"url": "https://fabrikam:8080/tfs/DefaultCollection/_apis/wit/fields/System.IterationPath?api-version=4.1"
}

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

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  

Lägga till och ändra fält

Relaterat innehåll