Queryvelden, operatoren en macro's

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

Tip

Voor het eerst een query uitvoeren? Begin met Een query definiëren voor procedurestappen of snelzoekgids voor query's voor voorbeelden.

Gebruik deze referentiehandleiding om veldgegevenstypen, queryoperators, macro's en variabelen op te zoeken bij het bouwen van query's in de Power Query-editor. Alle operators en macro's worden ondersteund in Azure Boards; sommige zijn alleen van toepassing op specifieke Azure DevOps Server versies.

Zie Snelzoekgids voor query's en query's beheren en organiseren voor snelle voorbeelden en editortaken.

Voorwaarden

Categorie Eisen
Projectlidmaatschap U moet worden toegevoegd als lid van het project.
Toegangsniveaus - Als u gedeelde query's wilt weergeven en uitvoeren: u moet een Project lid zijn.
- Als u een gedeelde query wilt toevoegen en opslaan: u moet ten minste basistoegang hebben.
Permissions Zorg ervoor dat de machtiging Bijdragen is ingesteld op Toestaan voor de map waaraan u een query wilt toevoegen. Mogelijk moet uw organisatie de groep Inzenders handmatig configureren om deze machtiging te verlenen.

Notitie

U hebt zowel een voldoende toegangsniveau als een bijdragemachtiging nodig om gedeelde query's op te slaan. Basistoegang is niet voldoende.

Categorie Eisen
Projectlidmaatschap U moet worden toegevoegd als lid van het project.
Toegangsniveaus - Als u gedeelde query's wilt weergeven en uitvoeren: u moet een Project lid zijn.
- Als u een gedeelde query wilt toevoegen en opslaan: u moet ten minste basistoegang hebben.
Permissions Zorg ervoor dat de machtiging Bijdragen is ingesteld op Toestaan voor de map waaraan u een query wilt toevoegen. Mogelijk moet uw organisatie de groep Inzenders handmatig configureren om deze machtiging te verlenen.

Notitie

U hebt zowel een voldoende toegangsniveau als een bijdragemachtiging nodig om gedeelde query's op te slaan. Basistoegang is niet voldoende.

Gegevenstypen en waarden van queryvelden

Geef een waarde op die overeenkomt met het gegevenstype voor een veld. De volgende tabel bevat ondersteunde gegevenstypen:

Notitie

Voor Azure Boards (cloud) komt het gegevenstype overeen met het veld dat wordt weergegeven op de pagina Process > Velden. Voor on-premises implementaties komt het gegevenstype overeen met het type kenmerk van een FIELD definitie. Zie Werkitemvelden en veldkenmerken voor meer informatie.

Gegevenstype Description
Boolean Slaat een waar/onwaar-waarde op.
Datum/ tijd of datum/tijd Gebruik een datumvariabele (bijvoorbeeld @Today of @Today-1) of een expliciete datum zoals 01/01/2025. Voer datums in volgens het patroon dat in uw profiel is ingesteld. Voor voorbeelden van queries, zie Query by date or @CurrentIteration. Voor WIQL-query's kunt u ook datums opgeven in UTC. Zie Syntaxis voor de Werkitemquerytaal (WIQL).
Dubbel of decimaal Hiermee wordt een reëel getal opgeslagen, zoals 0,2 of 3,5. Zie Query op numerieke velden voor voorbeelden.
GUID Slaat een unieke id-tekenreeks op.
Geschiedenis Aangepast opgemaakt veld dat wordt gebruikt voor historische informatie (het veld Geschiedenis ). Wanneer zoeken in volledige tekst beschikbaar is, wordt dit veld geïndexeerd voor query's in volledige tekst. Zie Geschiedenis en controle.
HTML Hiermee worden opgemaakte tekst opgeslagen, zoals Beschrijving of Stappen voor opnieuw proberen. Wanneer zoeken in volledige tekst beschikbaar is, worden deze velden geïndexeerd. Zie Query op titels, id's en velden met tekst met opmaak als u een query wilt uitvoeren op velden met tekst met opmaak.
Identiteit Hiermee wordt een korte tekenreeks opgeslagen waarmee een gebruikersidentiteit wordt geïdentificeerd.
Geheel getal Slaat een ondertekend 32-bits geheel getal op, zoals 0, 1, 2 of 34.
Tekst zonder opmaak of tekstveld (meerdere regels) Slaat lange tekstwaarden op, zoals opstartgegevens van de toepassing. Deze velden indexeren voor zoekopdrachten in volledige tekst wanneer deze worden ondersteund. Zie Query op titels, id's en velden met tekst met opmaak.
picklistDouble Aangepast veld met een selectielijst met decimale waarden.
picklistInteger Aangepast veld met een selectielijst met gehele getallen.
picklistString Aangepast veld met een selectielijst met korte tekstwaarden (255 tekens of minder).
Tekenreeks - of tekstveld (één regel) Hiermee worden korte tekst tot 255 Unicode-tekens opgeslagen. Teams gebruiken deze velden vaak voor selectielijsten of vervolgkeuzelijsten.
TreePath Vertegenwoordigt een boomstructuur met vertakkingen, zoals een gebiedspad of een iteratiepad. Kies een geldige knooppuntwaarde. U kunt filteren op gelijkheid, ongelijkheid, 'Onder' of 'Niet onder'. Gebruik de In en Not In operators om meerdere waarden op te geven. Definieer structuurstructuren voor een project - gebiedspaden en iteratiepaden - en selecteer de knooppunten die u aan teams wilt koppelen. Zie Query op gebied of iteratiepad en Query op datum of huidige iteratie voor queryvoorbeelden.

Notitie

De picklist... typen zijn alleen van toepassing op aangepaste velden die zijn gedefinieerd voor een overgenomen proces.

Datum- en tijdpatroon

Het datum- en tijdpatroon dat u invoert voor datum/tijd-velden , moet overeenkomen met het patroon dat u selecteert via uw profiel. Zie Gebruikersvoorkeuren instellen om uw selectie weer te geven of te wijzigen.

Schermopname van de vervolgkeuzelijst Datumpatroon in het deelvenster Tijd en Landinstellingen. Schermopname van de vervolgkeuzelijst Tijdpatroon in het deelvenster Tijd en Landinstellingen.

Schermopname van het deelvenster Tijd en landinstellingen met de velden Datumpatroon en Tijdpatroon.

Queryoperators

Gebruik operators om te definiëren hoe een componentwaarde moet worden gerelateerd aan de veldwaarde van een werkitem. Raadpleeg de werkitemveldverwijzing voor veldgegevens typen. Zie Een query definiëren voor hulp bij het bouwen van query's.

Queryoperator Wanneer de operator overeenkomende werkitems retourneert Toepasselijke gegevenstypen
= Komt overeen met de clausulewaarde. Getal (double/decimal/GUID/integer), tekenreeks, datum/tijd, treepath
<> Komt niet overeen met de clausulewaarde. Getal, tekenreeks, datum/tijd, treepath
> Is groter dan de clausulewaarde. Getal, tekenreeks, datum/tijd
< Is kleiner dan de waarde van de clausule. Getal, tekenreeks, datum/tijd
>= Is groter dan of gelijk aan de waarde van de clausule. Getal, tekenreeks, datum/tijd
<= Is kleiner dan of gelijk aan de clausulewaarde. Getal, tekenreeks, datum/tijd
=[veld] Komt overeen met de waarde in een ander opgegeven veld (moet hetzelfde gegevenstype zijn). Naam van een veld van hetzelfde gegevenstype (Booleaanse velden vergelijken gelijkheid met andere velden).
<>[Veld] Komt niet overeen met de waarde in een ander opgegeven veld. Naam van een veld van hetzelfde gegevenstype.
>[Veld] Is groter dan de waarde in een ander opgegeven veld. Naam van een veld van hetzelfde gegevenstype.
<[Veld] Is kleiner dan de waarde in een ander opgegeven veld. Naam van een veld van hetzelfde gegevenstype.
>=[veld] Is groter dan of gelijk aan de waarde in een ander opgegeven veld. Naam van een veld van hetzelfde gegevenstype.
<=[veld] Is kleiner dan of gelijk aan de waarde in een ander opgegeven veld. Naam van een veld van hetzelfde gegevenstype.
Bevat Bevat een exacte of gedeeltelijke tekstovereenstemming. Snaar / Touwtje
Bevat geen Bevat geen exacte of gedeeltelijke overeenkomst met de tekst. Snaar / Touwtje
Bevat woorden Komt overeen met een exacte woordgroep of woorden (ondersteunt trailing wildcard *). Limiet: 100 tekens. Deze operator maakt gebruik van indexering in volledige tekst; zie de sectie Volledige tekst in dit artikel voor server- en sorteringsvereisten. Velden met lange tekst geïndexeerd voor zoeken in volledige tekst (tekst zonder opmaak, HTML, geschiedenis en titel).
Bevat geen woorden Hiermee worden items uitgesloten die de opgegeven woordgroep of woorden bevatten. Limiet: 100 tekens. Gebruik met Contains Words in companion-clausules om trefwoorden op te nemen of uit te sluiten. Tekstvelden geïndexeerd voor zoeken in volledige tekst.
In Komt overeen met een waarde in een gescheiden set (gebruik het regionale lijstscheidingsteken van het besturingssysteem, meestal een komma). Getal, tekenreeks, datum/tijd, treepath
Is leeg Komt overeen met items waarin een HTML-veld geen inhoud bevat (geen waarde opgegeven). Ondersteund voor Azure Boards en Azure DevOps Server. HTML
Is niet leeg Komt overeen met items waarin een HTML-veld inhoud bevat. Ondersteund voor Azure Boards en Azure DevOps Server. HTML
Niet in Hiermee worden waarden uitgesloten in een gescheiden set (gebruik het scheidingsteken voor regionale lijsten). Ondersteund voor Azure Boards en Azure DevOps Server. Getal, tekenreeks, datum/tijd, treepath
In groep Komt overeen met waarden die lid zijn van een benoemde groep (team, beveiligingsgroep of categorie). Gebruik bijvoorbeeld de groep Inzenders of een teamgroep met de naam in het patroon [Project Name]\Team Name. Zie Query bij toewijzings- of workflowwijzigingen voor voorbeelden. Gebruik in groep alleen met tekenreeksvelden of werkitemtype. U kunt Microsoft Entra ID groepen gebruiken wanneer uw account gebruikmaakt van Microsoft Entra ID of Active Directory groepen voor on-premises. Tekenreeks (komt overeen met groep of teamnaam) of type werkitem
Niet in groep Hiermee worden leden van een benoemde groep uitgesloten. Tekenreeks die overeenkomt met een gebruikersgroep of projectcategorie.
Niet onder Hiermee worden items uitgesloten die gelijk zijn aan of onderdeel zijn van het opgegeven knooppunt in de structuur. TreePath
Onder Komt overeen met items die gelijk zijn aan of zijn opgenomen onder het gespecificeerde boomknooppunt. TreePath
Was ooit Komt overeen met een waarde die een veld op een eerder tijdstip heeft bewaard. (Power Query-editor: alleen tekenreeksvelden. DateTime-ondersteuning vereist directe WIQL-query's.) Tekenreeks, DatumTijd

Tip

U kunt WIQL-query's maken die gebruikmaken van operators (bijvoorbeeld Was Ever) voor andere gegevenstypen, zoals iteratiepad. Zie Lijstwerkitems die zijn verplaatst uit een sprint voor een voorbeeld.

Veelvoorkomende operatorvoorbeelden

Hier volgen representatieve queryvoorbeelden die gebruikmaken van verschillende operators:

Query Returns
State = Active Werkitems met de status Actief
Priority <> Low Alle items behalve items met lage prioriteit
Created Date >= @Today-7 Werkitems gemaakt in de afgelopen 7 dagen
Assigned To = @Me Items die zijn toegewezen aan de huidige gebruiker
Tags Contains "frontend" Items met een tag die "frontend" bevat
State In (Active, In Progress) Items met een van beide statussen
Area Path Under "Project\Web" Alle onderdelen in het onderdeel Web, inclusief subgebieden
Assigned To In Group "[Project]\Developers" Items die zijn toegewezen aan iedereen in de groep Ontwikkelaars
Description Contains Words "urgent" Items waarin de beschrijving het woord "urgent" bevat

Zoekopdrachten in volledige tekst en gedeeltelijk woord

Gebruik Contains of Does Not Contain om in velden voor lange tekst te zoeken naar exacte of gedeeltelijke matches. Deze operators gebruiken de queryindex. Gebruik Bevat woorden of Bevat geen woorden om exacte woordgroepen te zoeken of gebruik een jokerteken aan het einde (*). Voor deze operators is de volledige-tekstindex vereist.

U kunt het jokerteken alleen aan het einde van een gedeeltelijk woord of woordgroep gebruiken. Zie voor voorbeelden voorbeeldquery's voor werkitems en query naar werkitems met behulp van het veld Geschiedenis.

Notitie

Niet alle implementaties ondersteunen zoeken in volledige tekst. SQL Express en sommige cloud-SQL-configuraties bieden bijvoorbeeld geen ondersteuning voor zoeken in volledige tekst. In deze implementaties zijn alleen de Contains-operator en de Bevat Niet-operator zichtbaar.

Azure DevOps Server indexeert lange-tekstvelden (PlainText en HTML) en het veld Titel voor zoeken in volledige tekst wanneer de onderliggende SQL Server volledige-tekstindexering ondersteunt.

Zoeken in volledige tekst vereist ook een SQL-sortering met een geregistreerde woordonderbreker voor de taal die u gebruikt. Als de sortering van de verzamelingsdatabase niet overeenkomt met een ondersteunde taal, komen de resultaten mogelijk niet overeen met de verwachtingen. Gebruik in die gevallen in plaats daarvan Bevat of Bevat niet.

Zie Volledige-tekstzoekopdrachten en sorteringsinstellingen voor meer informatie.

Combinatieoperatoren

Query's gebruiken AND-logica om meerdere componenten te combineren. Elke extra component filtert de resultaten verder. Voorbeeld:

  • State = Active AND Priority = High retourneert werkitems die zowel actief zijn als met een hoge prioriteit.
  • State = Active AND State <> Closed retourneert actieve items met uitzondering van items die zijn gemarkeerd als gesloten.
  • Assigned To = @Me AND State <> Done retourneert items die aan u zijn toegewezen die niet zijn voltooid.

U kunt haakjes gebruiken om voorwaarden te groeperen voor complexe query's in directe WIQL-syntaxis:

  • (State = Active OR State = In Progress) AND Priority = High geeft items met hoge prioriteit weer met de status Actief of In uitvoering.

Zie Syntaxis voor de WIQL-taal (Work Item Query Language) voor meer voorbeelden en WIQL-syntaxisdetails.

Problemen oplossen en veelvoorkomende fouten

Probleem Waarschijnlijke oorzaak Solution
Macro retourneert geen resultaten @CurrentIteration werkt alleen in de webportal; REST API's en CLI kunnen lege resultaten retourneren Gebruik in plaats daarvan directe datums in scripts of API's. Zie Query op datum of huidige iteratie voor alternatieven.
@TeamAreas query onverwachte resultaten retourneert Macro werkt alleen met het veld Gebiedspad ; het gebruik ervan met andere velden heeft geen effect Controleer of u filtert op gebiedspad. Gebruik in plaats daarvan andere structuurpadvelden (Iteratiepad) met de operator Under .
Fout in operator 'Bevat woorden' Query overschrijdt de limiet van 100 tekens of maakt gebruik van een ongeldige plaatsing van jokertekens Beperk querytekst tot minder dan 100 tekens. Gebruik alleen jokertekens aan het einde van de term (bijvoorbeeld feature*), niet aan het begin.
In groepsquery mislukt De indeling van de groepsnaam is onjuist of de groep bestaat niet Gebruik de exacte indeling: Assigned To In Group "[Project]\\Team Name" voor teams. Controleer de groepsnaam in projectinstellingen.
Werkte de Ever-operator niet met datums Power Query-editor biedt geen ondersteuning Was Ever voor datum/tijd-velden Gebruik directe WIQL-syntaxis in plaats van visualquery-editor. Zie Syntaxis voor de WiQL (Work Item Query Language) voor meer informatie.
Booleaanse veldquery retourneert geen resultaten Waarde is hoofdlettergevoelig in WIQL-query's Gebruik exact hetzelfde hoofdlettergebruik: CustomBoolField = True of CustomBoolField = False (hoofdletters T/F in WIQL).

Query's uitvoeren op macro's en variabelen

Gebruik de volgende macro's om query's dynamisch te filteren.

Notitie

De volgende macro's worden alleen ondersteund vanuit de webportal: @CurrentIteration, @CurrentIteration +/- n, @Follows, @MyRecentActivity, @RecentMentions, @RecentProjectActivityen @TeamAreas. Query's die deze macro's bevatten, werken niet wanneer ze worden geopend in Visual Studio/Team Explorer, Microsoft Excel of Microsoft Project.

Macroniveau Description
[Willekeurig] Gebruik met Werkitemtype of Status om te zoeken in alle typen en statussen. Hiermee verwijdert u bijvoorbeeld Work Item Type=[Any] filteren op basis van typen.
@CurrentIteration Gebruik met iteratiepad om te filteren op werkitems in de huidige sprint op basis van de huidige teamcontext. Zie Query op datum of huidige iteratie voor voorbeelden. @CurrentIteration werkt alleen wanneer deze wordt uitgevoerd vanuit de webportal (niet in REST API's of sommige kopieer-/kloonbewerkingen).
@CurrentIteration +/- n Gebruik met iteratiepad om sprints op te nemen ten opzichte van de huidige iteratie (bijvoorbeeld @CurrentIteration-1 of @CurrentIteration+2). Ondersteund in de webportal voor Azure Boards en Azure DevOps Server.
@Follows Gebruik met ID en de In-operator om de werkitems weer te geven die u binnen het project volgt. Zie Een werkitem of pull-aanvraag volgen. Deze macro werkt alleen vanuit de webportal.
@Me Gebruiken met identiteitsvelden om te filteren op items die zijn gekoppeld aan uw account (bijvoorbeeld Created By=@Me). Zie Query via toewijzings-, workflow- of bordwijzigingen.
@MyRecentActivity Gebruik deze functie met id en In om werkitems weer te geven die u in de afgelopen ~30 dagen hebt bekeken of bijgewerkt. Zie de werkpagina Mijn activiteiten om dezelfde lijst te zien.
@Project Gebruik met Teamproject om te filteren op werkitems in het huidige project (bijvoorbeeld Team Project=@Project). Zie Query over meerdere projecten.
@RecentMentions Gebruik deze functie met id en In om werkitems weer te geven waarin u wordt vermeld in discussies. Zie de pagina Werkitems vermeld draaipunt.
@RecentProjectActivity Gebruik deze functie met id en In om onlangs bijgewerkte werkitems in het project weer te geven. De macro retourneert maximaal 5000 items; het werkelijke venster is afhankelijk van projectactiviteit.
@StartOfDay Gebruik met Datum/tijd-velden om te filteren ten opzichte van vandaag (bijvoorbeeld Closed Date>=@StartOfDay-7).
@StartOfMonth Gebruik met Datum/tijd-velden om te filteren ten opzichte van het begin van de maand (bijvoorbeeld Created Date>=@StartOfMonth-3).
@StartOfWeek Gebruik met datum/tijd-velden om te filteren ten opzichte van het begin van de week (bijvoorbeeld Changed Date>=@StartOfWeek-2).
@StartOfYear Gebruik met Datum/tijd-velden om te filteren ten opzichte van het begin van het jaar (bijvoorbeeld Target Date>=@StartOfYear).
@TeamAreas Gebruik alleen met gebiedspad en de = operator om items te vinden die zijn toegewezen aan de gebiedspaden van een team (bijvoorbeeld Area Path=@TeamAreas [Fabrikam Fiber]\Web). Ondersteund in de webportal voor Azure Boards en Azure DevOps Server.
@Today Gebruik met Datum/tijd-velden om te filteren ten opzichte van vandaag (bijvoorbeeld Created Date>=@Today-7). Zie Query op datum of huidige iteratie.

Algemene macrovoorbeelden

Hier volgen representatieve queryvoorbeelden die macro's gebruiken om query's dynamisch te maken:

Query Retouren (webportaal)
Iteration Path = @CurrentIteration Werkitems in de huidige sprint
Iteration Path = @CurrentIteration-1 Werkitems in de vorige sprint
Assigned To = @Me Items die zijn toegewezen aan de huidige gebruiker
Created Date >= @Today-30 Items die in de afgelopen 30 dagen zijn gemaakt
State = Active AND Area Path = @TeamAreas [Project]\MyTeam Actieve items in het gebied van uw team
Work Item Type = [Any] Alle werkitemtypen (verwijdert filtering op type)
Assigned To In Group @Follows Items die zijn toegewezen aan personen die u volgt

Notitie

Macro's zoals @CurrentIteration, @Meen @Follows@TeamAreas werken alleen in de webportal. Voor REST API's, CLI en Power BI gebruikt u in plaats daarvan directe datums en gebruikers-id's. Zie Query op datum of huidige iteratie voor alternatieven.

Verwante inhoud

REST-API

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

  • Last updated on