Lista fält och attribut för arbetsobjekt

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

Arbetsobjektfält används för att spåra information i Azure DevOps. Dessa fält definieras på organisationsnivå och delas mellan alla projekt i organisationen. Om du vill granska fälten som definierats för din organisation kan du använda något av följande två verktyg, som är tillgängliga för både ärvda och värdbaserade XML-processmodeller:

• Sidan Processfält >
• Fältutforskaren för arbetsobjekt

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

Förutsättningar

Behörigheter: Om du vill visa fälten som definierats för en organisation eller samling är du medlem i programgruppen För giltiga användare för projektsamling eller har 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 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.

Verktyg	Arv	Värdbaserad XML	Lokal XML
Webbportal: Lista ärvda och anpassade fält	✔️	✔️1
Fältutforskaren för arbetsobjekt	✔️	✔️	✔️
kommandoradsverktyget witadmin listfields	✔️	✔️	✔️

Kommentar

1. Stöds endast för standardprocesser (Agile, CMMI, Scrum).

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.

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 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 används fältnamn?

Varje typ av arbetsobjekt innehåller 31 systemfält och flera typspecifika fält. Arbetsobjekt används för att planera och spåra projektet.

Varje fält samlar in specifik information om det arbete som ska utföras. De värden som du tilldelar 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ält-namn:

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 kan lagras 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?

Du kan visa datatypen för fält som definierats för din organisation genom att öppna sidan Processfält>.

Granska fältlista

Gör följande för att 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.

   

   Kommentar

   Om du inte ser Fält använder samlingen den lokala XML-processen. Sidan Fält 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.

Attribut

Attributtyp

Beskrivning

---

REST:
FRU: AllowedValues

samling

Hämtar samlingen med giltiga värden för ett fält som innehåller listlistevärden. Du kan ändra detta genom att ange en listruta eller global lista (lokalt).
Kan ändras?=Ja

REST: canSortBy
FRU: CanSortBy

boolean

Anger om du kan sortera frågeresultat med det här fältet.
Kan ändras?=Nej

REST: beskrivning
FRU: HelpText

sträng

Anger en beskrivning för fältet, som också definierar hjälptexten som visas när du hovrar över fältet i arbetsobjektsformuläret.
Kan ändras?=Ja

REST:
FRU: ID

Integer

Anger fältets interna ID.
Kan ändras?=Nej

REST:
FRU: IsCloneable

boolean

Anger om värdet som definierats för fältet kopieras när en användare väljer att kopiera ett arbetsobjekt. Till exempel kopieras fälten Rubrik, Taggar och Beskrivning , men fälten ID och Historik kopieras inte.
Kan ändras?=Nej

REST:
Fru: IsComputed

boolean

Anger om värdet som anges av det här fältet beräknas av systemet (Sant) eller inte (Falskt). Exempel på beräknade fält är de som anges av systemet, till exempel ID, Reviderat datum, Ändrat datum och Antal externa länkar.
Kan ändras?=Nej

REST:
Fru: IsCoreField

boolean

Anger om det här fältet har angetts för alla typer av arbetsobjekt.
Kan ändras?=Nej

REST:
FRU: ÄrRedigerbar

boolean

Anger om användarna kan ändra det här fältet (Sant) eller inte (falskt). Exempel på icke-tillgängliga fält är fält som anges av systemet, till exempel fälten ID, Revision, Skapad av och Ändrad av
Kan ändras?=Nej

REST: isIdentity
FRU: Isidentity

boolean

Anger om det här fältet är ett identitetsfält . Identitetsfält är strängfält som används för att lagra användaridentiteter.
Kan ändras?=Nej

REST:
FRU: IsIndexed¹

boolean

Anger om det här fältet är indexerat för sökning.
Kan ändras?=Nej

REST:
FRU: IsLongText

boolean

Anger att fältet kan innehålla mer än 255 tecken, till exempel fält som tilldelats en datatyp av oformaterad text, HTML eller historik.
Kan ändras?=Nej

REST: isPicklist² FRU:

Booleskt

Anger om fältet är associerat med en listruta. Värdet anges till Sant när ett anpassat fält har definierats för Azure DevOps- och Picklist-typ (sträng) eller listruta (heltal). Värdet är inställt på False för ärvda fält som definierar listrutor.
Kan ändras?=Nej

REST: isPicklistSuggested² FRU:

Booleskt

Anger om fältet tillåter användare att ange sina egna värden för en listruta. Värdet är inställt på Sant när ett anpassat fält har definierats för Azure DevOps- eller Picklist-typen (Sträng) eller Picklist (Heltal), och kryssrutan Tillåt användare att ange sina egna värden är markerad.
Kan ändras?=Ja

REST: isQueryable
Fru: IsQueryable

boolean

Anger om fältet visas i uppsättningen med fält som du kan lägga till för att filtrera en arbetsobjektfråga (Sant) eller inte (Falskt). De flesta fält är frågebara.
Kan ändras?=Nej

REST:
FRU: IsReportable ³

boolean

Anger om det rapportbara attributet har definierats eller angetts till något annat än Inget. Det här attributet kan ändras för lokala miljöer.
Kan ändras?=Ja

REST:
FRU: IsUsedInGlobalWorkflow

boolean

Anger om fältet har definierats i ett globalt arbetsflöde.
Kan ändras?=Nej

REST:
FRU: IsUserNameField

boolean

Anger om fältet används för att visa ett identitetsfält.
Kan ändras?=Nej

REST: name
FRU: Namn

sträng

Eget namn som tilldelats fältet. Det egna namnet kan inte ändras för Azure DevOps, men kan ändras lokalt med hjälp av kommandot witadmin changefield .
Kan bara ändras?=Lokalt

REST: picklistId
FRU: HelpText

GUID

Om fältet är en listruta, identifieraren för den associerade listrutan, annars null. Ett unikt GUID-värde tilldelas när ett anpassat fält har definierats för Azure DevOps- och Picklist-typen (Sträng) eller Picklist (Heltal).
Kan ändras?=Nej

REST:
FRU: ProhibitedValues

samling

Hämtar samlingen med förbjudna värden för ett fält som anger sådana värden. Du kan bara definiera förbjudna värden för lokala distributioner.
Kan bara ändras?=Lokalt

REST: readOnly
HUSTRU:

Booleskt

Anger om fältet är skrivskyddat. För Azure DevOps Services kan endast anpassade fält ändras till skrivskyddade. Det går inte att ändra systemfält.
Kan ändras?=Ja

REST: referenceName
FRU: ReferenceName

sträng

Anger referensnamnet för ett fält.
Kan ändras?=Nej

REST:
FRU: ReportingAttributes³

Anger information, dimension eller mått, beroende på om och hur du vill att fältet ska inkluderas i rapporter. Data från fält som har ett annat värde än Ingen för det här attributet exporteras till informationslagret och kan tas med i SQL-rapporter.
Kan bara ändras?=Lokalt

REST:
FRU: ReportingName³

sträng

Anger etiketten för ett fält när data visas i SQL-rapporter. Om du inte anger något värde används fältets eget namn.
Kan bara ändras?=Lokalt

REST:
FRU: ReportingReferenceName³

sträng

Anger ett annat referensnamn än ett fält som används när data exporteras till relationsdatalagret. Om du inte anger något värde används fältreferensnamnet.
Kan bara ändras?=Lokalt

REST: supportedOperations
HUSTRU:

ställa

Den uppsättning frågeoperatorer som är giltiga för användning när du refererar till det här fältet. En snabbreferens för åtgärder som stöds baserat på datatyp finns i Snabbreferens för frågor, Operatorer och makron som stöds för varje datatyp.
Kan ändras?=Nej

REST:
FRU: SupportsTextQuery

boolean

Anger om fältet stöder textfrågor som Innehåller ord, Innehåller inte ord.
Kan ändras?=Nej

REST:
FRU: SystemType

sträng

Anger datatypen för fältet och refererar till systemnamnet, till exempel System.DateTime eller System.String.
Kan ändras?=Nej

REST: typ
FRU: FieldType

sträng

Anger datatypen för fältet, till exempel Booleskt värde, DateTime, Heltal, Sträng och så vidare. En fullständig lista och beskrivningar finns i Frågefält, operatorer och makron.
Kan ändras?=Nej

REST: användning
FRU: Användning

sträng

Anger om fältet är avsett att användas med arbetsobjekt (WorkItem) eller arbetsobjektlänkobjekt (WorkItemLink). Användningen för de flesta fält är WorkItem. En fullständig lista över användningsvärden finns i Hämta fält, FieldUsage.
Kan ändras?=Nej

Kommentar

1. För lokala distributioner kan du aktivera indexering för ett fält för att förbättra frågesvarstiderna vid filtrering på fältet. Mer information finns i Indexerade fält senare i den här artikeln.
2. Attributen isPicklist och isPicklistSuggested tilldelas endast till anpassade fält som definierats för en ärvd process. Den ärvda processmodellen stöds för Azure DevOps Server 2019 och senare versioner. Mer information finns i Ärvd processmodell.
3. Alla rapportattribut är endast giltiga för lokala distributioner vars projekt har konfigurerats för att stödja SQL Server Reporting och SQL Server Analysis Services.

Lista fältattribut

Du kan visa en lista över de attribut som tilldelats ett fält med hjälp av Fält – Hämta REST API. Ersätt OrganizationName med ditt faktiska organisationsnamn.

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

Om du till exempel vill visa attributen för iterationssökvägen använder du referensnamnet System.IterationPath för organisationen fabrikam :

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

**Returned data:**

> [!div class="tabbedCodeSnippets"]
> ```JSON
> {
> "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"
> }
> ```

Lägga till och ändra fält

Om du vill lägga till fält i en process lägger du till dem i en eller flera typer av arbetsobjekt. Mer information finns i Anpassa en arvsprocess.

Relaterade artiklar

• Se snabbreferensen fråga för att snabbt förstå frågesyntax och användning.
• Utforska fältindexet Arbetsobjekt för att visa alla tillgängliga arbetsobjektfält.
• Lägg till och hantera fält för en ärvd process för att anpassa fält enligt dina ärvda processkrav.
• Få åtkomst till metadatareferensen för Azure Boards Analytics för att förstå analysmetadata och rapporteringsfunktioner.