Een werkitemquery weergeven, uitvoeren of e-mailen

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

Visual Studio 2019 | Visual Studio 2022

Voer een query uit om werkitems te vinden die aan u of uw team zijn toegewezen. Veel query's voor werkitems zijn vooraf gedefinieerd met uw proces. Leden van uw team hebben mogelijk gedeelde query's gemaakt die u kunt bekijken en uitvoeren. Vaak is het eenvoudiger om een nieuwe query te definiëren door te bouwen op de querydefinitie die al voor u beschikbaar is.

Vereisten

• U moet belanghebbendetoegang hebben om gedeelde query's weer te geven en uit te voeren. Alle projectleden hebben standaard toegang tot belanghebbenden. Zie De machtigingen voor een gedeelde query of map wijzigen voor meer informatie.
• U moet basistoegang of hoger hebben om een gedeelde query toe te voegen en op te slaan.
• U moet de machtiging Bijdragen hebben ingesteld 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

Controleer in uw webbrowser (1) of u het juiste project hebt geselecteerd, (2) kies Bordenquery's >en kies vervolgens (3) Alles.

Als het de eerste keer is dat u query's opent, wordt de pagina geopend met Favorieten. Deze pagina bevat de query's die u hebt aangegeven, zijn een favoriet. Anders kunt u 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 in uw project worden gedeeld.

   

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 wilt volgen. 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.

4. Kies een map in een breadcrumb om een querymap te openen.

   

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 indeling Querytaal voor werkitems. Genegeerd als-id of pad 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 mapgerichte weergave die u kunt filteren om specifieke query's te vinden die interessant zijn. Wanneer u in de pagina's Query's werkt, kunt u naar een submap, map of pagina gaan.

U kunt ook een query kiezen die u hebt geselecteerd in het menu Selector. U kunt er ook voor kiezen om door alle query's te bladeren, waarmee u naar de pagina Alle query's terugkeert.

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 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 wordt herkend door het systeem. Het toevoegen van een teamgroep of beveiligingsgroep aan de regel 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