Queryvelden, operators en macro's in Azure Boards

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

Hier vindt u gedetailleerde beschrijvingen van elk veldgegevenstype, queryoperators en querymacro's. Sommige gegevenstypen, operators en macro's zijn alleen geldig voor de aangegeven Versie van Azure DevOps.

Zie Snelzoekgids voor querytaken en operators en macro's die voor elk gegevenstype worden ondersteund voor een beknopt overzicht van querytaken en -macro's. Zie ook Een query/aanbevolen procedures maken.

Gegevenstypen en waarden van query's uitvoeren op veldgegevens

De waarde die u voor een veld opgeeft, moet voldoen aan het gegevenstype voor dat veld. De volgende tabel bevat de ondersteunde gegevenstypen:

Notitie

Voor de Azure Boards-cloudservice komt het gegevenstype overeen met het gegevenstype dat wordt vermeld voor het veld op de pagina Procesvelden>. Voor on-premises implementaties komt het gegevenstype overeen met het type kenmerk dat is toegewezen aan een FIELD definitie. Zie Werkitemvelden en veldkenmerken voor meer informatie.

Gegevenstype

Beschrijving

Booleaanse waarde

Hiermee geeft u een veld op dat een waar/onwaar-waarde aanneemt.

Datum/ tijd of datum/tijd

Een datumveld waarin u een variabele kunt opgeven, zoals @Today of @Today-1, of een waarde, zoals 1-1-2023. Voer datums in het datumpatroon in dat u instelt voor uw persoonlijke profiel. (Zie Persoonlijke voorkeuren instellen voor details.) Zie voor queryvoorbeelden Query by date or @CurrentIteration.

Voor WIQL-query's kunt u ook de datum opgeven in het UTC-patroon (Coordinated Universal Time). Zie Syntaxis voor de WiQL (Work Item Query Language) voor meer informatie.

Dubbel of decimaal

Een reëel getal, zoals 0,2 of 3,5. Zie Query op numerieke velden voor queryvoorbeelden.

GUID

Een tekenreeks die een unieke id vertegenwoordigt.

Geschiedenis

Aangepast opgemaakt veld dat wordt gebruikt om historische gegevens bij te houden. Dit gegevenstype wordt alleen gebruikt ter ondersteuning van het veld Geschiedenis . Dit veld wordt automatisch geïndexeerd voor zoeken in volledige tekst wanneer zoeken in volledige tekst beschikbaar is. Zie zoekopdrachten in volledige tekst en gedeeltelijke woorden die verderop in dit artikel worden beschreven. Zie Geschiedenis en controle voor queryvoorbeelden.

HTML

Tekenreeksen die opgemaakte beschrijvingen ondersteunen, zoals de velden Beschrijving of Stappen opnieuw uitvoeren . Deze velden worden automatisch geïndexeerd voor zoeken in volledige tekst wanneer zoeken in volledige tekst beschikbaar is. Zie zoekopdrachten in volledige tekst en gedeeltelijke woorden die verderop in dit artikel worden beschreven. 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

Korte tekenreeks die een gebruikersidentiteit identificeert.

Geheel getal

Een 32-bits geheel getal dat is ondertekend, zoals 0, 1, 2, 34.

Tekst zonder opmaak of tekstveld (meerdere regels)

Teksttekenreeksen die lange beschrijvingen ondersteunen, zoals het veld Startgegevens van toepassing. Deze velden worden automatisch geïndexeerd voor zoeken in volledige tekst, wanneer zoeken in volledige tekst beschikbaar is. Zie zoekopdrachten in volledige tekst en gedeeltelijke woorden die verderop in dit artikel worden beschreven. Als u velden zonder opmaak wilt opvragen, raadpleegt u Query op titels, id's en velden met tekst met opmaak.

picklistDouble¹

Aangepast veld dat is gedefinieerd voor een selectielijst met decimale waarden.

picklistInteger¹

Aangepast veld dat is gedefinieerd voor een selectielijst met gehele getallen.

picklistString¹

Aangepast veld dat is gedefinieerd voor een selectielijst met korte tekenreekswaarden (255 tekens of minder).

Tekenreeks - of tekstveld (één regel)

Korte tekenreeks met maximaal 255 Unicode-tekens. Tekenreekstekstvelden worden vaak gebruikt ter ondersteuning van selectielijsten of vervolgkeuzelijsten.

TreePath

Een vertakkingsstructuur, zoals een gebiedspad of iteratiepad. Kies een item in een lijst met geldige waarden. Werkitems zoeken die gelijk zijn aan, niet gelijk zijn aan, onder of niet onder een structuurstructuur, of de operators In of Niet gebruiken om verschillende waarden op te geven. U definieert de structuurstructuur voor een project( gebiedspaden en iteratiepaden) en selecteer vervolgens de structuurstructuur die u aan een team wilt koppelen.

Zie Query op gebied of iteratiepad of query op datum of huidige iteratie voor meer informatie over het samenstellen van query's.

Notitie

1. De selectielijst... gegevenstypen worden alleen toegewezen aan aangepaste velden die zijn gedefinieerd voor een overgenomen proces. Het overgenomen procesmodel wordt alleen ondersteund voor Azure DevOps Services en Azure DevOps Server 2019.

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 voor tijd en landinstellingen om uw selectie weer te geven of te wijzigen.

Query-operators

U kunt queryoperators in de volgende tabel gebruiken om op te geven hoe elke waarde in een component moet worden gerelateerd aan de bijbehorende waarde in een werkitem. Zie de naslaginformatie over het gegevenstype dat is toegewezen aan werkitemvelden.

Zie Een query definiëren voor meer informatie over het toevoegen van componenten en het gebruik van de en/of-operators.

Queryoperator

Retourneert werkitems als de waarde in het werkitem overeenkomt met de criteria die worden vermeld

Toepasselijke gegevenstypen

=

Komt overeen met de waarde in de component.

Getal, dat dubbele, GUID, geheel getal en tekenreeks, datum/tijd en TreePath bevat

<>

Komt niet overeen met de waarde in de component.

Getal, tekenreeks, datum/tijd en TreePath

>

Is groter dan de waarde in de component.

Getal, tekenreeks en datum/tijd

<

Is kleiner dan de waarde in de component.

Getal, tekenreeks en datum/tijd

>=

Is groter dan of gelijk aan de waarde in de component.

Getal, tekenreeks en datum/tijd

<=

Is kleiner dan of gelijk aan de waarde in de component.

Getal, tekenreeks en datum/tijd

=[veld]

Komt overeen met de waarde in het opgegeven veld.

Naam van een veld dat van hetzelfde gegevenstype is als het opgegeven veld

<>[Veld]

Komt niet overeen met de waarde die is opgenomen in het opgegeven veld.

Naam van een veld dat van hetzelfde gegevenstype is als het opgegeven veld

>[Veld]

Is groter dan de waarde die zich in het opgegeven veld bevindt.

Naam van een veld dat van hetzelfde gegevenstype is als het opgegeven veld

<[Veld]

Is kleiner dan de waarde die zich in het opgegeven veld bevindt.

Naam van een veld dat van hetzelfde gegevenstype is als het opgegeven veld

>=[veld]

Is groter dan of gelijk aan de waarde die zich in het opgegeven veld bevindt.

Naam van een veld dat van hetzelfde gegevenstype is als het opgegeven veld

<=[veld]

Is kleiner dan of gelijk aan de waarde die zich in het opgegeven veld bevindt.

Naam van een veld dat van hetzelfde gegevenstype is als het opgegeven veld

Bevat

Bevat een exacte of gedeeltelijke overeenkomst van de tekenreeks in het veld dat u hebt geselecteerd voor filteren.

Tekenreeks

Geen

Bevat geen exacte of gedeeltelijke overeenkomst van de tekenreeks in het veld dat u hebt geselecteerd voor filteren.

Tekenreeks

Bevat woorden

Bevat de exacte tekenreeks of woorden in het veld dat u hebt geselecteerd voor filteren. U kunt ook gedeeltelijke woorden of woordgroepen invoeren die het jokerteken * bevatten. Tekenreeks is beperkt tot 100 tekens. Zie Voor beperkingen zoekt u in volledige tekst naar server- en sorteringsvereisten.

Lange-tekstvelden die worden geïndexeerd voor zoeken in volledige tekst, die overeenkomen met alle velden PlainText en HTML , en de velden Geschiedenis en Titel .

Bevat geen woorden

Bevat niet de exacte tekenreeks of woorden in het veld dat u hebt geselecteerd voor filteren. Tekenreeks is beperkt tot 100 tekens.

Gebruik deze operator in combinatie met een component met de operator Contains Words om specifieke trefwoorden op te nemen en uit te sluiten.

Tekstvelden die zijn geïndexeerd voor zoekopdrachten in volledige tekst.

In

Komt overeen met een waarde in een gescheiden set. U kunt bijvoorbeeld werkitems vinden waarvan de id's 100, 101 en 102 zijn als u deze waarden opgeeft voor het id-veld. Scheid waarden met het lijstscheidingsteken dat overeenkomt met de landinstellingen die zijn gedefinieerd voor uw clientcomputer. U kunt bijvoorbeeld een komma(,) gebruiken.

Getal, tekenreeks, datum/tijd, treepath

Is leeg

Hiermee worden werkitems weergegeven die een leeg HTML-veld bevatten. U geeft geen waarde op met deze operator. Deze operator wordt ondersteund voor Azure Boards (cloudservice), Azure DevOps Server 2019 en latere versies.

HTML

Is niet leeg

Hiermee worden werkitems weergegeven die bepaalde inhoud in het HTML-veld bevatten. U geeft geen waarde op met deze operator. Deze operator wordt ondersteund voor Azure Boards (cloudservice), Azure DevOps Server 2019 en latere versies.

HTML

Niet in

Komt niet overeen met een waarde in een gescheiden set. U kunt werkitems uitsluiten waarvan de statussen niet zijn opgelost, voltooid of gesloten uit queryresultaten als u deze waarden voor het veld Status opgeeft. Scheid waarden met het lijstscheidingsteken dat overeenkomt met de landinstellingen die zijn gedefinieerd voor uw clientcomputer. U kunt bijvoorbeeld een komma(,) gebruiken.

De operator Not In is beschikbaar via Azure Boards en TFS 2018.2 en latere versies.

Getal, tekenreeks, datum/tijd, treepath

In groep

Komt overeen met een waarde die lid is van de groep in de component. Groepen komen overeen met de naam van een team, beveiligingsgroep of werktraceringscategorie. U kunt bijvoorbeeld een query maken om alle werkitems te vinden die zijn toegewezen aan leden van de groep Inzenders of aan een team. Teamgroepen worden gemaakt wanneer u een team maakt. De naam van teamgroepen volgt het patroon [Teamprojectnaam]\Teamnaam.

Zie Bijvoorbeeld query's op toewijzings- of werkstroomwijzigingen.

Tekenreeks die overeenkomt met de naam van een team, beveiligingsgroep of categorie die in het systeem is gedefinieerd.

Notitie

U kunt de operator In groep alleen gebruiken met velden die het gegevenstype Tekenreeks of het veld Type werkitem gebruiken. U kunt ook groepen gebruiken die zijn gedefinieerd in Microsoft Entra-id wanneer uw Azure Boards-account wordt ondersteund door Microsoft Entra ID of Active Directory wanneer uw on-premises serverexemplaren worden ondersteund door Active Directory.

Zie Categorieën gebruiken om werkitemtypen te groeperen voor informatie over categoriegroepen.

Niet in groep

Komt niet overeen met een waarde die lid is van de groep in de component.

Tekenreeks die overeenkomt met de naam van een gebruikersgroep in Team Foundation Server of een categoriegroep die is gedefinieerd voor een project.

Notitie

U kunt de operator Niet in groep alleen gebruiken met velden die het gegevenstype Tekenreeks of het veld Type werkitem gebruiken. U kunt ook groepen gebruiken die zijn gedefinieerd in Microsoft Entra-id wanneer uw Azure Boards-account wordt ondersteund door Microsoft Entra ID of Active Directory wanneer uw on-premises serverexemplaren worden ondersteund door Active Directory.

Niet onder

Komt niet overeen met de waarde in de component en bevindt zich niet onder het knooppunt in de component.

TreePath

Onder

Komt overeen met de waarde in de component of bevindt zich onder het knooppunt in de component.

TreePath

Was ooit

Komt overeen met de waarde in de component op een eerder punt.

Tekenreeks , datum/tijd

Notitie

Was ever op datumvelden wordt momenteel niet ondersteund bij het gebruik van de Power Query-editor. Ze worden alleen ondersteund bij het uitvoeren van een directe WIQL.

Tip

Het is mogelijk om een query samen te stellen met behulp van de WIQL-syntaxis die gebruikmaakt van een operator, zoals Was Ever, voor andere gegevenstypevelden dan de velden die worden vermeld. U kunt bijvoorbeeld Was Ever in een component gebruiken met behulp van het iteratiepad. Zie Bijvoorbeeld Query op datum of huidige iteratie, werkitems weergeven die uit een sprint zijn verplaatst.

Query's uitvoeren op macro's of variabelen

U kunt de macro's die in de volgende tabel worden beschreven, gebruiken om uw query's te filteren op basis van specifieke velden.

Notitie

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

---

Macro

Beschrijving

---

[Any]

Gebruik dit veld met de velden Type werkitem of Status om te zoeken in alle typen werkitems of in alle statussen. Plaatst bijvoorbeeld Work Item Type=[Any] geen filters op basis van het type werkitem.

---

@CurrentIteration

Gebruik dit veld met het veld Iteratiepad om automatisch te filteren op werkitems die zijn toegewezen aan de huidige sprint op basis van de focus of context van het huidige team. Zie Query op datum of huidige iteratie voor specifieke voorbeelden.
De @CurrentIteration macro werkt alleen wanneer deze wordt uitgevoerd vanuit de webportal. U kunt de macro niet gebruiken bij het kopiëren of klonen van testsuites en testcases, het definiëren van waarschuwingen of met REST API's.

---

@CurrentIteration +/- n

Gebruik dit veld met het veld Iteratiepad om de set werkitems te filteren die zijn toegewezen aan de huidige sprint +/- n sprints op basis van de huidige teamfocus of context. Zie Query op datum of huidige iteratie voor specifieke voorbeelden.
De macro @CurrentIteration +/- n wordt ondersteund voor Azure Boards, Azure DevOps Server 2019 en latere versies, en alleen wanneer deze wordt uitgevoerd vanuit de webportal.

---

@Follows

Gebruik dit veld met het id-veld en de operator In om alle werkitems weer te geven die u in het project volgt. Zie Een werkitem of pull-aanvraag volgen voor meer informatie over de functie Volgen. U kunt dezelfde lijst bekijken op de pagina Werkitems, de draaitabelweergave volgen.
De @Follows macro wordt alleen ondersteund wanneer deze wordt uitgevoerd vanuit de webportal.

---

@Me

Gebruik dit veld met een identiteit of gebruikersaccount om automatisch te zoeken naar items die zijn gekoppeld aan uw gebruikersnaam of accountnaam. U kunt bijvoorbeeld werkitems vinden die u met de component Created By=@Mehebt geopend. Zie Query op toewijzings-, werkstroom- of Kanbanbordwijzigingen voor meer voorbeelden.

---

^{@MyRecentActivity 1}

Gebruik dit veld met de id en de operator In om werkitems weer te geven die u in de afgelopen 30 dagen in het project hebt bekeken of bijgewerkt. U kunt dezelfde lijst weergeven op de pagina Werkitems, de draaiweergave Mijn activiteit.

---

@Project

Gebruik dit veld met het veld Teamproject om te filteren op werkitems in andere projecten. U kunt bijvoorbeeld alle werkitems in het geselecteerde project vinden met de component Team Project=@Project. Het systeem wordt automatisch gefilterd op basis van het huidige project. Zie Een query definiëren, Query over projecten voor meer informatie.

---

^{@RecentMentions 1}

Gebruik dit veld met id en in operator om werkitems weer te geven waar u bent vermeld in de sectie Discussie. U kunt dezelfde lijst weergeven op de pagina Werkitems, de draaitabelweergave Vermeld.

---

^{@RecentProjectActivity 1}

Gebruik dit veld met het id-veld en de operator In om werkitems weer te geven die onlangs zijn bijgewerkt. Het aantal weergegeven werkitems is afhankelijk van de activiteit voor het bijhouden van werk van het project. Voor zeer actieve projecten worden werkitems weergegeven die in de afgelopen 30 dagen in het project zijn bijgewerkt. Voor minder actieve projecten kan deze lijst echter werkitems bevatten die ouder zijn dan 30 dagen. U kunt vergelijkbare lijsten weergeven op de pagina Werkitems, Onlangs gemaakt, Onlangs bijgewerkt en Recent voltooide draaiweergaven. Het aantal geretourneerde werkitems is beperkt tot 5000.

---

^{@StartOfDay 2}

Gebruik dit veld om DateTime te filteren op werkitems die betrekking hebben op de huidige datum of met een plus-/min-offset. U kunt bijvoorbeeld alle items vinden die in de afgelopen week zijn gesloten met de component Closed Date>=@StartOfDay-7. Zie Query op datum of huidige iteratie voor meer voorbeelden.

---

^{@StartOfMonth 2}

Gebruik met een DateTime veld om te filteren op werkitems die betrekking hebben op de huidige maand of met een plus-/min-offset. U kunt bijvoorbeeld alle items vinden die in de afgelopen drie maanden zijn gemaakt met de component Created Date>=@StartOfMonth-3. Zie Query op datum of huidige iteratie voor meer voorbeelden.

---

^{@StartOfWeek 2}

Gebruik dit veld om DateTime te filteren op werkitems die betrekking hebben op de huidige week of met een plus-/min-offset. U kunt bijvoorbeeld alle items vinden die in de afgelopen twee weken zijn gewijzigd met de component Changed Date>=@StartOfWeek-2. Zie Query op datum of huidige iteratie voor meer voorbeelden.

---

^{@StartOfYear 2}

Gebruik dit veld om DateTime te filteren op werkitems die betrekking hebben op het huidige jaar of met een plus-/min-offset. U kunt bijvoorbeeld alle functies vinden waarvoor een doeldatum is gepland binnen het huidige jaar met de component Target Date>=@StartOfYear. Zie Query op datum of huidige iteratie voor meer voorbeelden.

---

@TeamAreas

Gebruik dit veld alleen met het veld Gebiedspad om te filteren op werkitems waarvan het gebiedspad overeenkomt met het pad dat is toegewezen aan een specifiek team. Hiervoor moet u de = operator gebruiken. U kunt bijvoorbeeld alle items vinden die zijn toegewezen aan de gebiedspaden die aan het webteam zijn toegewezen met de component Area Path=@TeamAreas [Fabrikam Fiber]\Web. Zie Query op gebied of iteratiepad voor meer voorbeelden.
De @TeamAreas macro wordt ondersteund voor Azure DevOps Server 2019 en latere versies, en alleen wanneer deze wordt uitgevoerd vanuit de webportal.

---

@Today

Gebruik dit veld om DateTime te filteren op werkitems die betrekking hebben op de huidige datum of een eerdere datum. U kunt de @Today macro ook wijzigen door dagen af te trekken. U kunt bijvoorbeeld alle items vinden die in de afgelopen week zijn gemaakt met de component Created Date>=@Today-7. Zie Query op datum of huidige iteratie voor meer voorbeelden.

---

Notitie

1. De macro's @MyRecentActivity, @RecentMentions en @RecentProjectActivity worden ondersteund voor TFS 2018.2 en latere versies.
2. De macro's @StartOfDay, @StartOfWeek, @StartOfMonth en @StartOfYear worden ondersteund voor Azure DevOps Server 2019 Update 1 en latere versies.

Zoekopdrachten in volledige tekst en gedeeltelijke woorden

Geef bevat of bevat niet om te zoeken op exacte of gedeeltelijke overeenkomsten van een woord of woordgroep. Deze operators filteren items op basis van de zoekindex voor volledige tekst die is gemaakt voor velden met lange tekst. Geef woorden op of bevat geen woorden om te zoeken op basis van een exacte woordgroep of om het jokerteken te gebruiken. * Deze operators gebruiken de zoekindex voor volledige tekst. U kunt alleen het jokerteken aan het einde van een gedeeltelijk woord of woordgroep gebruiken.

Zie voorbeeldquery's voor werkitems en Query voor werkitems met behulp van het veld Geschiedenis.

Notitie

Niet alle implementaties ondersteunen zoekopdrachten in volledige tekst. SQL Express en SQL Azure, die ondersteuning bieden voor de cloudservice, bieden bijvoorbeeld geen ondersteuning voor zoeken in volledige tekst. In deze gevallen ziet u alleen de operators Contains en Bevat deze niet.

Verwante artikelen:

• Snelle naslaginformatie voor query's
• Over beheerde query's
• Veldindex werkitem
• Syntaxis voor de werkitemquerytaal (WIQL)

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