Een werkitemquery weergeven, uitvoeren of e-mailen

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

Visual Studio 2019 | Visual Studio 2022

Als u werkitems wilt zoeken die aan u of uw team zijn toegewezen, kunt u een query uitvoeren. Uw proces kan verschillende vooraf gedefinieerde query's bevatten die u kunt openen en uitvoeren. Vaak is het eenvoudiger om een nieuwe query te maken door een bestaande querydefinitie te wijzigen.

Notitie

De browserafbeeldingen die in dit artikel worden gebruikt, zijn afkomstig van de nieuwe functie boards hubs, die standaard is ingeschakeld. Als deze functie niet is ingeschakeld, gebruikt u mogelijk de vorige ervaring met borden. Als u de afbeeldingen voor de vorige ervaring wilt weergeven, selecteert u de Azure DevOps Server 2022-versie van dit artikel.

Vereisten

• Toegangsniveaus:
  • Als u gedeelde query's wilt weergeven en uitvoeren, moet u een projectlid zijn.
  • Als u een gedeelde query wilt toevoegen en opslaan, hebt u ten minste basistoegang .
• Machtigingen: stel uw machtiging Bijdragen in op Toestaan voor de map waaraan u een query wilt toevoegen. De groep Inzenders beschikt standaard niet over deze machtiging.

Notitie

Gebruikers met toegang tot belanghebbenden voor een openbaar project hebben volledige toegang tot queryfuncties, net zoals gebruikers met Basistoegang . Voor meer informatie, zie Snelzoekgids toegang als belanghebbende.

Query's openen

Browser

Kies Query's op borden > in uw project en kies Vervolgens Alles.

De pagina Query's wordt geopend op het tabblad Favorieten met de query's die u als favorieten hebt ingesteld. U kunt het tabblad Alles kiezen om alle query's weer te geven die u hebt gedefinieerd en gedeelde query's voor het project.

Tip

Query's die u of uw team hebben gekozen als favorieten worden weergegeven op de pagina Favorieten . Favoriete query's samen met andere objecten worden ook weergegeven op de projectpagina . Zie Persoonlijke favorieten of teamfavorieten instellen voor meer informatie.

Visual Studio

Belangrijk

We raden u ten zeerste aan dat iedereen de standaardweergave gebruikt in plaats van deze verouderde weergave. Het is ontworpen voor u om snel toegang te krijgen tot een lijst met werkitems op basis van uw opdracht, gevolgd, vermeld of recente updates. De verouderde weergave wordt niet meer uitgebreid en we verwachten dat deze in een toekomstige versie van Visual Studio wordt verwijderd.

1. Kies werkitems op de startpagina van TeamVerkenner.

   

2. Als u een query wilt openen, opent u het snelmenu voor de query (klik met de rechtermuisknop op de query) en kiest u Resultaten weergeven. U kunt ook dubbelklikken op de query om deze te openen.

   

Of selecteer een van de volgende opties:

• Query bewerken: hiermee opent u de Power Query-editor voor de geselecteerde query.
• Nieuwe query: hiermee opent u de Power Query-editor met de standaard nieuwe queryopties.
• Openen in Microsoft Excel (plat): hiermee opent u de query in Microsoft Excel.
• Verzenden naar Microsoft Outlook: Openen
• Knippen: Snijdt de query. Vervolgens kunt u de query onder een andere map plakken.
• Kopiëren: Kopieert de query. Vervolgens kunt u de query onder dezelfde map of een andere map plakken.
• Verwijderen: Hiermee verwijdert u de query.
• Naam wijzigen: hiermee kunt u de naam van de query wijzigen.
• Toevoegen aan Mijn favorieten: voegt de query toe aan de sectie Mijn favorieten.
• Toevoegen aan Team favorieten: voegt de query toe aan de sectie Team favorieten.
• Beveiliging: Hiermee opent u het dialoogvenster Machtigingen voor de query.

Een query uitvoeren in Azure Boards

Als u een query wilt uitvoeren, vouwt u een map uit en kiest u de titel van de query. De weergave wordt geopend om de queryresultaten weer te geven.

U kunt ook een query uitvoeren met behulp van de Azure DevOps-opdrachtregelinterface.

Browser

Tip

De pagina Query's , net als bij andere webpagina's, onthoudt de weergave waarnaar u het laatst bent gegaan en retourneert u naar die weergave.

1. Kies Alles om de pagina te openen waar u alle query's kunt bekijken die u hebt gedefinieerd of die worden gedeeld in uw project.

   

2. Kies waar nodig Mijn query's .

   • Als u alle werkitems wilt weergeven die aan u zijn toegewezen, kiest u Toegewezen aan mij. Deze query maakt gebruik van de @Me macro om alle werkitems weer te geven die aan u zijn toegewezen.
   • Als u alle werkitems wilt weergeven die u volgt, kiest u Gevolgde werkitems. Deze query maakt gebruik van de @Follows macro (id om @Follows) alle werkitems weer te geven die u volgt). Zie Een werkitem of pull-aanvraag volgen voor meer informatie.

3. Kies Gedeelde query's om de map uit te vouwen en query's te openen die zijn opgeslagen als gedeelde query's.

Visual Studio

Belangrijk

We raden u ten zeerste aan dat iedereen de standaardweergave gebruikt in plaats van deze verouderde weergave. Het is ontworpen voor u om snel toegang te krijgen tot een lijst met werkitems op basis van uw opdracht, gevolgd, vermeld of recente updates. De verouderde weergave wordt niet meer uitgebreid en we verwachten dat deze in een toekomstige versie van Visual Studio wordt verwijderd.

• Open op de pagina Werkitems van Teamverkenner het contextmenu voor de query (klik met de rechtermuisknop) en kies Resultaten weergeven. U kunt ook dubbelklikken op de query om deze te openen.

  

Een query uitvoeren vanaf de opdrachtregel

U kunt een query uitvoeren in de CLI met de opdracht az boards query . Zie Aan de slag met Azure DevOps CLI om aan de slag te gaan.

az boards query [--id]
                [--org]
                [--path]
                [--project]
                [--wiql] 

Parameters

• id: de id van een bestaande query. Vereist, tenzij pad of wiql is opgegeven.
• wiql: de query in de WIQL-indeling (Work Item Query Language). Genegeerd als --id of --path is opgegeven.
• pad: het pad van een bestaande query. Genegeerd als-id is opgegeven.
• organisatie: URL van Azure DevOps-organisatie. U kunt de standaardorganisatie configureren met behulp van az devops configure -d organization=ORG_URL. Vereist als deze niet is geconfigureerd als standaard of wordt opgehaald met behulp van git config. Voorbeeld: --org https://dev.azure.com/MyOrganizationName/.
• project: naam of id van het project. U kunt het standaardproject configureren met behulp van az devops configure -d project=NAME_OR_ID. Vereist als deze niet is geconfigureerd als standaard of wordt opgehaald met behulp van git config.

Opmerking

Met de volgende opdracht wordt een query uitgevoerd met de opgegeven id en wordt het resultaat in tabelindeling weergegeven.

az boards query --id 6c286d74-26a5-4cce-bfcf-bf9123495bfe  --output table

Priority    Node Name         Work Item Type    Title                             Remaining Work
----------  ----------------  ----------------  --------------------------------  ----------------
1           Voice             Bug               Apply fix elsewhere as needed
2           CMMI              Bug               Slow response on form
1           Fiber             Bug               Check issues with permissions     0
2           Fiber             Bug               Voicemail hang issue              0
2           FabrikamBB        Bug               Research slow response time
1           FabrikamBB        Bug               Fix performance issues            0 

Met de volgende opdracht wordt een query uitgevoerd met de opgegeven WIQL en wordt het resultaat in tabelindeling weergegeven.

az boards query --wiql "SELECT [Microsoft.VSTS.Common.Priority], [System.NodeName], [System.WorkItemType], [System.Title], [Microsoft.VSTS.Scheduling.RemainingWork], [System.AssignedTo], [System.State], [System.Tags], [System.AreaPath] FROM workitems WHERE [System.WorkItemType] = 'Bug' AND [System.AreaPath] = 'Fabrikam Fiber' ORDER BY [System.WorkItemType]" --output table

Priority    Node Name       Work Item Type    Title                  Remaining Work
----------  --------------  ----------------  ----------------       ----------------
2           Fabrikam Fiber  Bug               Slow response on form
2           Fabrikam Fiber  Bug               Check permissions
2           Fabrikam Fiber  Bug               Fix performance issue
2           Fabrikam Fiber  Bug               Secure Sign-in 

Querymap, querymappen en breadcrumbs

Notitie

U kunt geen mappen toevoegen aan Mijn Favorieten of Team favorieten.

Browser

De pagina Query's bevat een favorieten en een tabblad Alles . Elk bevat een mapgerichte weergave die u kunt filteren om specifieke query's te vinden die van belang zijn.

Wanneer u in de pagina's Query's werkt, kunt u naar een map, submap of een querypagina gaan.

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

Visual Studio

Op de pagina Werkitems wordt dezelfde mapstructuur weergegeven als gedefinieerd in de webportal. Wijzigingen die u via Visual Studio aanbrengt, worden doorgevoerd in de webportal.

U kunt mappen uitvouwen en samenvouwen, mappen een andere naam geven en query's van de ene map naar de andere slepen en neerzetten. Zie Query's beheren en organiseren voor meer informatie

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

Alle en ondersteunde taken voor Favorieten

U kunt de meeste taken uitvoeren voor het weergeven en uitvoeren van query's vanaf elk van de lijstpagina's met query's, zoals aangegeven in de volgende tabel. Alleen query's die u opslaat onder Mijn query's en als favoriet worden weergegeven onder Mijn favorieten. Alleen query's die zijn opgeslagen onder Gedeelde query's , kunnen door een team als favoriet worden aangeduid.

Opdracht	Favorieten (Browser)	Alle (Browser)	Werkitems (Team Explorer)
Bekijk alle favoriete query's, uw team of een team waartoe u behoort	✔️		✔️
Al uw query's of gedeelde query's voor het huidige project weergeven		✔️	✔️
Een query uitvoeren, het contextmenu voor een query openen	✔️	✔️	✔️
Containermappen of querymappen uitvouwen of samenvouwen	✔️	✔️	✔️
De lijst met query's filteren	✔️	✔️
Een query aan favorieten toevoegen (kies voor webportal )		✔️
Een query uit favorieten verwijderen (kies voor webportal )	✔️	✔️	✔️
Een nieuwe query toevoegen: Kiezen	✔️	✔️	✔️

De lijst met query's filteren

Voer een trefwoord in het filtervak in om de set query's te filteren die worden weergegeven op de pagina's Favorieten of Alle pagina's. Zie Achterstanden, borden, query's en plannen filteren voor meer informatie over filteren.

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

E-mailquery-items of een query-URL delen

Browser

In de weergave Power Query-editor of Resultaten kunt u een opgemaakte lijst met query-items e-mailen of de query-URL kopiëren.

Kies het pictogram meer acties om het menu te openen en selecteer een van de opties die worden weergegeven, e-mailquery of query-URL kopiëren.

U kunt de e-mail alleen verzenden naar een afzonderlijk adres voor een projectlid dat door het systeem wordt herkend. Het toevoegen van een teamgroep of beveiligingsgroep aan de regel Aan wordt niet ondersteund. Als u een e-mailaccount toevoegt dat het systeem niet herkent, ontvangt u een bericht dat een of meer geadresseerden van uw e-mail geen machtigingen hebben om de gemailde werkitems te lezen.

Notitie

Als u een opgemaakte lijst wilt e-mailen naar personen die geen projectleden zijn, moet u de optie Kopiëren als HTML gebruiken die wordt beschreven in Een lijst met werkitems kopiëren. Voor on-premises Azure DevOps moeten voor alle e-mailacties een SMTP-server worden geconfigureerd. Als u geen SMTP-server hebt geconfigureerd, kunt u dit omzeilen door Kopiëren als HTML te gebruiken.

Visual Studio

U kunt een opgemaakte querylijst e-mailen door de optie Verzenden naar Microsoft Outlook te kiezen in het contextmenu.

Notitie

Voor deze functie moet Microsoft Outlook zijn geïnstalleerd. Voor on-premises Azure DevOps moeten voor alle e-mailacties een SMTP-server worden geconfigureerd. Als u geen SMTP-server hebt geconfigureerd, kunt u dit omzeilen met behulp van Kopiëren als HTML vanuit de webportal.

Volgende stappen

Een query definiëren

Verwante artikelen:

• Query's en querymappen beheren
• Achterstanden, borden, query's en plannen interactief filteren
• Kolomopties wijzigen
• Persoonlijke favorieten of teamfavorieten instellen
• Sneltoetsen