Uw werk bijhouden met behulp van beheerde query's in Azure Boards
Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019
Fouten, gebruikersverhalen of andere werkitems weergeven op basis van veldcriteria die u opgeeft met behulp van query's. U kunt deze lijsten vervolgens bekijken met uw team, werk triagewerk of werkitems bulksgewijs bijwerken. Samen met beheerde query's biedt het semantische zoekprogramma een aantal overlappende en verschillende functionaliteit die de moeite waard is om te verkennen.
Gebruik beheerde query's ter ondersteuning van deze bewerkingen:
- Bulkupdate van werkitems met behulp van de webportal
- Werkitems classificeren en bijwerken
- Een hiërarchie van werkitems controleren
- Een lijst met werkitems delen met een teamlid
U kunt query's en querymappen maken vanuit de webportal of vanuit Visual Studio Team Explorer. Wijzigingen die u in de ene client aanbrengt, worden doorgevoerd in andere clients, omdat alle wijzigingen worden opgeslagen in het gegevensarchief voor het bijhouden van werk.
Aan de slag met query's
Als u net aan de slag bent, leest u Weergave, uitvoering of e-mailt u een werkitemquery. Zie snelzoekgids voor queryeditortaken en voorbeeldquery's voor een beknopt overzicht van queryeditortaken.
- Als u werkitems wilt zoeken die aan u zijn toegewezen, voegt u de @Me macro's toe als de waarde voor het veld Toegewezen aan in een van de querycomponenten.
- Alle geldige gebruikers met standaardtoegang kunnen query's en mappen maken onder het gebied Mijn query's . Als u query's en querymappen wilt maken onder Gedeelde query's, moet u beschikken over de machtigingenset Bijdragen. Zie Machtigingen instellen voor query's voor meer informatie.
- U kunt elke query wijzigen door criteria toe te voegen om te focussen op een productgebied, een iteratie of een ander veld. Als u een query wilt wijzigen, opent u de queryeditor.
- U kunt elke query openen in Excel. U kunt ook de velden van een of meer werkitems bijwerken en uw wijzigingen publiceren in de database voor het bijhouden van werkitems.
- U kunt de status of voortgang visualiseren door een cirkeldiagram, kolomdiagram of trenddiagram te maken voor query's met platte lijsten.
Querymogelijkheden
De volgende secties bieden een overzicht van de functies die worden ondersteund voor het definiëren en beheren van werkitemquery's.
- Queryfilters worden gedefinieerd via de Power Query-editor.
- Querymacro's kunnen worden geselecteerd voor specifieke velden om een querycomponent te maken.
- Queryresultaten en querybeheerfuncties zijn mogelijkheden die beschikbaar zijn via de pagina Queryresultaten.
Queryfilters
De volgende tabel bevat een overzicht van de queryfilterfuncties die worden ondersteund door elke Azure DevOps-versie.
Notitie
Beheerde query's bieden geen ondersteuning voor nabijheidszoekopdrachten, maar semantische zoekopdrachten wel. Daarnaast ondersteunen semantische zoekopdrachten zowel * als ? als jokertekens en kunt u meer dan één jokerteken gebruiken om meer dan één teken te vinden. Zie Zoeken naar functionele werkitems voor meer informatie.
Filterfunctie
Ondersteuning voor query's
Ondersteunde versies
Zoekopdrachten in tekstreeksen (één tekst, tekst met meerdere regels, tekst met opmaak)
Zoekopdrachten zijn niet hoofdlettergevoelig.
Alle versies
Jokerteken = *
Alle versies
Werkitems zoeken op basis van directe koppelingen of topologische/hiërarchische koppelingstypen.
Gekoppelde werkitems filteren op MODE basis van (WIQL-syntaxis)
Alle versies
Groeps- en nestcomponenten met behulp van EN- en OR-booleaanse operatoren.
Alle versies
Werkitems zoeken op basis van een veldovereenkomst met een vorige waarde.
Ondersteunde operator: Was Ever Werkitems zoeken op basis van een waarde die is gedefinieerd op een specifieke datum.
Ondersteunde operator: ASOF (WIQL-syntaxis)
Alle versies
Gebruik macro's om query's te maken ten opzichte van een datum, andere hulpprogramma's, zoals het pad naar het teamgebied, de teamiteratie en meer.
Alle versies
Werkitems zoeken in een of meer projecten in een organisatie of verzameling. De standaardwaarde is het huidige project. Gebruik het veld Teamproject om een query uit te voeren op twee of meer projecten.
Alle versies
Werkitems zoeken op basis van de vergelijking tussen twee velden en elkaar.
Ondersteunde operators: =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field]
Alle versies
Werkitems zoeken op basis van of ze een tag bevatten of niet bevatten.
Ondersteunde operators: Contains, Does Not Contain
Alle versies
Werkitems zoeken op basis van lege of niet lege HTML-/rtf-velden.
Ondersteunde operators: Is Empty, Is Not Empty
Azure DevOps 2019 tot en met Azure DevOps Server 2022, Azure DevOps Services
Werk zoeken waarvan de veldwaarde overeenkomt met een waarde in een gescheiden set, zoals een set werkitemtypen, werkstroomstatussen of waarden in de selectielijst. Scheid waarden met het lijstscheidingsteken dat overeenkomt met de landinstellingen die zijn gedefinieerd voor uw clientcomputer. U kunt bijvoorbeeld een komma(,) gebruiken.
Alle versies
Werkitems zoeken op basis van booleaanse veldwaarde.
Alle versies
Werkitems zoeken op basis van sleutelwoorden of woordgroepen die via de discussie zijn toegevoegd.
Alle versies
Werkitems zoeken op basis van hun kolom, zwembaan of Status Uitvoeren/Gereed.
Azure DevOps 2019 tot en met Azure DevOps Server 2022, Azure DevOps Services
Queryresultaten filteren op basis van een sleutelwoord of velden selecteren.
Azure DevOps 2019 tot en met Azure DevOps Server 2022, Azure DevOps Services
Als u queryclausules bulksgewijs wilt verplaatsen, kopiëren of plakken, installeert en gebruikt u de WIQL-editor.
Ondersteunde macro's
De volgende tabel bevat een overzicht van de querymacro's of variabelen die worden ondersteund door de Azure DevOps-versies. U kunt enkele van deze macro's gebruiken om meldingen te filteren.
Notitie
U kunt alleen bepaalde macro's vanuit de webportal gebruiken. Dit zijn de macro's @CurrentIteration, @CurrentIteration +/- n, @Follows, @MyRecentActivity, @RecentMentions, @RecentProjectActivity en @TeamAreas . Deze macro's worden niet ondersteund bij het exporteren van een query naar Excel, meldingsfilters of oefening vanuit Team Explorer of REST API's.
Zie Queryvelden, operators en macro's voor gedetailleerde beschrijvingen en koppelingen naar voorbeelden.
Macro
Ondersteuning voor query's
Ondersteunde versies
Zoek een werkitemtype, Work Item Type=[Any]of een willekeurige status. State=[Any]
Alle versies
Werk zoeken waar Identity field=logged in user.
Alle versies
Werk zoeken waar Date-Time field=today.
Alle versies
Werk zoeken dat is gedefinieerd in een of meer projecten.
Alle versies
Werk zoeken dat is gedefinieerd in de huidige iteratie voor een team.
Alle versies
Werk zoeken dat is gedefinieerd in +/- n van de huidige iteratie voor een team.
Azure DevOps 2019 tot en met Azure DevOps Server 2022, Azure DevOps Services
Zoeken naar werk dat momenteel is aangemeld door de gebruiker die is aangemeld, ID In @Followsvolgt.
Alle versies
Werkitems zoeken die onlangs zijn gewijzigd, ID In @MyRecentActivity zie ook Werkitems weergeven en toevoegen, pagina Werkitems.
Alle versies
Werk zoeken waar het geselecteerde datum/tijd-veld zich binnen de huidige dag, maand, week of jaar bevindt met een plus-/min-verschuiving, bijvoorbeeld: Closed Date>=@StartOfDay-7.
Azure DevOps 2019 tot en met Azure DevOps Server 2022, Azure DevOps Services
Zoek werk dat is toegewezen aan een gebiedspad of iteratiepad van het opgegeven team, voor voorbeelden, query op gebied of iteratiepad.
Azure DevOps 2019 tot en met Azure DevOps Server 2022, Azure DevOps Services
Queryresultaten en querybeheerfuncties
De volgende functies bieden ondersteuning voor het werken met queryresultaten, het opslaan en delen van query's, en meer.
- Een querygrafiek toevoegen aan een dashboard
- Interactieve filters toepassen
- Kolomsorteerd kiezen
- Opties voor querykolom kiezen
- Queryresultaten
- kopiëren Query-URL kopiëren
- Querygrafieken maken
- Querymappen maken
Niet-ondersteunde functies
Werkitemquery's ondersteunen alleen het opvragen van werkitems en werkitems die zijn gekoppeld aan andere werkitems. Hier volgen enkele van de taken die beheerde query's niet ondersteunen:
- Hiërarchische weergaven van testplannen, testsuites en testcases. Deze items worden niet aan elkaar gekoppeld met behulp van koppelingstypen tussen bovenliggende en onderliggende items. In plaats daarvan kunt u de hiërarchie bekijken via de pagina Testplannen>.
- Weergaven met gekoppelde objecten, zoals builds, releases, code of andere niet-werkitemobjecten.
- Werkitems weergeven die van het ene project naar het andere zijn gekoppeld.
- Een query voor meerdere projecten exporteren naar Excel. Directe koppelingen die query's exporteren naar Excel als een platte lijst.
Querytypen (platte, directe koppelingen, structuur)
Azure Boards ondersteunt drie querytypen. Het pictogram naast elke query geeft het querytype aan. Gebruik de volgende richtlijnen om het querytype te kiezen op basis van wat u wilt bereiken met de query.
Querytype
Richtlijnen voor gebruik
Platte lijst met werkitems
- Items weergeven om bulkupdates voor velden uit te voeren
- Een lijst met werkitems classificeren
- Een querygrafiek maken en toevoegen aan een dashboard
- Een grafiek maken om een aantal items op te halen of een veld op te tellen
- Een lijst met items exporteren naar Excel om velden bij te werken
Werkitems en directe koppelingen
- Lijstitems die afhankelijk zijn van andere werkitems
- Items zoeken die gerelateerd zijn of afhankelijk zijn van andere werkitems
- Gekoppelde werkitems weergeven om bulkupdates voor velden uit te voeren
- Een lijst met gekoppelde werkitems classificeren
- Gekoppelde werkitems weergeven die zijn gekoppeld aan een test
- Zwevende achterstallige items zoeken, werkitems zonder bovenliggende items
Notitie
Werkitems en directe koppelingen die query's exporteren naar Excel als een platte lijst. Query's voor directe koppelingen worden geïmporteerd als een platte lijst omdat het wijzigen van meerdere typen koppelingen geen ondersteunde functie is in Excel.
Structuur van werkitems
- Een structuur weergeven met werkitems met betrekking tot bovenliggend/onderliggend item of een ander koppelingstype structuurtopologie
- Een hiërarchische lijst met werkitems classificeren
- Een hiërarchische lijst met items exporteren naar Excel om velden bij te werken of de hiërarchie te wijzigen
Zie Koppelingstypereferentie voor meer informatie over koppelingstypen.
Mijn query's, gedeelde query's en favorieten
Alleen u kunt query's bekijken en uitvoeren die u opslaat onder Mijn query's met de map query's . U kunt ook een van deze query's aan uw favorieten toevoegen om deze weer te geven in de queryselector.
Query's die u en anderen opslaan onder Gedeelde query's , kunnen door iedereen met toegang tot het project worden bekeken. Gedeelde query's kunnen worden ingedeeld in mappen en door u of voor een team als favoriet worden aangeduid. U kunt ook machtigingen instellen voor de mappen en query's om te voorkomen dat anderen ze verplaatsen of bewerken.
Zie voor meer informatie:
- Query's en querymappen beheren
- Querymachtigingen instellen
- Een query favoriet maken en persoonlijke of teamfavorieten instellen
Querymap, querymappen en breadcrumbs
De pagina Query's bevat een mapgerichte weergave die u kunt filteren om specifieke query's te vinden die interessant zijn. Wanneer u op de pagina's Query's werkt, kunt u naar een submap, map of pagina gaan.
U kunt ook een query kiezen die u hebt geselecteerd in het menu selector. U kunt er ook voor kiezen om door alle query's te bladeren die u terugsturen naar de pagina Alle query's .
Zie Veelgestelde vragen over query's, navigeren en mappen voor meer informatie.
Querygrafieken en widgets
U kunt snel cirkel-, staaf-, draai- en trendgrafieken maken op basis van een platte query. Query's moeten een platte lijst zijn en 1000 of minder werkitems retourneren. U kunt uw querygrafieken toevoegen aan een dashboard, de titel ervan wijzigen en deze opnieuw configureren.
Op query's gebaseerde widgets bieden ondersteuning voor het presenteren van querygegevens op een dashboard. Bijvoorbeeld het aantal actieve bugs of een lijst met werkitems waarmee u kunt werken. Zie de volgende artikelen voor meer informatie over querygrafieken en widgets:
- Een platte lijstquery in kaart brengen
- Grafiek voor werkitemswidget
- Widget Queryresultaten
- Widget Querytegel
Een aangepast veld toevoegen om query's te ondersteunen
Als u een aangepast veld wilt toevoegen ter ondersteuning van uw querybehoeften, raadpleegt u Uw ervaring voor het bijhouden van werk aanpassen.
Taskboard versus querylijstitems
U ziet en vraagt zich misschien af waarom de inhoud van het taskboard verschilt van de inhoud die wordt vermeld met de gemaakte query? Zie taskboard-items versus querylijstitems voor meer informatie.
Query's en sorteringsinstellingen voor volledige tekst
Ter ondersteuning van zoekquery's in volledige tekst moeten de sorteringsinstellingen van de SQL Server-database overeenkomen met een taal met een woordonderbreker die is geregistreerd bij SQL Server. Als u een niet-ondersteunde taal gebruikt, kunt u onverwachte resultaten ontvangen wanneer u een werkitemquery uitvoert waarmee de operators Contains or Contains words met teksttekenreeksen worden opgegeven.
Raadpleeg voor meer informatie de volgende artikelen:
REST-API
Als u programmatisch wilt communiceren met query's, raadpleegt u een van deze REST API-resources:
- Naslaginformatie over REST API voor Azure DevOps Services
- Query's
- Querytaal voor werkitems
- Werkitems met query's programmatisch ophalen
Verwante artikelen:
- Veelgestelde vragen over query's
- Snelle naslaginformatie voor query's
- Veldindex werkitem
- Querymachtigingen instellen
- Queryvelden, operators en macro's
- Bulk add or modify work items with Excel (Werkitems bulksgewijs toevoegen of wijzigen met Excel)