Lijst met werkitemvelden en -kenmerken

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Velden voor werkitems worden gebruikt om informatie in Azure DevOps bij te houden. Deze velden worden gedefinieerd op organisatieniveau en worden gedeeld in alle projecten in de organisatie. Als u de gedefinieerde velden voor uw organisatie wilt bekijken, kunt u een van de volgende twee hulpprogramma's gebruiken, die beschikbaar zijn voor zowel overgenomen als gehoste XML-procesmodellen:

• Webpagina Procesvelden >
• WerkitemVeldverkenner

Zie de veldindex Werkitem voor een beschrijving van elk veld dat is gedefinieerd met een systeemproces.

Vereisten

Machtigingen: als u de velden wilt weergeven die zijn gedefinieerd voor een organisatie of verzameling, moet u lid zijn van de toepassingsgroep Geldige gebruikers van Projectverzameling of de machtiging Gegevens op exemplaarniveau weergeven ingesteld op Toestaan voor de organisatie of verzameling.

Velden weergeven of controleren

Als u velden wilt weergeven of controleren, gebruikt u een van de volgende hulpprogramma's op basis van uw procesmodel: overgenomen, gehoste XML of on-premises XML. Zie de veldindex Werkitem voor een index van velden die zijn gedefinieerd in de standaardprocessen.

Hulpprogramma	Overname	Gehoste XML	On-premises XML
Webportal: Overgenomen en aangepaste velden weergeven	✔️	✔️1
Veldverkenner voor werkitems	✔️	✔️	✔️
opdrachtregelprogramma witadmin listfields	✔️	✔️	✔️

Notitie

1. Alleen ondersteund voor standaardprocessen (Agile, CMMI, Scrum).

Veldgegevenstypen en -namen

Elk type werkitem geeft de velden op die zijn opgenomen in werkitems van dat type. Elk veld heeft meerdere kenmerken, waarvan veel door het systeem gedefinieerd en onveranderbaar zijn.

Velden worden gedefinieerd door de volgende drie kenmerken:

• Gegevenstype: Geeft het soort gegevens aan dat in het veld kan worden ingevoerd, zoals Booleaanse waarde, Double, Integer, HTML of String. Zie Queryvelden, operators en macro's voor gedetailleerde beschrijvingen van elk gegevenstype.
• Beschrijvende naam: De gebruiksvriendelijke naam die aan het veld is toegewezen, wordt gebruikt bij het selecteren van een veld in een querycomponent. Deze naam kan afwijken van de naam die wordt weergegeven in het werkitemformulier.
• Referentienaam: de id die wordt gebruikt bij het maken van WIQL-query's, geïmproviseerde werkitemsjablonen, het uitvoeren van REST API-opdrachten of het definiëren van definities van het type XML-werkitem. De verwijzingsnaam is permanent en kan niet worden gewijzigd zodra deze is ingesteld.

Zie Veldkenmerken en Lijstveldkenmerken verderop in dit artikel voor een gedetailleerde beschrijving van elk veldkenmerk en instructies voor het weergeven ervan. Raadpleeg Werk bijhouden met gebruikersverhalen, problemen, bugs, functies en epics voor een overzicht van werkitems (WIT's) en werkitems.

Wat is een veld? Hoe worden veldnamen gebruikt?

Elk type werkitem bevat 31 systeemvelden en verschillende typespecifieke velden. Werkitems worden gebruikt om uw project te plannen en bij te houden.

Elk veld legt specifieke informatie vast over het werk dat moet worden uitgevoerd. De waarden die u aan deze velden toewijst, worden opgeslagen in het gegevensarchief voor het bijhouden van werk, zodat u query's kunt maken die de status en trends bepalen.

Raadpleeg de veldindex werkitems voor beschrijvingen en het gebruik van elk veld dat is gedefinieerd voor de kernsysteemprocessen ( Agile, Basic, Scrum en CMMI).

Veldnamen

Een veldnaam voor werkitems identificeert elk werkitemveld op unieke wijze. Zorg ervoor dat uw veldnamen voldoen aan de volgende richtlijnen:

• Uniekheid: veldnamen moeten uniek zijn binnen het account of de projectverzameling.
• Lengte: veldnamen moeten 128 Unicode-tekens of minder bevatten.
• Afstand: veldnamen mogen geen voorloop- of volgspaties bevatten of twee of meer opeenvolgende spaties bevatten.
• Samenstelling: veldnamen moeten ten minste één alfabetisch teken bevatten.
• Verboden tekens: veldnamen mogen niet de volgende tekens bevatten: .,;':~/*|?" &%$!+=()[]{}<>'.

Omdat aangepaste velden zijn gedefinieerd op organisatie- of verzamelingsniveau, kunt u geen aangepast veld met dezelfde naam toevoegen aan meerdere processen.

Zie Naamgevingsbeperkingen en conventies voor meer informatie.

Systeem- en vooraf gedefinieerde velden

Een veldnaam voor een werkitem identificeert elk veld in Azure DevOps op unieke wijze. Zorg ervoor dat uw veldnamen voldoen aan de volgende richtlijnen:

• Uniekheid: veldnamen moeten uniek zijn binnen een account of projectverzameling.
• Lengte: Veldnamen moeten 128 Unicode-tekens of minder zijn.
• Afstand: veldnamen mogen geen voorloop- of volgspaties hebben of meerdere opeenvolgende spaties bevatten.
• Samenstelling: veldnamen moeten ten minste één alfabetisch teken bevatten.
• Verboden tekens: veldnamen mogen niet de volgende tekens bevatten: .,;':~/*|?" &%$!+=()[]{}<>'.

Omdat aangepaste velden zijn gedefinieerd op organisatie- of verzamelingsniveau, kunt u geen aangepast veld met dezelfde naam toevoegen aan meerdere processen.

Zie Naamgevingsbeperkingen en conventies voor meer informatie.

Aangepaste velden

Omdat aangepaste velden zijn gedefinieerd op organisatie- of projectverzamelingsniveau, kunt u geen aangepast veld met dezelfde naam toevoegen aan meerdere processen.

Let op de volgende limieten bij het toevoegen van aangepaste velden:

• Maximum aantal velden per werkitemtype (WIT): 64
• Maximum aantal velden per proces: 512

Het gegevenstype veld bepaalt het soort en de grootte van de gegevens die in het veld kunnen worden opgeslagen. Elk veld kan slechts één type hebben dat in een projectverzameling is gedefinieerd, wat het gebruik van algemene velden in verschillende projecten en werkitemtypen aanmoedigt.

Wanneer u een aangepast veld toevoegt aan een overgenomen proces, wijst Azure DevOps een verwijzingsnaam toe die voorafgegaan wordt door Aangepast , gevolgd door de veldnaam zonder spaties. Als u bijvoorbeeld een veld met de naam DevOps Triage toevoegt , resulteert dit in de verwijzingsnaam Custom.DevOpsTriage. Spaties zijn niet toegestaan in referentienamen.

Zie Naamgevingsbeperkingen en conventies voor meer informatie.

Hoe kan ik het veldgegevenstype bepalen?

U kunt het gegevenstype van velden bekijken die voor uw organisatie zijn gedefinieerd door de pagina Procesvelden>te openen.

Lijst met velden controleren

Voer de volgende stappen uit om de lijst met velden te bekijken die zijn gedefinieerd voor een organisatie of verzameling:

1. Selecteer het Azure DevOps-logo om Projecten te openen. Kies vervolgens Organisatie-instellingen.

   

2. Selecteer Verwerken.

   

3. Selecteer Velden.

   Velden die worden vermeld, komen overeen met alle velden die zijn gedefinieerd voor de organisatie of verzameling, inclusief alle aangepaste velden en de velden die zijn gedefinieerd voor systeemprocessen.

   

   Notitie

   Als u Velden niet ziet, gebruikt uw verzameling het on-premises XML-proces. De pagina Velden wordt niet ondersteund voor dat proces.

   Raadpleeg de index van het veld Werkitem voor beschrijvingen, het gebruik en de verwijzingsnamen van elk veld. Daarnaast kunt u veldverwijzingen ophalen met behulp van het veld Werkitemtypen - REST API voor lijst.

WerkitemVeldverkenner

U kunt de toewijzingen van veldkenmerken opzoeken met behulp van het hulpprogramma Veldverkenner voor werkitems.

Installeer het hulpprogramma Proceseditor om toegang te krijgen tot de Veldverkenner voor werkitems. Haal op basis van uw geïnstalleerde versie van Visual Studio het hulpprogramma Process Editor op uit een van de volgende extensies.

• Visual Studio 2019 &2022: Vanaf nu is er geen specifieke extensie voor processjablooneditor beschikbaar. U kunt echter nog steeds processjablonen aanpassen met andere hulpprogramma's, zoals een teksteditor of XML-editor. U kunt ook de Azure DevOps-webportal gebruiken voor bepaalde aanpassingen, met name voor overgenomen processen.
• Visual Studio 2017: TFS Process Template Editor. U kunt deze versie van de proceseditor ook gebruiken om de formulieren voor oude werkitems te wijzigen. U kunt deze niet gebruiken om formulieren te bewerken die zijn gekoppeld aan de nieuwe webformulieren.
• Visual Studio 2015: TFS Power Tools.

Veldkenmerken

Er zijn veel niet-onveranderbare en verborgen kenmerken voor elk werkitemveld. In de volgende tabel wordt elk kenmerk beschreven. Kenmerken hebben verschillende namen, afhankelijk van of u ze ophaalt via de Velden - REST API ophalen of weergeven via het hulpprogramma Work Item Field Explorer (WIFE).

Kenmerken die aan een veld zijn toegewezen, zijn afhankelijk van het platform en de versie die u gebruikt. Sommige kenmerken worden bijvoorbeeld niet ondersteund bij het overnameproces. Als u de verwijzingsnaam voor een veld wilt opzoeken, raadpleegt u de veldindex Werkitem.

Attribuut

Kenmerktype

Beschrijving

---

REST:
VROUW: AllowedValues

verzameling

Hiermee haalt u de verzameling geldige waarden op voor een veld dat waarden in de selectielijst bevat. U kunt dit wijzigen door een selectielijst of globale lijst op te geven (on-premises).
Kan wijzigen?=Ja

REST: canSortBy
VROUW: CanSortBy

boolean

Hiermee wordt aangegeven of u queryresultaten met dit veld kunt sorteren.
Kan wijzigen?=Nee

REST: beschrijving
VROUW: HelpText

tekenreeks

Hiermee geeft u een beschrijving voor het veld op, waarmee ook de Help-tekst wordt gedefinieerd die wordt weergegeven wanneer u de muisaanwijzer boven het veld in het werkitemformulier plaatst.
Kan wijzigen?=Ja

REST:
VROUW: ID

Geheel getal

Hiermee geeft u de interne id van het veld.
Kan wijzigen?=Nee

REST:
VROUW: IsCloneable

boolean

Hiermee wordt aangegeven of de waarde die voor het veld is gedefinieerd, wordt gekopieerd wanneer een gebruiker ervoor kiest een werkitem te kopiëren. De velden Titel, Tags en Beschrijving worden bijvoorbeeld gekopieerd, maar de velden Id en Geschiedenis worden niet gekopieerd.
Kan wijzigen?=Nee

REST:
VROUW: IsComputed

boolean

Geeft aan of de waarde die door dit veld is ingesteld, wordt berekend door het systeem (Waar) of niet (Onwaar). Voorbeelden van berekende velden zijn velden die zijn ingesteld door het systeem, zoals de id, herziene datum, gewijzigde datum en aantal externe koppelingen.
Kan wijzigen?=Nee

REST:
VROUW: IsCoreField

boolean

Hiermee wordt aangegeven of dit veld is opgegeven voor alle typen werkitems.
Kan wijzigen?=Nee

REST:
VROUW: IsEditable

boolean

Geeft aan of gebruikers dit veld (Waar) of niet (Onwaar) kunnen wijzigen. Voorbeelden van niet-bewerkbare velden zijn velden die door het systeem worden ingesteld, zoals de velden ID, Revisie, Gemaakt door en Gewijzigd door
Kan wijzigen?=Nee

REST: isIdentity
VROUW: IsIdentity

boolean

Hiermee wordt aangegeven of dit veld een identiteitsveld is. Identiteitsvelden zijn tekenreeksvelden die worden gebruikt om gebruikersidentiteiten op te slaan.
Kan wijzigen?=Nee

REST:
VROUW: IsIndexed¹

boolean

Hiermee wordt aangegeven of dit veld is geïndexeerd ter ondersteuning van zoeken.
Kan wijzigen?=Nee

REST:
VROUW: IsLongText

boolean

Geeft aan dat het veld meer dan 255 tekens mag bevatten, zoals velden waaraan een gegevenstype PlainText, HTML of Geschiedenis is toegewezen.
Kan wijzigen?=Nee

REST: isPicklist² VROUW:

Booleaanse waarde

Hiermee wordt aangegeven of het veld is gekoppeld aan een selectielijst. De waarde wordt ingesteld op True wanneer een aangepast veld is gedefinieerd voor het type Azure DevOps en Picklist (Tekenreeks) of Picklist (geheel getal). De waarde is ingesteld op False voor overgenomen velden die selectielijsten definiëren.
Kan wijzigen?=Nee

REST: isPicklistSuggested² VROUW:

Booleaanse waarde

Hiermee wordt aangegeven of het veld gebruikers toestaat hun eigen waarden voor een selectielijst in te voeren. De waarde wordt ingesteld op True wanneer een aangepast veld is gedefinieerd voor Het type Azure DevOps, Picklist (Tekenreeks) of Picklist (geheel getal) en het selectievakje toestaan dat gebruikers hun eigen waarden kunnen instellen, is ingeschakeld.
Kan wijzigen?=Ja

REST: isQueryable
VROUW: IsQueryable

boolean

Hiermee wordt aangegeven of het veld wordt weergegeven in de set velden die u kunt toevoegen om een werkitemquery (Waar) te filteren of niet (onwaar). De meeste velden kunnen worden opvraagbaar.
Kan wijzigen?=Nee

REST:
VROUW: IsReportable ³

boolean

Geeft aan of het rapportbare kenmerk is gedefinieerd of is ingesteld op iets anders dan Geen. Dit kenmerk kan worden gewijzigd voor on-premises omgevingen.
Kan wijzigen?=Ja

REST:
VROUW: IsUsedInGlobalWorkflow

boolean

Geeft aan of het veld is gedefinieerd in een globale werkstroom.
Kan wijzigen?=Nee

REST:
VROUW: IsUserNameField

boolean

Geeft aan of het veld wordt gebruikt om een identiteitsveld weer te geven.
Kan wijzigen?=Nee

REST: naam
VROUW: Naam

tekenreeks

Beschrijvende naam die aan het veld is toegewezen. De beschrijvende naam kan niet worden gewijzigd voor Azure DevOps, maar kan worden gewijzigd voor on-premises met behulp van de opdracht witadmin changefield .
Kan dit wijzigen?=Alleen on-premises

REST: picklistId
VROUW: HelpText

GUID

Als het veld een selectielijst is, is de id van de bijbehorende selectielijst, anders null. Er wordt een unieke GUID-waarde toegewezen wanneer een aangepast veld is gedefinieerd voor het type Azure DevOps en picklist (tekenreeks) of picklist (geheel getal).
Kan wijzigen?=Nee

REST:
VROUW: ProhibitedValues

verzameling

Hiermee haalt u de verzameling van verboden waarden op voor een veld dat dergelijke waarden specificeert. U kunt alleen verboden waarden definiëren voor on-premises implementaties.
Kan dit wijzigen?=Alleen on-premises

REST: readOnly
VROUW:

Booleaanse waarde

Geeft aan of het veld is ingesteld op alleen-lezen. Voor Azure DevOps Services kunnen alleen aangepaste velden worden gewijzigd in alleen-lezen. Systeemvelden kunnen niet worden gewijzigd.
Kan wijzigen?=Ja

REST: referenceName
VROUW: ReferenceName

tekenreeks

Hiermee geeft u de verwijzingsnaam van een veld.
Kan wijzigen?=Nee

REST:
VROUW: ReportingAttributes³

Hiermee geeft u detail, dimensie of meting op, afhankelijk van of en hoe u het veld wilt opnemen in rapporten. Gegevens uit velden met een andere waarde dan None voor dit kenmerk worden geëxporteerd naar het datawarehouse en kunnen worden opgenomen in SQL-rapporten.
Kan dit wijzigen?=Alleen on-premises

REST:
VROUW: ReportingName³

tekenreeks

Hiermee geeft u het label voor een veld op wanneer gegevens worden weergegeven in SQL-rapporten. Als u geen waarde opgeeft, wordt de beschrijvende naam van het veld gebruikt.
Kan dit wijzigen?=Alleen on-premises

REST:
VROUW: ReportingReferenceName³

tekenreeks

Hiermee geeft u een andere verwijzingsnaam op voor een veld dat wordt gebruikt wanneer gegevens worden geëxporteerd naar het relationele datawarehouse. Als u geen waarde opgeeft, wordt de verwijzingsnaam van de velden gebruikt.
Kan dit wijzigen?=Alleen on-premises

REST: supportedOperations
VROUW:

set

De set queryoperators die geldig zijn voor gebruik bij het verwijzen naar dit veld. Zie Snelzoekgids voor query's, Operators en macro's die worden ondersteund voor elk gegevenstype voor een beknopt overzicht van ondersteunde bewerkingen op basis van het gegevenstype.
Kan wijzigen?=Nee

REST:
VROUW: SupportsTextQuery

boolean

Hiermee wordt aangegeven of het veld ondersteuning biedt voor tekstquery's zoals Contains Words, Does Not Contains Words.
Kan wijzigen?=Nee

REST:
VROUW: SystemType

tekenreeks

Hiermee geeft u het gegevenstype van het veld op, waarnaar wordt verwezen naar de systeemnaam, zoals System.DateTime of System.String.
Kan wijzigen?=Nee

REST: type
VROUW: FieldType

tekenreeks

Hiermee geeft u het gegevenstype van het veld op, zoals Booleaanse waarde, Datum/tijd, Geheel getal, Tekenreeks, enzovoort. Zie Queryvelden, operators en macro's voor een volledige lijst en beschrijvingen.
Kan wijzigen?=Nee

REST: gebruik
VROUW: Gebruik

tekenreeks

Hiermee geeft u op of het veld is bedoeld voor gebruik met werkitems (WorkItem) of werkitemkoppelingsobjecten (WorkItemLink). Het gebruik voor de meeste velden is WorkItem. Zie Velden ophalen, FieldUsage voor een volledige lijst met gebruikswaarden.
Kan wijzigen?=Nee

Notitie

1. Voor on-premises implementaties kunt u indexering voor een veld inschakelen om de reactietijden van query's te verbeteren bij het filteren op het veld. Zie Geïndexeerde velden verderop in dit artikel voor meer informatie.
2. De kenmerken isPicklist en isPicklistSuggested worden alleen toegewezen aan aangepaste velden die zijn gedefinieerd voor een overgenomen proces. Het overgenomen procesmodel wordt ondersteund voor Azure DevOps Server 2019 en nieuwere versies. Zie Overgenomen procesmodel voor meer informatie.
3. Alle rapportagekenmerken zijn alleen geldig voor on-premises implementaties waarvan projecten zijn geconfigureerd ter ondersteuning van SQL Server Reporting en SQL Server Analysis Services.

Lijstveldkenmerken

U kunt de kenmerken weergeven die aan een veld zijn toegewezen met behulp van de Velden - REST API ophalen. Vervang OrganizationName door de naam van uw werkelijke organisatie.

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

Als u bijvoorbeeld de kenmerken voor het iteratiepad wilt weergeven, gebruikt u de referentienaam System.IterationPath voor de fabrikam organisatie:

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"
> }
> ```

Velden toevoegen en wijzigen

Als u velden aan een proces wilt toevoegen, voegt u deze toe aan een of meer typen werkitems. Zie Een overnameproces aanpassen voor meer informatie.

Verwante artikelen:

• Raadpleeg de snelzoekgids query om snel inzicht te hebben in de syntaxis en het gebruik van query's.
• Verken de index van het veld Werkitem om alle beschikbare werkitemvelden weer te geven.
• Voeg velden toe en beheer deze voor een overgenomen proces om velden aan te passen op basis van uw overgenomen procesvereisten.
• Krijg toegang tot de metagegevensreferentie voor Azure Boards Analytics om inzicht te krijgen in de mogelijkheden voor analysemetagegevens en rapportage.