Delen via

Uw werk bijhouden met behulp van beheerde query's in Azure Boards

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

Gebruik query's om bugs, gebruikersverhalen of andere werkitems weer te geven op basis van de veldcriteria die u opgeeft. Teams voeren deze lijsten uit om werk te classificeren, items bulksgewijs bij te werken of hiërarchieën te controleren. Semantisch zoeken biedt overlappende en complementaire mogelijkheden die het verkennen waard zijn.

Beheerde queries gebruiken om:

  • Werkitems bulksgewijs bijwerken met behulp van de webportal
  • Werkitems classificeren en bijwerken
  • Een hiërarchie van werkitems controleren
  • Een lijst met werkitems delen met een teamgenoot

U kunt query's en querymappen maken vanuit de webportal of Visual Studio Team Explorer. Wijzigingen die u in de ene client aanbrengt, worden in de andere weergegeven omdat alle wijzigingen worden opgeslagen in het gegevensarchief voor het bijhouden van werk.

Aan de slag met query's

Als u aan de slag gaat, leest u Een werkitemquery weergeven, uitvoeren of e-mailen. Zie snelzoekgids voor queryeditortaken en voorbeeldquery's voor een beknopt overzicht van queryeditortaken.

  • Als u werkitems wilt zoeken die aan u zijn toegewezen, gebruikt u de macro @Me als de waarde voor het veld Toegewezen aan in een component.
  • Alle geldige gebruikers met standaardtoegang kunnen query's en mappen maken onder Mijn query's. Als u query's en mappen wilt maken onder Gedeelde query's, moet u de Bijdragen-toestemming hebben. Zie Machtigingen instellen voor query's.
  • Wijzig een query 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.
  • Open een query in Excel om velden bij te werken en wijzigingen in de database te publiceren.
  • Visualiseer de status of voortgang door een cirkel-, kolom- of trenddiagram te maken voor platte query's. Zie Grafieken voor meer informatie.

Querymogelijkheden

De volgende secties bevatten een overzicht van functies die u gebruikt om werkitemquery's te definiëren en te beheren.

  • Queryfilters definiëren met de Query-editor.
  • Gebruik query-macro's in clausules om velden dynamisch te richten.
  • Queryresultaten en mappen beheren vanaf 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

Zoekopdrachten met jokertekens

Jokerteken = *

Alle versies

Zoekopdrachten voor gekoppelde werkitems

Werkitems zoeken op basis van directe koppelingen of topologische/hiërarchische koppelingstypen.
Gekoppelde werkitems filteren op MODE basis van (WIQL-syntaxis)

Alle versies

Logische componentgroeperingen

Groeps- en nestcomponenten met behulp van EN- en OR-booleaanse operatoren.

Alle versies

Historische tekenreeks- en datum/tijd-veldquery's

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

Query's uitvoeren met macro's of variabelen

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

Zoeken in projecten

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

Zoekopdrachten voor veldvergelijking

Werkitems zoeken op basis van de vergelijking tussen twee velden en elkaar.
Ondersteunde operators: =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field]

Alle versies

Query uitvoeren op tags

Werkitems zoeken op basis van of ze een tag bevatten of niet bevatten. Ondersteunde operators: Contains, Does Not Contain

Alle versies

Query uitvoeren op lege of lege velden

Werkitems zoeken op basis van lege of niet lege HTML-/rtf-velden.
Ondersteunde operators: Is Empty, Is Not Empty

Alle versies

Zoekopdrachten in en niet in groepen

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

Booleaanse zoekopdrachten

Werkitems zoeken op basis van booleaanse veldwaarde.

Alle versies

Querygeschiedenis en -discussie

Werkitems zoeken op basis van sleutelwoorden of woordgroepen die via de discussie zijn toegevoegd.

Alle versies

Query uitvoeren op bordvelden

Werkitems zoeken op basis van hun kolom, zwembaan of Status Uitvoeren/Gereed.

Alle versies

Interactieve queryfilters

Queryresultaten filteren op basis van een sleutelwoord of velden selecteren.

Alle versies

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

[Any]

Zoek een werkitemtype, Work Item Type=[Any]of een willekeurige status. State=[Any]

Alle versies

@Me

Werk zoeken waar Identity field=logged in user.

Alle versies

@Today

Werk zoeken waar Date-Time field=today.

Alle versies

@Project

Werk zoeken dat is gedefinieerd in een of meer projecten.

Alle versies

@CurrentIteration

Werk zoeken dat is gedefinieerd in de huidige iteratie voor een team.

Alle versies

@CurrentIteration +/-n

Werk zoeken dat is gedefinieerd in +/- n van de huidige iteratie voor een team.

Alle versies

@Follows

Zoeken naar werk dat momenteel is aangemeld door de gebruiker die is aangemeld, ID In @Followsvolgt.

Alle versies

@MyRecentActivity, @RecentMentions, @RecentProjectActivity

Werkitems zoeken die onlangs zijn gewijzigd, ID In @MyRecentActivity zie ook Werkitems weergeven en toevoegen, pagina Werkitems.

Alle versies

@StartOfDay, @StartOfMonth, @StartOfWeek, @StartOfYear

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.

Alle versies

@TeamAreas

Zoek werk dat is toegewezen aan een gebiedspad of iteratiepad van het opgegeven team, voor voorbeelden, query op gebied of iteratiepad.

Alle versies

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
-  Resultaten van query kopiëren
-  query-URL kopiëren
-  Querygrafieken maken
-  Querymappen maken

-  Een query definiëren en bewerken
-  WIQL-syntaxis definiëren
-  Resultaten van e-mailquery
-  Een query aan favorieten toevoegen
-  Een query filteren

-  Een query importeren/exporteren (CSV)
-  Een query importeren/exporteren (.wiq)
-  Een query openen en uitvoeren
-  Een query publiceren/vernieuwen (Excel)
-  REST API-query's uitvoeren
-  queries kopiëren en opslaan
-  Querymachtigingen instellen

Niet-ondersteunde functies

Query's ondersteunen alleen werkitems en werkitems die zijn gekoppeld aan andere werkitems. Gebeheerde query's bieden ondersteuning niet voor:

  • Hiërarchische weergaven van testplannen, testsuites en testcases (deze items gebruiken geen ouder-kind koppelingen). Bekijk in plaats daarvan de hiërarchie via de pagina Testplannen > .
  • Weergaven die gekoppelde objecten tonen, zoals builds, releases, code of andere objecten die geen werkitems zijn.
  • Werkitems weergeven die van het ene project naar het andere zijn gekoppeld.
  • Een query voor meerdere projecten exporteren naar Excel (query's voor directe koppelingen exporteren als een platte lijst).

Azure Boards ondersteunt drie querytypen; het pictogram naast een query geeft het type aan. Kies het type op basis van de gewenste resultaten.

Schermopname van pictogrammen van het querytype.

Querytype

Richtlijnen voor gebruik

Platte lijst met werkitems

  • Lijstitems voor het uitvoeren van bulkupdates
  • Een lijst met werkitems classificeren
  • Een querygrafiek maken en toevoegen aan een dashboard
  • Een grafiek maken om items te tellen of een numeriek veld op te tellen
  • Een lijst exporteren naar Excel om velden bij te werken

Werkitems en directe koppelingen

  • Lijstitems die afhankelijk zijn van andere werkitems
  • Gerelateerde of afhankelijke items zoeken
  • Gekoppelde werkitems weergeven om bulkupdates uit te voeren
  • Gelinkte werkitems prioriteren, inclusief testgerelateerde links
  • Vind verweesde achterstallige items (items zonder ouder)

Notitie

Werkitems en directe koppelingen die query's exporteren naar Excel als een platte lijst. Excel importeert ze als een platte lijst, omdat het wijzigen van meerdere koppelingstypen niet wordt ondersteund in Excel.

Structuur van werkitems

  • Een structuur van Parent-Child gerelateerde werkitems of andere koppelingstypen voor structuurtopologie weergeven
  • Hiërarchische lijsten met werkitems classificeren
  • Een hiërarchische lijst 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 weergeven en uitvoeren die zijn opgeslagen onder Mijn query's. U kunt een query als favoriet toevoegen om deze in de querykiezer weer te geven.

Query's die zijn opgeslagen onder Gedeelde query's , zijn zichtbaar voor iedereen met projecttoegang. Organiseer gedeelde query's in mappen en maak ze favoriet voor snelle toegang. U kunt machtigingen instellen voor mappen en query's om te voorkomen dat anderen ze verplaatsen of bewerken.

Zie voor meer informatie:

Querymap, querymappen en breadcrumbs

De pagina Query's bevat favorieten en alle tabbladen. Elk tabblad bevat een mapweergave die u kunt filteren om specifieke query's te vinden.

Wanneer u door de Query-pagina's navigeert, kunt u een map, een submap of een query-pagina openen.

Schermopname van de navigatie van de querypagina.

Terwijl u selecties maakt, worden breadcrumbs boven aan de pagina weergegeven. Gebruik deze om naar een map, submap of opvraagpagina te gaan.

Schermopname van breadcrumbs op de querypagina.

U kunt ook een favoriete query selecteren of terugkeren naar de pagina Alle query's in de vervolgkeuzelijst van een geopende query.

Schermopname van de vervolgkeuzelijst voor query's.

Schermopname van de vervolgkeuzelijst voor querynavigatie.

Zie Veelgestelde vragen over query's, navigeren en mappen voor meer informatie.

Querygrafieken en widgets

Cirkel-, staaf-, draaitabel- en trenddiagrammen maken op basis van een query met een platte lijst (query's moeten 1000 of minder werkitems teruggeven). Voeg querygrafieken toe aan dashboards, geef ze een recht en configureer ze indien nodig opnieuw.

Schermopname van een voorbeeld van een cirkeldiagram. Schermopname van een voorbeeld van een draaigrafiek.
Schermopname van een voorbeeld van een staafdiagram. Schermopname van een voorbeeld van een trenddiagram.

Op query's gebaseerde widgets geven querygegevens weer op een dashboard (bijvoorbeeld het aantal actieve bugs of een interactieve lijst met werkitems). Zie voor meer informatie:

Een aangepast veld toevoegen om query's te ondersteunen

Zie Uw ervaring voor het bijhouden van werk aanpassen als u een aangepast veld voor query's wilt toevoegen.

Taskboard versus querylijstitems

Als de inhoud van het taskboard verschilt van de resultaten van een gemaakte query, raadpleegt u Taskboard-items versus querylijstitems voor meer informatie.

Query's en sorteringsinstellingen voor volledige tekst

Als u zoekquery's in volledige tekst gebruikt met de operators Contains of Contains Words , moet u ervoor zorgen dat SQL Server-sortering overeenkomt met een taal met een geregistreerde woordonderbreker. Niet-ondersteunde talen kunnen onverwachte resultaten opleveren.

Zie voor meer informatie:

REST-API

Als u programmatisch wilt communiceren met query's, raadpleegt u een van deze REST API-resources:

Verwante inhoud

  • Last updated on