Werkitemvelden en -kenmerken in Azure Boards

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

Werkitemvelden worden gebruikt om informatie bij te houden. Velden worden gedefinieerd voor een organisatie en worden gedeeld in alle projecten die voor die organisatie zijn gedefinieerd. U kunt een van de twee hulpprogramma's gebruiken om de velden te controleren die zijn gedefinieerd voor de organisatie. Deze hulpprogramma's zijn beschikbaar 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

• 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 hebben ingesteld op Toestaan voor de organisatie of verzameling.

Velden weergeven of controleren

Als u velden wilt weergeven of controleren, kunt u een van de volgende hulpprogramma's gebruiken, afhankelijk van het procesmodel, overname, 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 gedefinieerd voor de werkitems die verwijzen naar dat type. Elk veld is gekoppeld aan een aantal kenmerken, waarvan veel worden ingesteld door het systeem en kunnen niet worden gewijzigd.

Elk veld wordt gedefinieerd door de volgende drie kenmerken.

• Gegevenstype: Hiermee geeft u het type gegevens op dat in het veld kan worden ingevoerd, zoals Booleaanse waarde, Double, Integer, HTML en String. Zie Queryvelden, operators en macro's voor beschrijvingen van elk gegevenstype.
• Beschrijvende naam: Hiermee geeft u de naam op die is toegewezen aan het veld en die u selecteert voor een veld in een querycomponent. Deze naam kan afwijken van de naam die wordt weergegeven in het werkitemformulier.
• Referentienaam: hiermee geeft u de naam op die u gebruikt bij het maken van een WIQL-query of een geïmproviseerde werkitemsjabloon, met behulp van REST API-opdrachten of het definiëren van definities van het type XML-werkitem. Zodra deze is gedefinieerd, kan de verwijzingsnaam niet meer worden gewijzigd.

Zie Veldkenmerken en Lijstveldkenmerken verderop in dit artikel voor een beschrijving van elk veldkenmerk en hoe u deze kunt weergeven. Zie Werk bijhouden met gebruikersverhalen, problemen, bugs, functies en epics voor een overzicht van WIT's en werkitems.

Wat is een veld? Hoe worden veldnamen gebruikt?

Elk type werkitem is gekoppeld aan 31 systeemvelden en een aantal meer typespecifieke velden. U gebruikt werkitems om uw project te plannen en bij te houden.

Elk veld ondersteunt het bijhouden van informatie over het werk dat moet worden uitgevoerd. Waarden die u aan een veld toewijst, worden opgeslagen in het gegevensarchief voor het bijhouden van werk, waarmee u query's kunt maken om de status en trends te bepalen.

Zie de veldindex werkitems voor beschrijvingen en het gebruik van elk veld dat is gedefinieerd voor de kernsysteemprocessen, Agile-, Basic-, Scrum- en CMMI-processen.

Veldnamen

Een veldnaam voor werkitems identificeert elk werkitemveld op unieke wijze. Zorg ervoor dat uw veldnamen binnen deze richtlijnen vallen:

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

Omdat aangepaste velden zijn gedefinieerd voor een organisatie of verzameling, kunt u geen aangepast veld toevoegen aan een proces met dezelfde veldnaam die u aan een ander proces toevoegt.

Zie Naamgevingsbeperkingen en conventies voor meer informatie.

Systeem- en vooraf gedefinieerde velden

Alle door het systeem gedefinieerde velden hebben referentienamen die beginnen met System, bijvoorbeeld System.AreaPath, System.AssignedTo en doorgaan in dat patroon.

Vooraf gedefinieerde velden die door het standaardproces zijn gedefinieerd, beginnen met Microsoft.VSTS en verschillen vervolgens verder op basis van hun gebruik. Voorbeelden van vooraf gedefinieerde velden die algemeen worden gebruikt voor planningsdoeleinden en integratie met Office Project, voor integratie met Team Foundation Build en integratie met testcasebeheer (TCM) zijn als volgt:

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

Zie de veldindex werkitems voor een overzicht van alle systeem- en vooraf gedefinieerde velden die zijn gedefinieerd voor de standaardprocessen/processjablonen. Zie Naamgevingsbeperkingen voor meer informatie over het opgeven van veldnamen.

Aangepaste velden

Omdat aangepaste velden zijn gedefinieerd voor een organisatie of projectverzameling, kunt u geen aangepast veld toevoegen aan een proces met dezelfde veldnaam die u aan een ander proces toevoegt.

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

• Er kunnen maximaal 64 velden worden gedefinieerd voor elke WIT
• Er kunnen maximaal 512 velden per proces worden gedefinieerd

Het gegevenstype veld bepaalt het soort en de grootte van de gegevens die u in het veld kunt opslaan. Een veld kan slechts één type hebben gedefinieerd in een projectverzameling. Deze beperking moedigt organisaties aan om algemene velden te gebruiken voor projecten en werkitemstypen.

Wanneer u een aangepast veld toevoegt aan een overgenomen proces, wijst Azure DevOps een verwijzingsnaam toe die voorafgegaan is door Aangepast en vervolgens de naam van het veld met spaties verwijderd. U voegt bijvoorbeeld een veld met de naam DevOps Triage toe. De verwijzingsnaam is Custom.DevOpsTriage. Er zijn geen spaties toegestaan binnen de verwijzingsnaam.

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.

Webpagina Procesvelden>

Als u de lijst met velden wilt bekijken die zijn gedefinieerd voor een organisatie of verzameling, opent u Procesvelden> voor organisatie-instellingen>.

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

   

2. Kies vervolgens Proces.

   

   Notitie

   Als u Proces niet ziet, werkt u vanuit TFS-2018 of eerdere versie. De pagina Proces wordt niet ondersteund. U moet de functies gebruiken die worden ondersteund voor het on-premises XML-procesmodel.

3. Kies vervolgens Velden.

   Velden die worden vermeld, komen overeen met alle velden die zijn gedefinieerd voor de organisatie of verzameling. Dit omvat alle aangepaste velden en 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.

   Voor beschrijvingen en het gebruik van elk veld, evenals de verwijzingsnaam voor elk veld, kunt u het opzoeken vanuit de veldindex Werkitem. U kunt ook de verwijzingsnaam van velden ophalen uit het veld Werkitemtypen - REST API weergeven.

WerkitemVeldverkenner

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

Als u toegang wilt krijgen tot de Veldverkenner voor werkitems, moet u het hulpprogramma Proceseditor installeren. Op basis van de versie van Visual Studio die u hebt geïnstalleerd, haalt u 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-veranderlijke en verborgen kenmerken voor elk werkitemveld. In de volgende tabel wordt elk kenmerk beschreven. Kenmerken hebben verschillende namen op basis van als u ze via de Velden - REST API ophalenof weergeven via het hulpprogramma Field Explorer (WIFE) voor werkitems.

Kenmerken die aan een veld zijn toegewezen, zijn afhankelijk van het platform en de versie die u gebruikt. Sommige kenmerken worden bijvoorbeeld niet ondersteund met 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:

boolean

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:

boolean

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 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 wijzigen?=Alleen on-premises

REST: readOnly
VROUW:

boolean

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 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. Voer de naam van uw organisatie in voor OrganizationName.

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

Hier geven we bijvoorbeeld de kenmerken voor het iteratiepad op, waarbij de verwijzingsnaam System.IterationPathwordt opgegeven, voor de fabrikam-organisatie.

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

Geretourneerde gegevens:

{
"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:

• Snelle naslaginformatie voor query's
• Veldindex werkitem
• Velden toevoegen en beheren voor een overgenomen proces
• Naslaginformatie over metagegevens voor Azure Boards Analytics