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
- Toegangsniveaus:
- Zorg dat belanghebbenden toegang 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.
- Basistoegang of hoger hebben om een gedeelde query toe te voegen en op te slaan.
- 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.
- Toegangsniveaus: standaard kunnen alle projectleden en gebruikers met toegang tot belanghebbenden alle gedeelde query's bekijken en uitvoeren. U kunt de machtigingen die zijn ingesteld voor een gedeelde querymap of gedeelde query wijzigen. Zie Querymachtigingen instellen voor meer informatie.
- Machtigingen: Als u een query wilt toevoegen en opslaan onder Gedeelde query's, moet u basistoegang of hoger krijgen. U moet ook de machtiging Bijdragen hebben ingesteld op Toestaan voor de map waaraan u de query wilt toevoegen. De groep Inzenders beschikt standaard niet over deze machtiging.
Query's openen
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.
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.
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.
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.
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.
Kies Gedeelde query's om de map uit te vouwen en query's te openen die zijn opgeslagen als gedeelde query's.
Kies een map in een breadcrumb om een querymap 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 vangit 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 vangit 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.
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.
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
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.