Query's uitvoeren op titels, id's en velden met tekst met opmaak in Azure Boards en Azure DevOps
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 InIn 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
- De
Is EmptyenIs Not Emptyoperators worden ondersteund voor Azure DevOps Server 2019 RC2 en latere versies - 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.
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.
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.
Niet-gedefinieerde veldwaardequery's
U kunt werkitems met een niet-gedefinieerde veldwaarde vinden met behulp van de operator equals (=) 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.
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 waar geen beschrijving is ingevoerd. 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 weergegeven waarin sommige vermeldingen zijn opgenomen in het veld Beschrijving .
Notitie
De mogelijkheid om te zoeken naar werkitems waaraan geen tags zijn gekoppeld, is geen ondersteunde functie. Als u wilt stemmen op de aanvraag om deze functie te ondersteunen, kunt u dit doen 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 foutcategorie.
Welke items worden weergegeven in de categorieën Vereiste of Taak?
De standaardtoewijzingen van werkitemtypen voor elke categorie worden hieronder 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 .
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.
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 door het systeem toegewezen 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 de volledige impact van het probleem kunnen begrijpen en of ze de fout hebben opgelost. Dit omvat acties die worden ondernomen om de bug en het verwachte gedrag te vinden of te reproduceren.
Verwijzingsnaam=Microsoft.VSTS.TCM.ReproSteps, gegevenstype=HTML
Fout
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).
Verwante artikelen:
REST-API
Als u programmatisch wilt communiceren met query's, raadpleegt u een van deze REST API-resources:
Feedback
Binnenkort beschikbaar: In de loop van 2024 zullen we GitHub-problemen geleidelijk uitfaseren als het feedbackmechanisme voor inhoud en deze vervangen door een nieuw feedbacksysteem. Zie voor meer informatie: https://aka.ms/ContentUserFeedback.
Feedback verzenden en weergeven voor