Fält och attribut för arbetsobjekt i Azure Boards

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

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

Förutsättningar

• Om du vill visa fälten som definierats för en organisation eller samling måste du vara medlem i programgruppen Giltiga användare för projektsamling eller ha behörigheten Visa information på instansnivå inställd på Tillåt för organisationen eller samlingen.

Lista eller granska fält

Om du vill visa eller granska fält kan du använda något av följande verktyg, beroende på processmodellen – arv, värdbaserad XML eller lokal XML – som du använder. 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 definierats för de arbetsobjekt som refererar till den typen. Varje fält är associerat med ett antal attribut, varav många anges av systemet och kan inte ändras.

Varje fält definieras av följande tre attribut.

• Datatyp: Anger vilken typ av data som kan anges i fältet, till exempel boolesk, dubbel, heltal, HTML och sträng. Beskrivningar av varje datatyp finns i Frågefält, operatorer och makron.
• Eget namn: Anger det namn som tilldelats fältet och som du väljer för ett fält i en frågesats. Det här namnet kan skilja sig från namnet som visas i arbetsobjektsformuläret.
• Referensnamn: Anger det namn som du använder när du skapar WIQL-fråga eller en improviserad arbetsobjektmall, använder REST API-kommandon eller definierar definitioner av XML-arbetsobjektstyp. När referensnamnet har definierats kan det inte ändras.

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

Vad är ett fält? Hur används fältnamn?

Varje typ av arbetsobjekt är associerad med 31 systemfält och flera fler typspecifika fält. Du använder arbetsobjekt för att planera och spåra projektet.

Varje fält stöder spårning av information om det arbete som ska utföras. Värden som du tilldelar ett fält lagras i datalagret för arbetsspårning som du kan skapa frågor för att fastställa status och trender.

Beskrivningar och användning av varje fält som definierats för kärnsystemprocesserna, Agile-, Basic-, Scrum- och CMMI-processer finns i Fältindex för arbetsobjekt.

Fält-namn:

Ett fältnamn för arbetsobjekt identifierar unikt varje arbetsobjektfält. Kontrollera att fältnamnen ligger inom dessa riktlinjer:

• Fältnamn måste vara unika i konto-/projektsamlingen
• Fältnamnen måste vara 128 eller färre Unicode-tecken
• Fältnamn får inte innehålla inledande eller avslutande blanksteg eller två eller flera blanksteg i följd
• Fältnamn måste innehålla minst ett alfabetiskt tecken
• Fältnamn får inte innehålla följande tecken: .,;'`:~\/\*|?"&%$!+=()[]{}<>.

Eftersom anpassade fält har definierats för en organisation eller samling kan du inte lägga till ett anpassat fält i en process med samma fältnamn som du lägger till i en annan process.

Mer information finns i Namngivningsbegränsningar och konventioner.

System- och fördefinierade fält

Alla systemdefinierade fält har referensnamn som börjar med System, till exempel System.AreaPath, System.AssignedTo och fortsätter i det mönstret.

Fördefinierade fält som definieras av standardprocessen börjar med Microsoft.VSTS och skiljer sig sedan ytterligare beroende på deras användning. Exempel på fördefinierade fält som används gemensamt, för schemaläggning och integrering med Office Project, för integrering med Team Foundation Build och integrering med testfallshantering (TCM) är följande:

• Microsoft.VSTS.Common.Priority
• Microsoft.VSTS.Scheduling.DueDate
• Microsoft.VSTS.Build.FoundIn
• Microsoft.VSTS.TCM.Steps

En översikt över alla system- och fördefinierade fält som har definierats för standardprocesser/processmallar finns i Fältindex för arbetsobjekt. Mer information om hur du anger fältnamn finns i Namngivningsbegränsningar.

Anpassade fält

Eftersom anpassade fält har definierats för en organisation eller projektsamling kan du inte lägga till ett anpassat fält i en process med samma fältnamn som du lägger till i en annan process.

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

• Högst 64 fält kan definieras för varje WIT
• Högst 512 fält kan definieras per process

Fältdatatypen avgör typ och storlek på data som du kan lagra i fältet. Ett fält kan bara ha en typ som definierats i en projektsamling. Den här begränsningen uppmuntrar organisationer att använda vanliga fält mellan projekt och arbetsobjektstyper.

Hur kan jag fastställa fältdatatypen?

Fältutforskaren för arbetsobjekt

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

För att få åtkomst till Fältutforskaren för arbetsobjekt måste du installera verktyget Processredigeraren. Baserat på vilken version av Visual Studio du har installerat 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-ändringsbara och dolda attribut för varje arbetsobjektfält. I följande tabell beskrivs alla attribut. Attribut har olika namn baserat på om du får dem via verktyget Fält – HämtaREST 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 har till exempel inte stöd för arvsprocessen. Information om hur du letar upp referensnamnet för ett fält finns i Index för arbetsobjektfält.

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

Relaterade artiklar