Afficher, exécuter ou envoyer par e-mail une requête d’élément de travail

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022 | Azure DevOps Server 2020

Visual Studio 2022

Cet article explique comment accéder aux éléments de travail Azure Boards et interagir avec eux en exécutant et en partageant des requêtes. Vous pouvez afficher et exécuter des requêtes intégrées ou partagées pour identifier les éléments de travail affectés à vous ou qui répondent à d’autres critères.

Prerequisites

• Un projet Azure DevOps qui a des éléments de travail qui vous sont attribués ou suivis par vous, ou des requêtes définies par vous ou partagées avec vous. Pour définir une requête, consultez Définir une requête d’élément de travail.

Catégorie	Exigences
Niveaux d’accès	- Pour afficher et exécuter des requêtes partagées : membre du projet. - Pour ajouter et enregistrer une requête partagée : au moins un accès de base.
Permissions	Autorisation Contribuer définie sur Autoriser pour le dossier auquel vous souhaitez ajouter une requête. Cette autorisation n’est pas définie par défaut pour le groupe Contributeurs.

Notes

Les utilisateurs disposant d’un accès Partie prenante pour un projet public ont un accès complet aux fonctionnalités de requête, tout comme les utilisateurs disposant d’un accès De base. Pour plus d’informations, consultez Référence rapide sur l’accès de partie prenante.

Ouvrir la page Requêtes

Pour ouvrir la page Requêtes de votre projet, sélectionnez TableauxRequêtes. La page Requêtes s’ouvre sur l’onglet Favoris , affichant les requêtes que vous ou votre équipe avez choisies en tant que favoris. Pour plus d'informations, voir Définir des favoris personnels ou d'équipe.

L’onglet Favoris affiche également les dernières requêtes que vous avez ouvertes sous Continuer là où vous vous êtes arrêté.

Pour afficher toutes les requêtes personnelles et partagées dans votre projet, sélectionnez l’onglet Tous dans la page Requêtes . L’onglet Tous affiche les requêtes intégrées, les requêtes que vous avez définies et les requêtes partagées dans votre projet. Ouvrez Mes Requêtes, Requêtes Partagées, et les autres dossiers pour accéder à leurs requêtes.

Sous l’onglet Toutes les requêtes de la page Requêtes , le dossier Mes requêtes contient les requêtes intégrées suivantes en plus des requêtes que vous définissez :

• Affecté à moi utilise la @Me macro pour répertorier tous les éléments de travail affectés à vous dans le projet actuel.
• Les éléments de travail suivis utilisent la macro @Follows , ID dans @Follows, pour répertorier tous les éléments de travail que vous suivez. Pour plus d’informations, consultez Suivre un élément de travail ou une demande de tirage ( pull request).

Toutes les tâches prises en charge par les onglets "Tous" et "Favoris"

Vous pouvez effectuer la plupart des tâches pour afficher et exécuter des requêtes à partir de l’onglet Tous ou Favoris de la page Requêtes , comme indiqué dans le tableau suivant.

Tâche	Favoris	Tous
Répertorier toutes les requêtes favorites, les vôtres ou celles d'une équipe à laquelle vous appartenez.	✔️
Répertorier toutes vos requêtes ou requêtes partagées pour le projet actuel		✔️
Ajouter une requête aux favoris		✔️
Retirer des favoris une requête	✔️	✔️
Filtrer la liste de requêtes	✔️	✔️
Développer ou réduire les dossiers	✔️	✔️
Exécuter une requête ou ouvrir le menu contextuel d’une requête	✔️	✔️

Seules les requêtes et requêtes intégrées que vous enregistrez sous Mes requêtes apparaissent sous Mes requêtes. Seules les requêtes que vous favoris apparaissent dans Mes favoris. Seules les requêtes enregistrées sous Requêtes partagées peuvent être ajoutées aux favoris par une équipe.

Filtrer la liste de requêtes

Entrez un mot clé dans la zone de filtre de la page Favoris ou Tous lesonglets de la page Requêtes pour filtrer les requêtes affichées. Pour plus d’informations, consultez Filtrer de manière interactive vos backlogs, tableaux, requêtes et plans.

Accéder aux requêtes et aux dossiers

Dans l’onglet Favoris ou Tous les onglets de la page Requêtes, vous pouvez accéder à la recherche et à l’ouverture de requêtes spécifiques.

Sous l’onglet Tout , les pages de requête peuvent apparaître directement ou se trouver dans des dossiers ou sous-dossiers. Vous pouvez naviguer vers un dossier, un sous-dossier ou une page de requête.

Lorsque vous effectuez des sélections et ouvrez des dossiers, les barres de navigation sont affichées en haut de la page.

Vous pouvez sélectionner un dossier dans la barre de navigation pour ouvrir le dossier.

Vous pouvez également ouvrir une requête favorite ou revenir à la page Toutes les requêtes à partir du menu déroulant d’une requête ouverte.

Exécuter une requête

Pour exécuter une requête à partir des favoris ou de tous lesonglets de la page Requêtes, développez son dossier si nécessaire et sélectionnez la requête. La page Résultats de la requête s’ouvre.

Vous pouvez également sélectionner l’icône Autres actions en regard de la requête dans la page Requêtes , puis sélectionner Exécuter la requête ou d’autres options dans le menu contextuel.

Exécuter une requête à partir d’Azure DevOps CLI

Vous pouvez exécuter une requête Azure Boards à l’aide de la commande de requête az boards dans l’interface de ligne de commande Azure DevOps. Pour commencer, consultez Démarrage avec l’interface CLI Azure DevOps.

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

Parameters

• id: ID d’une requête existante. Obligatoire, sauf si --path ou --wiql est spécifié.
• wiql: requête au format WIQL (Work Item Query Language). Ignorée si --id ou --path est spécifiée.
• path: chemin d’accès d’une requête existante. Ignoré si --id est spécifié.
• org: URL de l’organisation Azure DevOps, par exemple --org https://dev.azure.com/MyOrganizationName/. Obligatoire, sauf si elle est définie comme valeur par défaut ou récupérée à l’aide de git config. Configurez l'organisation par défaut à l'aide de az devops configure -d organization=ORG_URL.
• project: Nom ou ID du projet. Obligatoire en l’absence d’une configuration par défaut ou d’une récupération à l’aide de git config. Configurez le projet par défaut en utilisant az devops configure -d project=NAME_OR_ID.

Examples

La commande suivante exécute une requête conformément à l’identifiant spécifié et affiche le résultat sous forme de tableau.

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

La commande suivante exécute une requête WIQL et affiche le résultat au format de tableau.

az boards query --wiql "SELECT [Microsoft.VSTS.Common.Priority], [System.NodeName], [System.WorkItemType], [System.Title], [Microsoft.VSTS.Scheduling.RemainingWork] 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

Envoyer un e-mail ou partager une requête

À partir de l’éditeur de requête ou de la vue Résultats , vous pouvez envoyer une liste mise en forme d’éléments de requête aux membres du projet ou copier l’URL de requête à partager.

Sélectionnez l’icône Autres actions en haut à droite, puis sélectionnez Requête par e-mail ou URL de copie de requête dans le menu contextuel.

Vous ne pouvez envoyer un e-mail qu’à des membres de projet individuels que le système reconnaît. L’envoi à un groupe d’équipe ou à un groupe de sécurité n’est pas pris en charge. Les destinataires doivent disposer des autorisations nécessaires pour lire les éléments de travail envoyés par courrier électronique.

L’e-mail envoie par le biais de votre client de messagerie par défaut et inclut un lien vers la requête qui retourne uniquement les éléments de travail répertoriés. Si vous souhaitez obtenir plus d’informations, consultez Copier ou cloner des éléments de travail.

Notes

Pour envoyer une liste mise en forme aux personnes qui ne sont pas membres du projet, consultez Copier ou envoyer par e-mail une liste d’éléments de travail.

Afficher les éléments de travail dans Visual Studio

Dans la page Éléments de travail de Visual Studio Team Explorer, vous pouvez répertorier les éléments de travail pour les projets connectés. La création et la gestion des requêtes doivent être effectuées dans l’interface web Azure Boards.

Dans le volet Recherche d’éléments de travail, vous pouvez appliquer des filtres pour afficher les éléments de travail répertoriés par Affecté à, Créé par, État ou Type d’élément de travail.

Vous pouvez développer la liste Éléments de travail et sélectionner la flèche déroulante à côté de l'affichage actuel pour choisir parmi les vues intégrées Affectés à moi, Suivants, Mentionnés ou Mon activité.

Pour les éléments de travail individuels répertoriés, vous pouvez :

• Pointez sur l’élément de travail pour afficher les informations.
• Sélectionnez un titre d’élément de travail pour renommer l’élément de travail.
• Cliquez avec le bouton droit sur l’élément de travail pour l’affecter à vous-même ou pour terminer l’élément de travail.
• Double-cliquez sur l’élément ou cliquez avec le bouton droit, puis sélectionnez Ouvrir pour ouvrir l’élément de travail dans l’interface utilisateur d’Azure Boards.

Vous pouvez également créer des éléments de travail en sélectionnant Nouvel élément de travail et en entrant un titre d’élément de travail. Les modifications que vous apportez via Visual Studio sont reflétées dans Azure Boards.

Étape suivante

Définir une requête d'élément de travail

Contenu connexe

• Gérer les requêtes et dossiers de requêtes
• Filtrer de manière interactive les backlogs, les tableaux, les requêtes et les plans
• Questions fréquentes (FAQ) sur les requêtes dans Azure Boards