Delen via

Query's uitvoeren op titels, id's en velden met tekst met opmaak in Azure Boards en Azure DevOps

  • Artikel

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

Als u werkitems wilt zoeken op basis van een trefwoord of woordgroep of een null-tekstveld, kunt u dit doen door te filteren op velden met één regel (tekenreeks), tekst met meerdere regels (Tekst zonder opmaak) en HTML-velden (Rich Text). Als het te lang duurt voordat uw query's resultaten retourneren, raadpleegt u Een query/best practices maken.

Ondersteunde operators en macro's

Queryclausules die een tekst- of rtf-tekstveld opgeven, kunnen de operatoren en macro's gebruiken die in de volgende tabel worden vermeld.

Gegevenstype

Ondersteunde operators en macro's

Rtf-tekst (HTML)
Tekenreeksen met meerdere regels (PlainText)

Contains Words, 1, 1, Is Not Empty1Does Not Contain WordsIs Empty

Eén tekst (tekenreeks)

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], Contains, Does Not Contain, In, Not In, In Group, Not In Group, Was EverMacro's: , geldig met het veld Type werkitem en @Project2, geldig met het veld Teamproject[Any].

Id

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], In, Not In, Was EverMacro's: @Follows, @MyRecentActivity, @RecentMentionsgeldig @RecentProjectActivity met het id-veld en Not In In operatoren@Project 2, geldig met het veld Teamproject.

Velden Status- en werkitemtype

= , <> , > , < , >= , <= , =[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field], Bevat, geen in de groep die niet, , , in de groep, , voorkomt, is nooit **Macros**: [any]' geldig met beide velden.

Notitie

  1. De Is Empty en Is Not Empty operators worden ondersteund voor Azure DevOps Server 2019 RC2 en latere versies
  2. Het systeem wordt automatisch gefilterd op basis van het huidige project. Zie Query's in verschillende projecten voor meer informatie.

Gebruiken Contains words voor tekenreeksovereenkomsten

Als u wilt filteren op een tekenreeksovereenkomst, gebruikt u de Contains Words operator in plaats van Contains. De Contains Words operator voert een zoekopdracht in volledige tekst uit op het opgegeven veld, wat in de meeste gevallen sneller is. Tekenreeks is beperkt tot 100 tekens.

Terwijl de Contains operator een tabelscan uitvoert, wat niet alleen langzamer is, maar ook meer CPU-cycli verbruikt. Deze CPU-cycli dragen bij aan de limiet voor het verbruiken van resources.

Notitie

De Contains Words operator maakt gebruik van de zoekindexering voor volledige tekst van SQL. Wanneer een nieuwe waarde wordt opgeslagen in een veld met lange tekst, doet SQL Server het volgende:

  • De woordgroep splitsen in afzonderlijke woorden
  • Verwijder veelgebruikte woorden die geen waarde toevoegen aan een zoekopdracht (zoals 'a' of 'is' in het Engels)
  • Converteer woorden naar hun gemeenschappelijke stam (bijvoorbeeld lopen, uitvoeren en hardlopers worden omgezet in 'run', omdat ze allemaal variaties op dat woord zijn)
  • Sla deze unieke trefwoorden op in een index.

Wanneer een gebruiker vervolgens een query uitvoert op dit veld met behulp van de Contains Words operator, wordt de zoekopdracht uitgevoerd op de unieke trefwoorden die zijn opgeslagen in de index. Voor velden met lange tekst is zoeken veel efficiënter en sneller dan bij het uitvoeren van een subtekenreeks. Standaard definieert SQL een 'woord' als een set tekens tussen interpunctie. Perioden geven bijvoorbeeld het einde van een woord aan, maar de periode wordt niet beschouwd als onderdeel van het woord. Omdat de zoekindex voor volledige tekst trefwoorden bevat in plaats van exacte woordgroepen, krijgt u uiteindelijk alle resultaten die dezelfde trefwoorden bevatten, zoals bepaald door de indexering.

Trefwoord- of woordgroepquery met jokertekens

Gebruik Bevat of Bevat woorden om items weer te geven die gedeeltelijk of exact overeenkomen met de woorden of woordgroepen die u invoert.

Editor voor query met platte lijsten voor het filteren van sleutelwoorden.

Kies Bevat of Bevat niet om te zoeken op exacte of gedeeltelijke overeenkomsten van een woord of woordgroep. Kies Bevat woorden 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.

Geef bijvoorbeeld Woorden en informatie* op om te filteren op een tekstveld dat informatie of informatie bevat.

Gebruik jokerteken met Bevat woorden.

Tip

Als u wilt weten hoe AND/OR componenten worden gegroepeerd, raadpleegt u Beheerde query's maken en opslaan, groepsclausules. Als u de WIQL-syntaxis voor een query wilt weergeven, installeert u de EXTENSIE van de WIQL-queryeditor waarmee u de WIQL-versie van een query-editorvermelding kunt zien.

Query's uitvoeren op specifieke woorden en niet op andere woorden

Gebruik Bevat woorden en bevat geen woordenoperators om items weer te geven die exact overeenkomen met de woorden of woordgroepen die u invoert en andere woorden of woordgroepen uitsluiten. U kunt deze operatoren gebruiken in combinatie met het jokerteken (*).

In het volgende voorbeeld filteren deze operators werkitems voor items die de werkfase bevatten, maar niet het woord Phasor.

Schermopname van Power Query-editor om exacte woorden op te nemen en uit te sluiten.

Niet-gedefinieerde veldwaardequery's

U kunt werkitems met een niet-gedefinieerde veldwaarde vinden met behulp van de operator = Is gelijk aan en de waarde voor het veld leeg laten. Met de volgende filters worden bijvoorbeeld alle werkitems van het type Taak weergegeven waarvan het veld Activiteit leeg is.

Filteren op basis van lege vermeldingen

Als u werkitems wilt weergeven op basis van een veld dat niet leeg is, gebruikt u de operator <> not en laat u de waarde leeg.

Lege of geen lege HTML-veldquery's

U kunt werkitems vinden met lege beschrijvingen. Het gebruik van is leeg of niet leeg met een HTML-veld ondersteunt het weergeven van werkitems met lege of niet lege velden met tekst met opmaak. U geeft geen waarde op met deze operator.

Met de volgende queryfilters worden bijvoorbeeld alle werkitems met een aantal beschrijvingsvelditems weergegeven.

Niet-lege HTML-velden filteren

Filteren op speciale tekens

Als u wilt filteren op een URL of een woordgroep met speciale tekens, zoals / of -, gebruikt u een backslash om deze tekens te escapen. In de volgende voorbeelden ziet u hoe u filtert op een URL en voor een woordgroep met een streepje:

  • Filter op een URL: Zoek naar een werkitemtitel die de woordgroep https://example.com/path-to-resourcebevat.

    • Vraag: Title ~ "https:\/\/example.com\/path-to-resource"
    • Resultaten: retourneert alle werkitems met de exacte URL in het opgegeven veld.

  • Filter op een woordgroep met een streepje: Zoek naar een titel van een werkitem die de tekst bevat "your-phrase-with-dash".

    • Vraag: Title ~ "feature-update\-2023"
    • Resultaten: retourneert alle werkitems die de exacte woordgroep bevatten met streepjes in het opgegeven veld.

Notitie

U kunt geen query's uitvoeren op werkitems waaraan geen tags zijn gekoppeld. Als u wilt stemmen op deze functieaanvraag, doet u dit op onze pagina ontwikkelaarscommunity, kunt u zoeken naar lege tags.

Query's op basis van categorieën

Als u werkitems wilt filteren op basis van de categorie waartoe ze behoren, gebruikt u de operator In-groep . Met de volgende filtercriteria worden bijvoorbeeld alle werkitems geretourneerd die zich in het huidige project bevinden, die zijn toegewezen aan het teamlid en zijn gedefinieerd als behorend tot de bugcategorie.

Querycomponent voor het zoeken van werkitems op categorie

Welke items worden weergegeven in de categorieën Vereiste of Taak?

De standaardtoewijzingen van werkitemtypen voor elke categorie worden als volgt weergegeven voor elk proces.

Proces Vereistecategorie Taakcategorie
Basis Probleem Opdracht
Flexibel Gebruikersverhaal Opdracht
Scrum Productachterstanditem, bug Opdracht
CMMI Vereiste Opdracht

Elk team kan bepalen of het werkitemtype Bug wordt weergegeven in de categorie Vereiste of Taak. Zie Fouten weergeven in achterstanden en borden. U kunt aangepaste typen werkitems toevoegen aan een achterstand. Zie Een werkitemtype toevoegen of wijzigen voor meer informatie, een aangepast WIT toevoegen aan een achterstand of bord.

Query's uitvoeren op werkitems die u volgt

U kunt de @Follows macro gebruiken om een lijst te filteren op basis van werkitems die u volgt, samen met andere queryfilters.

In de volgende query ziet u bijvoorbeeld hoe u query's kunt uitvoeren op alle projecten voor actieve werkitems die u volgt. U gebruikt het veld Id en de Operator In met de macro @Follows .

Power Query-editor met id in @Follows querycomponent

Query uitvoeren op recente activiteit van werkitems

U kunt de volgende macro's gebruiken om werkitems weer te geven op basis van recente activiteit:

  • @MyRecentActivity: Lijstitems die u onlangs hebt bekeken of gewijzigd.
  • @RecentMentions: Lijstitems waaraan u bent toegevoegd via een @mention in de afgelopen 30 dagen.
  • @RecentProjectActivity: Lijstitems die onlangs zijn gemaakt of gewijzigd in uw project.

Geef het id-veld en de operators In of Niet in op.

In de volgende query ziet u bijvoorbeeld hoe u een query kunt uitvoeren op werkitems die u onlangs hebt bekeken of gewijzigd.

Power Query-editor met id in @MyRecentActivity querycomponent

Algemene velden voor de meeste typen werkitems

In de volgende tabel worden algemene velden beschreven die worden gebruikt om query's te filteren. De id-velden identificeren werkitems in een lijst op unieke wijze. Gebruik het veld Titel om het werkitem te onderscheiden van alle andere typen. De velden Beschrijving en andere tekst met opmaak (gegevenstype=HTML) bieden aanvullende informatie die nodig is om werk te implementeren en wijzigingen bij te houden. Nadat een werkitem is gemaakt, kunt u alle velden wijzigen, met uitzondering van de id. Wanneer u een werkitem toevoegt en opslaat, wordt de id toegewezen door het systeem en kan deze niet worden gewijzigd.

Notitie

Het systeem indexeert automatisch alle lange-tekstvelden met een gegevenstype PlainText - en HTML-velden voor zoeken in volledige tekst. Dit omvat de velden Titel, Beschrijving en Stappen voor het opnieuwpropro-veld . Zie Queryvelden, operators, waarden en variabelen : zoekopdrachten in volledige tekst en gedeeltelijke woorden voor meer informatie en vereisten voor servers en sorteringen die van toepassing zijn op on-premises Azure DevOps.

Veldnaam

Beschrijving

Type werkitem

Acceptatiecriteria 1

Een beschrijving van de criteria waaraan moet worden voldaan voordat het fout- of productachterstanditem kan worden gesloten.

Voordat het werk begint aan een fout- of productachterstandsitem, moeten de criteria voor klantacceptatie zo duidelijk mogelijk worden beschreven. Gesprekken tussen het team en klanten om de acceptatiecriteria te definiëren, zorgen ervoor dat uw team de verwachtingen van uw klanten begrijpt. De acceptatiecriteria kunnen worden gebruikt als basis voor acceptatietests, zodat u effectiever kunt evalueren of een item naar tevredenheid is voltooid.

Referentienaam=Microsoft.VSTS.Common.AcceptanceCriteria, Gegevenstype=HTML

Bug, Epic, Feature, Product backlog item (Scrum)

Beschrijving 1, 2

Gebruik dit veld voor uitgebreide informatie over een werkitem.

Verwijzingsnaam=System.Description, gegevenstype=HTML

Alle

Id

De unieke id die is toegewezen aan een werkitem. Id's van werkitems zijn uniek voor alle projecten en binnen een projectverzameling.

Verwijzingsnaam=System.Id, gegevenstype=Geheel getal

Alle

Stappen voor opnieuwpropro (of stappen om te reproduceren) 1

De stappen die nodig zijn om onverwacht gedrag te reproduceren. Leg voldoende informatie vast zodat andere teamleden het volledige effect van het probleem kunnen begrijpen en of ze de fout hebben opgelost. Deze vermelding bevat acties die worden ondernomen om de bug en het verwachte gedrag te vinden of te reproduceren.
Verwijzingsnaam=Microsoft.VSTS.TCM.ReproSteps, gegevenstype=HTML

Bug

Oplossing

Hierin wordt beschreven hoe een belemmering is opgelost.

Referentienaam=Microsoft.VSTS.Common.Resolution, gegevenstype=HTML

Impediment (Scrum)

Systeemgegevens1

Informatie over de software- en systeemconfiguratie die relevant is voor de fout, codebeoordeling of feedback.

Referentienaam=Microsoft.VSTS.TCM.SystemInfo, gegevenstype=HTML

Bug, Code Review Request, Feedback Request

Projectteam

Het project waartoe een werkitem behoort. Voeg dit veld toe aan een query wanneer u de lijst wilt filteren op items in een of meer projecten. Zie Voorbeeldquery's, query's uitvoeren in projecten voor meer informatie.

Verwijzingsnaam=System.TeamProject, gegevenstype=Tekenreeks

Alle

Titel

Een korte beschrijving waarin wordt samengevat wat het werkitem is en waarmee teamleden het kunnen onderscheiden van andere werkitems in een lijst.

Verwijzingsnaam=System.Title, gegevenstype=Tekenreeks

Alle

Type werkitem

De naam van het type werkitem. Typen werkitems worden gedefinieerd op basis van het proces dat wordt gebruikt bij het maken van uw project. Zie Voor meer informatie over processen en processjablonen en het toevoegen of wijzigen van een werkitemtype.

Als u werkitems wilt filteren op basis van hun categorietoewijzing, kunt u de operators In groep en Niet in groep gebruiken en een categorie selecteren in de vervolgkeuzelijst.

Verwijzingsnaam=System.WorkItemType, gegevenstype=Tekenreeks

Alle

Notitie

Na de upgrade naar Team Foundation Server 2012 is het veld Beschrijving gewijzigd van een veldtype PlainText in HTML. Met de opdracht witadmin changefield kunt u het gegevenstype voor dit veld herstellen. Zie Werkitemvelden beheren (witadmin).

REST-API

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