Een werkitemquery definiëren

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

Visual Studio 2019 | Visual Studio 2022

Werkitemqueries in Azure Boards genereren lijsten van werkitems op basis van de door u opgegeven filtercriteria. U kunt deze beheerde query's opslaan en delen met anderen.

U kunt query's maken vanuit de webportal of vanuit een ondersteunde client, zoals Visual Studio Team Explorer. Als u bulkupdates of toevoegingen wilt ondersteunen, importeert of exporteert u query's met Excel of .csv-bestanden.

Notitie

In de volgende afbeeldingen wordt de gebruikersinterface weergegeven met de functie New Boards Hub standaard ingeschakeld. Zie Functies beheren of inschakelenvoor meer informatie.

Bekijk onze aanbevolen aanbevolen procedures verderop in dit artikel.

Vereisten

Categorie	Eisen
Toegangsniveaus	- Gedeelde query's weergeven en uitvoeren: Project-lid. - Een gedeelde query toevoegen en opslaan: minimaal Basic toegang.
Machtigingen	Bijdrage machtiging ingesteld op Toestaan voor de map waaraan u een query wilt toevoegen. De groep Inzenders beschikt standaard niet over deze machtiging.

Notitie

Gebruikers met toegang tot belanghebbenden voor een openbaar project hebben volledige toegang tot queryfuncties, net zoals gebruikers met Basistoegang . Voor meer informatie, zie Snelle referentie voor toegang als belanghebbende.

Een queryfilter kiezen

Selecteer in de Power Query-editor het filter om naar een artikel te gaan met voorbeeldquery's. Samen met de queryfilters kunt u interactief filters toepassen op queryresultaten.

Notitie

Beheerde query's bieden geen ondersteuning voor nabijheidszoekopdrachten, maar semantische zoekopdrachten wel. Semantische zoekopdrachten ondersteunen ook zowel * als ? jokertekens en u kunt meer dan één jokerteken gebruiken om meer dan één teken te vinden. Zie Functioneel werkitem zoeken voor meer informatie.

---

Filterfuncties

Macro's

---

• Velden vergelijken
• Sleutelwoorden
• Gekoppelde werkitems
• Logische groeperingen
• Query-macro's
• tags
• Was ooit
• Was ooit (bordkolom)
• Jokerteken

• Lege of lege velden
• Booleaanse zoekopdrachten
• Identiteitszoekopdrachten
• Geschiedenis en discussie
• Bestuursvelden
• Zoekopdrachten in en niet in groepen
• Zoeken in projecten

• [Willekeurig]
• @Me
• @Today
• @CurrentIteration, @CurrentIteration +/-n
• @Follows
• @MyRecentActivity, @RecentMentions, @RecentProjectActivity
• @StartOfDay, @StartOfMonth, @StartOfWeek, @StartOfYear
• @TeamAreas

---

U kunt een query interactief filteren met behulp van de functie Filter.

Open queries

Browser

Kies > in uw project en kies vervolgens Alles.

De pagina Query's wordt geopend op het tabblad Favorieten met de query's die u als favorieten hebt ingesteld. U kunt het tabblad Alles kiezen om alle query's weer te geven die u hebt gedefinieerd en gedeelde query's voor het project.

Aanbeveling

Query's die u of uw team hebben gekozen als favorieten worden weergegeven op de pagina Favorieten . Favoriete query's samen met andere objecten worden ook weergegeven op de projectpagina . Zie Persoonlijke favorieten of teamfavorieten instellen voor meer informatie.

Visual Studio

Belangrijk

We raden u ten zeerste aan dat iedereen de standaardweergave gebruikt in plaats van deze verouderde weergave. Het is ontworpen voor u om snel toegang te krijgen tot een lijst met werkitems op basis van uw opdracht, gevolgd, vermeld of recente updates. De verouderde weergave wordt niet meer uitgebreid en we verwachten dat deze in een toekomstige versie van Visual Studio wordt verwijderd.

1. Kies Werkitems op de startpagina van Team Explorer.

   

2. Als u een query wilt openen, opent u het snelmenu voor de query (klik met de rechtermuisknop op de query) en kiest u Resultaten weergeven. U kunt ook dubbelklikken op de query om deze te openen.

   

Of selecteer een van de volgende opties:

• Query bewerken: Opent de Query-editor voor de geselecteerde query.
• Nieuwe query: opent de Query-editor met de standaardopties voor nieuwe query's.
• Openen in Microsoft Excel (plat): hiermee opent u de query in Microsoft Excel.
• Verzenden naar Microsoft Outlook: Openen
• Knippen: Snijdt de query. Vervolgens kunt u de query onder een andere map plakken.
• Kopiëren: Kopieert de query. Vervolgens kunt u de query onder dezelfde map of een andere map plakken.
• Verwijderen: Hiermee verwijdert u de query.
• Naam wijzigen: hiermee kunt u de naam van de query wijzigen.
• Toevoegen aan Mijn favorieten: voegt de query toe aan de sectie Mijn favorieten.
• Toevoegen aan Team favorieten: voegt de query toe aan de sectie Team favorieten.
• Beveiliging: Hiermee opent u het dialoogvenster Machtigingen voor de query.

Een platte lijstquery definiëren

Start een nieuwe query vanaf het tabblad Query's in de webportal of het tabblad Werkitems in Teamverkenner.

Browser

1. Selecteer Nieuwe>nieuwe query.

De Power Query-editor wordt weergegeven met de volgende standaardinstellingen: Platte lijst met werkitems, Type werkitem=[Any], en State=[Any].

2. Wijzig de waarden en voeg componenten toe of verwijder deze, of wijzig het type query in Werkitems en directe koppelingen of een boomstructuur met werkitems.

Visual Studio

Belangrijk

We raden u ten zeerste aan de standaardweergave te gebruiken in plaats van deze verouderde weergave. Deze weergave is ontworpen om snel toegang te krijgen tot een lijst met werkitems op basis van uw opdracht, gevolgd, vermeld of recente updates. De verouderde weergave wordt niet meer uitgebreid en we verwachten dat deze in een toekomstige versie van Visual Studio wordt verwijderd.

1. Selecteer Nieuwe query van de pagina Werkitems.

   

   De Power Query-editor wordt weergegeven met de volgende standaardinstellingen: Platte lijst (standaard), Teamproject=huidig project, Type werkitem=[Any], en State=[Any].

   

2. Wijzig de waarden en voeg componenten toe of verwijder deze. Of wijzig het type query in Werkitems en directe koppelingen of een boomstructuur met werkitems.

Zoeken uitvoeren binnen projecten of tussen projecten

Nieuwe query's hebben standaard betrekking op het huidige project. U kunt echter query's maken om werkitems te vinden die zijn gedefinieerd in de organisatie of projectverzameling. Alle query's die u opslaat, worden echter opgeslagen onder een specifiek project.

Browser

Als u werkitems wilt weergeven die zijn gedefinieerd in twee of meer projecten, schakelt u het vinkje Query in meerdere projecten in. Met de volgende query worden bijvoorbeeld alle functies gevonden die in alle projecten in de afgelopen 30 dagen zijn gemaakt.

Notitie

• Scheid meerdere projectnamen met behulp van het lijstscheidingsteken dat is gedefinieerd door de landinstellingen van uw clientcomputer, zoals een komma ,.
• Wanneer u het veld Status in een query in meerdere projecten gebruikt, zijn de weergegeven waarden beperkt tot items die zijn gedefinieerd in het standaardproject. Als u query's uitvoert op projecten, ziet u mogelijk niet alle mogelijke statuswaarden van elk project, maar alleen waarden uit het standaardproject. Als u bijvoorbeeld drie projecten hebt( Project A, Project B en Project C), en alleen Project A een status heeft met de naam 'In beoordeling', terwijl projecten B en C verschillende statussen hebben, worden in de query alleen de statussen weergegeven die zijn gedefinieerd in Project A.

Wanneer u query's voor meerdere projecten maakt, is de beschikbaarheid van velden in de vervolgkeuzelijst Veld afhankelijk van of de optie Query in projecten is ingeschakeld. Houd rekening met het volgende belangrijke gedrag:

• Het veld Teamproject wordt pas beschikbaar nadat u Query in projecten hebt gecontroleerd.
• Wanneer Query over projecten heen is ingeschakeld, worden alle velden uit alle werkitemtypen die in alle projecten binnen de verzameling zijn gedefinieerd, weergegeven in het Veld vervolgkeuzemenu.
• Wanneer Query over projecten is uitgeschakeld, worden alleen velden uit typen werkitems die in het huidige project gedefinieerd zijn weergegeven in de dropdownlijst Veld.

Als de query voor alle projecten is ingeschakeld, kunt u het veld Teamproject toevoegen om te filteren op een selectie van projecten.

Visual Studio

Belangrijk

We raden u ten zeerste aan dat iedereen de standaardweergave gebruikt in plaats van deze verouderde weergave, die is ontworpen om snel toegang te krijgen tot een lijst met werkitems op basis van uw toewijzing, volgen, vermelden of recente updates. De verouderde weergave wordt niet meer uitgebreid en we verwachten dat deze in een toekomstige versie van Visual Studio wordt verwijderd.

Als u werkitems wilt weergeven die zijn gedefinieerd in twee of meer projecten, wijzigt u de component voor het teamproject met behulp van de operator In en voert u de namen in van de projecten waarin u wilt zoeken. Met de volgende query worden bijvoorbeeld werkitems gevonden die zijn gedefinieerd in de projecten Fabrikam Fiber en Design Agile .

Als u query's wilt uitvoeren op alle projecten, verwijdert u de clausule met het veld Team Project.

Een clausule definiëren

Als u een query wilt maken, definieert u een of meer componenten. Elke component definieert een filtercriteria voor één veld.

Voorbeeldqueryclausule

En/of	Veld	Operateur	Waarde
en	Toegewezen aan	=	@Me

Voor een lijst met beschikbare operators op basis van het veldgegevenstype, zie Snelle referentie voor query-indexen.

Alle clausules worden toegevoegd als een And-instructie. Selecteer Of als u de groepering wilt wijzigen. Groep clausules om ervoor te zorgen dat de clausule-uitspraken in de vereiste volgorde worden uitgevoerd.

Browser

Selecteer Nieuwe component toevoegen om een andere component toe te voegen aan het einde van de query en selecteer vervolgens het veld, de operator en de waarde voor die component.

Zoek bijvoorbeeld naar alle werkitems die aan u zijn toegewezen door het veld Toegewezen aan op te geven, de operator is gelijk aan (=) en de @Me macro, die uw gebruikersidentiteit vertegenwoordigt.

Visual Studio

Belangrijk

We raden u ten zeerste aan dat iedereen de standaardweergave gebruikt in plaats van deze verouderde weergave, die is ontworpen om snel toegang te krijgen tot een lijst met werkitems op basis van uw toewijzing, volgen, vermelden of recente updates. De verouderde weergave wordt niet meer uitgebreid en we verwachten dat deze in een toekomstige versie van Visual Studio wordt verwijderd.

Klik hier om een component toe te voegen om een andere component toe te voegen aan het einde van de query en selecteer vervolgens het veld, de operator en de waarde voor die component.

Als u een component in de bestaande set queryclausules wilt invoegen, plaatst u de cursor op de volgende component waar u de component wilt invoegen en kiest u Vervolgens Component invoegen. Selecteer vervolgens het veld, de operator en de waarde voor die component.

Of open het contextmenu voor de component en kies Insert Clauses.

Als u een component wilt verwijderen, kiest u de component die u wilt verwijderen en kiest u Component verwijderen.

Wanneer u klaar bent, kiest u Uitvoeren of Query opslaan.

Aanbeveling

Als u de WIQL-syntaxis voor een query wilt weergeven en hoe haakjes worden gebruikt om componenten te groeperen, installeert u de Marketplace Wiql-editor. Deze extensie ondersteunt het weergeven van de WIQL-syntaxis en het exporteren naar een WIQL-bestand voor gebruik in REST API-aanroepen. Zie Syntaxis voor de WiQL (Work Item Query Language) voor meer informatie.

Controlelijst voor het definiëren van een queryclausule

1. Kies in de eerste lege rij onder de kolomkop Veld de pijl-omlaag om de lijst met beschikbare velden weer te geven en kies een item in de lijst. Zie Queryvelden en -waarden voor meer informatie.

2. Selecteer in dezelfde rij onder de kolomkop Operator de pijl-omlaag om de lijst met beschikbare operators weer te geven en kies vervolgens een item in de lijst. Zie Operators voor meer informatie.

3. Voer in dezelfde rij onder de kolomkop Waarde een waarde in of selecteer de pijl-omlaag en kies vervolgens een item in de lijst. Zie Variabelen voor meer informatie over het gebruik van een macro of variabele om het huidige project, de gebruiker, de datum of andere selectie op te geven.

4. Als u een component wilt toevoegen, kiest u Nieuwe component toevoegen.

   U kunt een component toevoegen aan het einde van de query of de volgende taken uitvoeren met de bijbehorende pictogrammen:

   • Nieuwe filterregel invoegen
   • Deze filterregel verwijderen
   • Geselecteerde componenten groeperen
   • Clausules ontgroeperen

Een werkitemstructuur gebruiken om hiërarchieën weer te geven

Gebruik de Boomstructuur van werkitems query om een geneste lijst van werkitems met meerdere lagen weer te geven. U kunt bijvoorbeeld alle achterstandsitems en de gekoppelde taken bekijken. Als u zich wilt richten op verschillende delen van de structuur, kiest u Alles uitvouwen of Alles samenvouwen.

Notitie

U kunt geen query maken waarin een hiërarchische weergave van testplannen, testsuites en testcases wordt weergegeven. Deze items worden niet aan elkaar gekoppeld met ouder-kind koppelingstypen. U kunt echter een query voor directe koppelingen maken waarin testgerelateerde werkitems worden weergegeven. U kunt ook de hiërarchie bekijken via de pagina Testplannen.

Browser

Definieer de filtercriteria voor zowel hoofdwerkitems als subwerkitems. Als u gekoppelde onderliggende items wilt zoeken, selecteer Eerst werkitems op het hoogste niveau vergelijken. Als u gekoppelde ouders wilt zoeken, selecteert u Eerst gekoppelde werkitems vergelijken.

Visual Studio

Belangrijk

We raden u ten zeerste aan dat iedereen de standaardweergave gebruikt in plaats van deze verouderde weergave, die is ontworpen om snel toegang te krijgen tot een lijst met werkitems op basis van uw toewijzing, volgen, vermelden of recente updates. De verouderde weergave wordt niet meer uitgebreid en we verwachten dat deze in een toekomstige versie van Visual Studio wordt verwijderd.

Definieer de filtercriteria voor zowel hoofdwerkitems als subwerkitems. Als u gekoppelde onderliggende items wilt zoeken, selecteer Eerst werkitems op het hoogste niveau vergelijken. Als u gekoppelde ouders wilt zoeken, selecteert u Eerst gekoppelde werkitems vergelijken.

Directe koppelingen gebruiken om afhankelijkheden weer te geven

Gebruik de query Werkitems en Directe koppelingen om werkitems bij te houden die afhankelijk zijn van ander bijgehouden werk, zoals taken, bugs, problemen of functies. U kunt bijvoorbeeld achterstandsitems bekijken die afhankelijk zijn van andere items die worden geïmplementeerd of een bug die wordt opgelost.

Gebruik de query voor directe koppelingen om afhankelijkheden in teams bij te houden. De query helpt u ook bij het beheren van toezeggingen die uw team doet. Kies de filtercriteria voor de bovenste en gekoppelde werkitems. En selecteer de typen koppelingen om de afhankelijkheden te filteren.

Browser

Filter uw lijst met werkitems op de eerste laag door een van deze opties te kiezen:

• Alleen items retourneren die bijpassende koppelingen hebben: Werkitems in de eerste laag worden geretourneerd, maar alleen als ze koppelingen hebben naar werkitems die worden opgegeven door de filtercriteria voor gekoppelde werkitems.
• Alle items op het hoogste niveau retourneren: alle werkitems in de eerste laag retourneren ondanks de filtercriteria voor gekoppelde werkitems. Werkitems in de tweede laag die aan de eerste laag zijn gekoppeld, retourneren als ze voldoen aan de filtercriteria voor gekoppelde werkitems.
• Alleen items retourneren die geen overeenkomende koppelingen hebben: werkitems in de eerste laag worden geretourneerd, maar alleen als ze geen koppelingen hebben naar werkitems die zijn opgegeven door de filtercriteria voor gekoppelde werkitems.

Visual Studio

Belangrijk

We raden u ten zeerste aan dat iedereen de standaardweergave gebruikt in plaats van deze verouderde weergave, die is ontworpen om snel toegang te krijgen tot een lijst met werkitems op basis van uw toewijzing, volgen, vermelden of recente updates. De verouderde weergave wordt niet meer uitgebreid en we verwachten dat deze in een toekomstige versie van Visual Studio wordt verwijderd.

Filter uw lijst met werkitems op de eerste laag door een van deze opties te kiezen:

• Alle werkitems op het hoogste niveau retourneren: alle werkitems in de eerste laag retourneren ondanks de filtercriteria voor gekoppelde werkitems. Werkitems in de tweede laag die aan de eerste laag zijn gekoppeld, retourneren als ze voldoen aan de filtercriteria voor gekoppelde werkitems.

• Alleen items retourneren waarvoor de opgegeven koppelingen zijn opgegeven: werkitems in de eerste laag retourneren, maar alleen als ze koppelingen hebben naar werkitems die zijn opgegeven door de filtercriteria voor gekoppelde werkitems.

• Alleen items retourneren waarvoor de opgegeven koppelingen niet zijn opgegeven: Werkitems in de eerste laag retourneren, maar alleen als ze geen koppelingen hebben naar werkitems die zijn opgegeven door de filtercriteria voor gekoppelde werkitems.

Zie Koppelingstypereferentie voor meer informatie over elk koppelingstype.

Gebruik en/of logische expressie

Geef And of Or op om logische expressies van uw queryklausules te maken. Gebruik And deze functie om werkitems te vinden die voldoen aan de criteria in zowel de huidige component als de vorige component. Gebruik Or om werkitems te vinden die voldoen aan het criterium in de huidige voorwaarde of de vorige voorwaarde.

Voeg één nieuwe clausule toe voor elk werkitemveld om uw zoekcriteria te verfijnen. Voeg clausules toe om alleen de set werkitems te verkrijgen die je wilt. Als u de verwachte resultaten van uw query niet ontvangt, verfijnt u deze. U kunt queryclausules toevoegen, verwijderen, groeperen of de groepering ervan opheffen om de queryresultaten te verbeteren.

Groepeer queryclausules zodat ze functioneren als één eenheid, los van de rest van de query. Groeperingsclausules zijn vergelijkbaar met het plaatsen van haakjes rond een expressie in een wiskundige vergelijking of logica-instructie. Wanneer u componenten groepeert, is de And of Or voor de eerste component in de groep van toepassing op de hele groep.

Groepsclausules

Gegroepeerde componenten werken als één eenheid, gescheiden van de rest van de query. Groeperingsclausules zijn vergelijkbaar met het plaatsen van haakjes rond een wiskundige vergelijking of logische expressie. De And of Or operator voor de eerste component in de groep is van toepassing op de hele groep.

Zoals in de volgende voorbeelden wordt weergegeven, worden de gegroepeerde componenten vertaald naar de bijbehorende logische expressie.

Zoekopdracht	Gegroepeerde bepalingen	Logische expressie
1
2
3

Deze queries retourneren werkitems die van het type Bug zijn en voldoen aan de volgende logische expressies:

• Query 1: AND State=Active OR Assigned to @Me
• Query 2: AND (State=Active OR Assigned to @Me)
• Query 3: OR (State=Active AND Assigned to @Me)

Als u een of meer componenten wilt groeperen, selecteert u deze en selecteert u vervolgens het pictogram groepsclausules.

U kunt ook verschillende gegroepeerde clausules groeperen. Vink de vakjes van elke clausule aan. Kies vervolgens het pictogram groepsclausule .

Als uw queryresultaten geen verwachte resultaten retourneren, voert u de volgende stappen uit:

• Zorg ervoor dat elke clausule is gedefinieerd zoals u bedoelt.
• Controleer And/Or de toewijzingen aan elke clausule. Als uw resultaten meer werkitems bevatten dan verwacht, is er vaak een Or component aanwezig in plaats van een And component.
• Bepaal of u de groepering van de queryclausules en de And/Or toewijzingen van elke gegroepeerde component wilt groeperen of wijzigen.
• Voeg meer queryclausules toe om uw queryfiltercriteria te verfijnen.
• Bekijk de beschikbare opties voor het opgeven van velden, operators en waarden.
• Zie de aanbevolen procedures verderop in dit artikel.

De groepering van een clausule opheffen

Als u de groepering van een component wilt opheffen, selecteert u het pictogram niet-gegroepeerde componenten voor de gegroepeerde component.

Standaardkolombreedte instellen in queryresultaten

Voer de volgende stappen uit om de standaardkolombreedte in queryresultaten in te stellen:

1. Open de query die u wilt wijzigen.
2. Pas handmatig de kolombreedtes aan naar de gewenste grootte door de rand van de kolomkoppen te slepen.
3. Selecteer Opslaan of Opslaan als als u deze wilt opslaan als een nieuwe query.
4. Sluit de query en open deze opnieuw om ervoor te zorgen dat de kolombreedten behouden blijven.

Azure DevOps biedt momenteel geen ondersteuning voor het instellen van een standaardkolombreedte die in alle sessies wordt bewaard. De kolombreedten worden per query opgeslagen, dus u moet deze afzonderlijk aanpassen en opslaan voor elke query.

Queryresultaten weergeven in een dashboard

In de volgende twee widgets worden queryresultaten weergegeven. U kunt werkitems rechtstreeks vanuit deze widgets openen.

• Werk dat aan mij is toegewezen: geeft een lijst weer van alle voorgestelde of actieve werkitems die zijn toegewezen aan de aangemelde gebruiker. Hiermee worden de velden Id, Staat en Titel weergegeven.
• Widget queryresultaten: geeft de resultaten weer van een platte, structuur- of directkoppelingsquery. U kunt de velden configureren die worden weergegeven via de widget, het formaat van de kolomvelden wijzigen en de boomstructuur en directe-koppelingenquery uitvouwen en samenvouwen.

Zie Widgets toevoegen aan een dashboard voor meer informatie.

Widget voor het weergeven van queryresultaten met oudertitels

Voer de volgende stappen uit om de resultaten van een query weer te geven wanneer de ouder titel wordt weergegeven:

1. Maak een query waarmee de gewenste werkitems worden gefilterd. De query kan een platte lijst, boomstructuur, of directe link query zijn.
2. Voeg het Ouder-veld toe als kolom. Hoewel het Ouder veld kan worden opgenomen, laat het standaardgedrag misschien alleen de ID van het ouderwerkitem zien. Om ervoor te zorgen dat de naam naast de ID wordt weergegeven, combineert u de velden Werkitemtype en Bovenliggende met het veld Titel in de querystructuur.
3. Sla de query op als een gedeelde query of teamfavoriet.
4. Voeg de Queryresultaten-widget toe aan uw dashboard en configureer de query. Zorg ervoor dat het bovenliggende veld is ingesteld om weer te geven.

In de volgende afbeelding wordt een queryresultatenwidget getoond die het Parent veld weergeeft.

Een query definiëren als hyperlink

Een queryhyperlink maakt gebruik van wiql (Work Item Query Language), die lijkt op Transact-SQL. Zie Syntaxis voor de WiQL (Work Item Query Language) voor meer informatie.

Notitie

In de meeste browsers wordt een limiet van 2000 tot 2083 tekens afgedwongen voor een URL-tekenreeks.

Syntaxis van queryhyperlink

Codeer het WIQL-gedeelte van de URL-syntaxis. U kunt elk hulpprogramma voor URL-coderingsprogramma's gebruiken om uw URL te coderen.

https://dev.azure.com/OrganizationName/ProjectName/_workitems?_a=query&wiql={Encoded WorkItemQueryLanguage}

De volgende hyperlink bevat bijvoorbeeld de id en titel van alle actieve bugs die zijn gedefinieerd onder het pad fabrikamFiber/webgebied voor de Fabrikam-organisatie.

https://dev.azure.com/fabrikam/FabrikamFiber/_workitems?_a=query&wiql=SELECT%20%5BSystem.ID%5D%2C%20%5BSystem.Title%5D%20FROM%20WorkItems%20WHERE%20%5BSystem.TeamProject%5D%3D'FabrikamFiber'%20AND%20%5BSystem.WorkItemType%5D%3D'Bug'%20AND%20%5BSystem.State%5D%3D'Active'%20AND%20%5BSystem.AreaPath%5D%3D'FabrikamFiber%5CWeb'

De gedecodeerde WIQL voldoet aan:

SELECT [System.ID], [System.Title]
   FROM WorkItems 
   WHERE [System.TeamProject]='FabrikamFiber' 
   AND [System.WorkItemType]='Bug'
   AND [System.State]='Active'
   AND [System.AreaPath]='FabrikamFiber\Web'

Notitie

De WIQL-lengte mag niet langer zijn dan 32 K tekens voor Azure Boards-query's.

Beste praktijken

De volgende aanbevolen procedures zijn van toepassing op de volgende query's die u kunt maken:

• Webportalzoekopdrachten
• Work Item Query Language (WIQL)-query's
• az boards query command line
• REST API-queries

Gerichte, selectieve query's maken

Definieer een zeer selectieve query door alle filters toe te passen die nodig zijn voor uw query. Hoe selectiever de query is, hoe kleiner de set resultaten. Hoe kleiner de resultatenset is, hoe gerichter en selectief uw query is.

Tags gebruiken om werkitems te categoriseren

Gebruik werkitemtags om uw werkitems te categoriseren in plaats van een aangepast veld. Query's die op tags filteren, worden meestal sneller uitgevoerd dan die query's die filteren op tekenreeksovereenkomsten.

In tegenstelling tot aangepaste veldovereenkomsten of gedeeltelijke overeenkomsten vereist een query met een Tags Contains-bewerking geen volledige scan van alle werkitemtabellen.

Gebruik Contains words voor tekenreeksvergelijkingen

Als u wilt filteren op een tekenreeksovereenkomst, gebruikt u de Contains Words in plaats van de Contains operator. De Contains Words operator voert een zoekopdracht in volledige tekst uit op het opgegeven veld, wat meestal sneller wordt voltooid.

De Contains operator voert een tabelscan uit. Dit is een tragere bewerking dan de Contains Words operator. Het verbruikt ook meer CPU-cycli. Deze CPU-cycli kunnen ertoe leiden dat u frequentiebeperkingen ondervindt. Zie Frequentie- en gebruikslimieten voor meer informatie.

Kleine groepen opgeven met de In Group operator

De In Group operator filtert werkitems op basis van overeenkomsten binnen een groep waarden. De groep waarden komt overeen met de waarden in een team, beveiligingsgroep of werktraceringscategorie. U kunt bijvoorbeeld een query maken om alle werkitems te vinden die zijn toegewezen aan elk lid van een team. Of zoek alle werkitems die deel uitmaken van de categorie Vereisten (Microsoft.RequirementCategory).

Wanneer u filtert op een groep met een groot aantal leden, is uw resultatenset meestal groter en niet-selectief. Als een groep overeenkomt met een grote Microsoft Entra-groep, genereert de query ook een redelijk grote kosten om die groep op te lossen op basis van Microsoft Entra-id.

Vermijd het gebruik van ontkende operators

Negated operators, zoals <>, Not In, Not Under, Not In Group, genereren meestal niet-selectieve query's en grote resultatensets.

Gebruik alleen negated operators indien nodig. Probeer altijd eerst alternatieven te vinden. Als Veld1 bijvoorbeeld de waarden A, B, C, D heeft, specificeer dan de Field1 In A, B, C clausule in plaats van de ontkende Field1 <> D clausule.

Vermijd vergelijkingen van tekenreeksen

Query's die tekenreeksvergelijkingen bevatten, genereren tabelscans die inherent inefficiënt zijn. In plaats daarvan raden we u aan tags of een specifiek aangepast veld als alternatieven te gebruiken, met name wanneer een query slecht presteert.

Operatoren beperken Or

Beperk het aantal Or operators dat in uw query is gedefinieerd. Query's worden beter uitgevoerd wanneer er minder Or operators worden gebruikt. Te veel Or operators kunnen uw query niet-selectief maken. Als uw query traag is, wijzigt u de volgorde van de Or operatorclausule naar boven in de queryclausules.

Uw query opslaan

Vanwege interne optimalisaties worden opgeslagen query's meestal beter uitgevoerd dan niet-opgeslagen query's. Sla uw query altijd op wanneer u deze opnieuw wilt gebruiken. Zelfs voor WIQL-query's die worden uitgevoerd via een REST API, slaat u de WIQL op via de webportal om uw REST API-aanroepen uit te voeren, zodat ze minder gevoelig zijn voor toekomstige prestatieregressies.

Voer uw query uit

Soms moet u uw query een paar keer uitvoeren om het juiste optimalisatieplan te bereiken. Zorg ervoor dat u uw query opslaat en deze maximaal tien keer uitvoert gedurende een periode van 30 minuten. Op deze manier kan het systeem het optimalisatieplan onderzoeken en opzoeken dat het meest geschikt is voor uw query.

Verwante artikelen:

• Snelle naslaggids voor queries.
• Veelgestelde vragen query
• Een platte lijstquery in kaart brengen
• Kolomopties wijzigen
• Werkitem veldindex
• Sneltoetsen