Partage via


Gérer et organiser des requêtes dans Azure Boards et Azure DevOps

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

Visual Studio 2019 | Visual Studio 2022

Organisez vos requêtes personnelles ou partagées en ajoutant un dossier de requête. Vous pouvez ensuite ajouter ou déplacer des requêtes existantes dans ces dossiers. Vous pouvez créer des requêtes et des dossiers de requête à partir du portail web ou d’un client pris en charge, comme Visual Studio Team Explorer.

Notes

Pour créer et gérer des requêtes dans Visual Studio 2019, vous devez Définir l’expérience d’éléments de travail sur l’option héritée. En outre, vous pouvez effectuer un glisser-déplacer en bloc des requêtes vers des dossiers de requêtes à partir de Visual Studio, mais pas à partir du portail web.

Remarque

Les images du navigateur utilisées dans cet article proviennent de la nouvelle fonctionnalité New Boards Hubs, activée par défaut. Si cette fonctionnalité n’est pas activée, vous utilisez peut-être l’expérience précédente des tableaux. Pour afficher les images de l’expérience précédente, sélectionnez la version Azure DevOps Server 2022 de cet article.

Prérequis

  • Niveaux d’accès :
    • Pour afficher et exécuter des requêtes partagées, soyez membre du projet.
    • Pour ajouter et enregistrer une requête partagée, disposez au moins d’un accès de base .
  • Autorisations : Avoir l’autorisation Contributeur 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.

  • Niveaux d’accès :
    • Pour afficher et exécuter des requêtes partagées, soyez membre du projet.
    • Pour ajouter et enregistrer une requête partagée, disposez au moins d’un accès de base .
  • Autorisations : définissez votre autorisation Contribution sur Autoriser pour le dossier auquel vous souhaitez ajouter la requête. Cette autorisation n’est pas définie par défaut pour le groupe Contributeurs.

Ouvrir une requête

Depuis votre navigateur web, (1) vérifiez que vous avez sélectionné le bon projet, (2) choisissez Tableaux > Requêtes, puis (3) choisissez Tous.

Capture d’écran de la page des requêtes.

La page Requêtes s’ouvre sur l’onglet Favoris qui répertorie les requêtes que vous avez définies comme favoris. Vous pouvez choisir l’onglet Tous pour afficher toutes les requêtes que vous avez définies et les requêtes partagées pour le projet.

Conseil

Les requêtes que vous ou votre équipe a ajoutées aux favoris s’affichent sur la page Favoris. Les requêtes favorites, ainsi que d’autres objets, s’affichent également sur votre page Projet. Pour plus d'informations, voir Définir des favoris personnels ou d'équipe.

Depuis votre projet, choisissez Tableaux > Requêtes, puis choisissez Tous.

Capture d’écran de la page des requêtes.

La page Requêtes s’ouvre sur l’onglet Favoris qui répertorie les requêtes que vous avez définies comme favoris. Vous pouvez choisir l’onglet Tous pour afficher toutes les requêtes que vous avez définies et les requêtes partagées pour le projet.

Conseil

Les requêtes que vous ou votre équipe a ajoutées aux favoris s’affichent sur la page Favoris. Les requêtes favorites, ainsi que d’autres objets, s’affichent également sur votre page Projet. Pour plus d'informations, voir Définir des favoris personnels ou d'équipe.

Exécuter, modifier et enregistrer une requête

La façon la plus facile de définir une requête consiste à utiliser une requête partagée existante. L’exemple suivant montre comment rechercher l’ensemble des bogues fermés en modifiant la requête partagée Bogues actifs fournie par le modèle de processus Agile. Les exemples sont basés sur l’interface utilisateur fournie via le portail web.

  1. Ouvrez une requête partagée. Dans le portail web, ouvrez par exemple la requête Bogues actifs ou une requête de liste plate similaire.

    Capture d’écran de la sélection de requête.

    Conseil

    Si vous utilisez Visual Studio Team Explorer, ouvrez la page Travail pour accéder à vos requêtes et requêtes partagées. Si Team Explorer n’est pas visible, choisissez Afficher>Team Explorer dans le menu de niveau supérieur.

  2. Modifiez la requête pour rechercher des bogues fermés puis exécutez la requête. Utilisez Insérer une nouvelle ligne de filtre pour insérer une clause au-dessus de la clause actuelle. Utilisez Supprimer cette ligne de filtre pour supprimer une clause. Les requêtes sont automatiquement limitées au projet actuel. Pour rechercher des éléments de travail définis dans plusieurs projets, consultez Requête sur plusieurs projets.

    Capture d’écran de l’éditeur de requête.

  3. Enregistrez la requête dans votre dossier Mes requêtes.

    Capture d’écran de la boîte de dialogue

    Pour enregistrer une requête dans le dossier Requêtes partagées, vous devez faire partie du groupe Administrateurs du projet ou vos autorisations Collaboration doivent être définies sur Autoriser pour ce dossier. Pour plus d'informations, consultez Définir les autorisations de requête.

  1. Ouvrez une requête partagée. Dans le portail web, ouvrez par exemple la requête Bogues actifs ou une requête de liste plate similaire.

    Capture d’écran de la liste de sélection de requêtes.

    Conseil

    Si vous utilisez Visual Studio Team Explorer, ouvrez la page Travail pour accéder à vos requêtes et requêtes partagées. Si Team Explorer n’est pas visible, choisissez Afficher > Team Explorer dans le menu de niveau supérieur.

  2. Modifiez la requête pour rechercher des bogues fermés puis exécutez la requête. Utilisez Insérer une nouvelle ligne de filtre pour insérer une clause au-dessus de la clause actuelle. Utilisez Supprimer cette ligne de filtre pour supprimer une clause. Les requêtes sont automatiquement limitées au projet actuel. Pour rechercher des éléments de travail définis dans plusieurs projets, consultez Requête sur plusieurs projets.

    Capture d’écran de la boîte de dialogue de modification de la requête.

  3. Sélectionnez Enregistrer sous dans le menu Autres actions « plus d’actions ».

    Remarque

    Lorsque la fonctionnalité New Boards Hubs n’est pas activée, l’option Enregistrer sous se trouve en haut de la page.

  4. Enregistrez la requête dans votre dossier Mes requêtes.

    Capture d’écran de la boîte de dialogue

    Pour enregistrer une requête dans le dossier Requêtes partagées, vous devez faire partie du groupe Administrateurs du projet ou vos autorisations Collaboration doivent être définies sur Autoriser pour ce dossier. Pour plus d'informations, consultez Définir les autorisations de requête.

Renommer ou supprimer une requête

Dans la page Favoris ou Tous, choisissez l’icône d’actions d’une requête pour exécuter, modifier, renommer ou supprimer la requête.

Capture d’écran de la nouvelle expérience de requête, page des favoris, menu contextuel de la requête.

Capture d’écran du menu contextuel de la requête.

Pour les requêtes partagées, vous pouvez également choisir d’effectuer l’une des tâches suivantes :

  • Ajouter aux requêtes d’équipe : sélectionner l’équipe à laquelle ajouter la requête en tant que favori d’équipe
  • Sécurité... : définir des autorisations pour la requête. Pour plus d'informations, consultez Définir les autorisations de requête.
  • Ajouter au tableau de bord : ajoute un widget de vignette de requête au tableau de bord de l’équipe sélectionnée. Pour plus d'informations, consultez Ajouter des widgets à un tableau de bord.

Ajouter un dossier de requête et déplacer des éléments dans un dossier

Conseil

Vous avez besoin d’autorisations Supprimer pour renommer ou déplacer une requête ou un dossier partagé et des autorisations Contribuer pour le dossier vers lequel vous déplacez la requête. Pour afficher ou définir des autorisations, consultez Définir des autorisations sur les requêtes et les dossiers de requête.

Vous ajoutez des dossiers de requêtes à partir de la page Tableaux > Requêtes > Tous.

  1. Choisissez Tout. Développez Mes requêtes ou Requêtes partagées en fonction de l’emplacement où vous souhaitez ajouter un dossier de requête.

  2. Pour ajouter un dossier, choisissez l’icône d’actions pour un dossier existant ou pour le dossier conteneur principal, puis choisissez Nouveau dossier.

    Capture d’écran du menu Ouvrir les actions, choisissez Nouveau dossier.

  3. Entrez le nom du dossier dans la boîte de dialogue Nouveau dossier. Si vous souhaitez modifier l’emplacement du dossier, sélectionnez-le dans le menu déroulant Dossier.

    Capture d’écran de la boîte de dialogue du nouveau dossier.

  4. Pour déplacer des éléments dans un dossier, faites glisser-déplacer une requête dans le dossier. Dans le portail web, vous pouvez faire glisser uniquement une seule requête de l’extérieur d’un dossier vers un dossier.

    Si vous le souhaitez, vous pouvez choisir Autres commandes pour une requête existante, choisir Modifier, puis Enregistrer sous. Dans la boîte de dialogue Enregistrer la requête sous, choisissez le dossier dans lequel vous souhaitez enregistrer la requête.

    Capture d’écran de la boîte de dialogue « Enregistrer la requête sous ».

Vous ajoutez des dossiers de requêtes à partir de la page Tableaux > Requêtes > Tous.

  1. Choisissez Tout. Développez Mes requêtes ou Requêtes partagées en fonction de l’emplacement où vous souhaitez ajouter un dossier de requête.

  2. Pour ajouter un dossier, choisissez Nouveau dossier.

    Capture d’écran de la sélection « Nouveau dossier ».

  3. Entrez le nom du dossier dans la boîte de dialogue Nouveau dossier. Si vous souhaitez modifier l’emplacement du dossier, sélectionnez-le dans le menu déroulant Dossier.

    Capture d’écran de la boîte de dialogue du nouveau dossier.

  4. Pour déplacer des éléments dans un dossier, faites glisser-déplacer une requête dans le dossier. Dans le portail web, vous pouvez faire glisser uniquement une seule requête de l’extérieur d’un dossier vers un dossier.

    Si vous le souhaitez, vous pouvez choisir Autres commandes pour une requête existante, choisir Modifier, puis Enregistrer sous. Dans la boîte de dialogue Enregistrer la requête sous, choisissez le dossier dans lequel vous souhaitez enregistrer la requête.

    Capture d’écran de la boîte de dialogue « Enregistrer la requête sous ».

Enregistrer une requête en tant que favori d’équipe

Pour enregistrer une requête partagée en tant que favori d’équipe, vous devez être membre de l’équipe.

Vous pouvez ajouter une requête partagée aux favoris de l’équipe. Partagez des requêtes avec votre équipe en les ajoutant à un dossier sous le conteneur Requêtes partagées. Pour enregistrer une requête dans le dossier Requêtes partagées, demandez à être ajouté au groupe Administrateurs de collection de projets ou obtenez des autorisations pour un dossier sous Requêtes partagées.

Vous ne pouvez ajouter des requêtes partagées aux favoris de l’équipe que si vous avez les autorisations d’administrateur d’équipe ou d’administrateur de projet.

  1. Pour enregistrer une requête en tant que favori d’équipe, ouvrez le menu Plus d’actions ou le menu contextuel de la requête à partir de la page Requêtes.

  2. Choisissez Ajouter aux favoris de l’équipe, puis sélectionnez l’une des équipes répertoriées. Seules les équipes dont vous faites partie sont répertoriées.

    Capture d’écran de l’option Enregistrer la requête en tant que favori d’équipe.

  1. Pour enregistrer une requête en tant que favori d’équipe, ouvrez le menu Plus d’actions contextuel de la requête à partir des Requêtes partagées sur la page Requêtes.

  2. Choisissez Ajouter aux favoris de l’équipe, puis sélectionnez l’une des équipes répertoriées. Seules les équipes dont vous faites partie sont répertoriées.

    Capture d’écran de l’option Enregistrer la requête en tant que favori d’équipe.

Ajouter une vignette de requête à un tableau de bord

Une vignette de requête affiche le nombre d’éléments de travail dans une requête. Vous pouvez également ouvrir rapidement la requête à partir du tableau de bord. Vous pouvez ajouter une vignette de requête à un tableau de bord à partir de la page Requêtes en procédant comme suit ou en suivant les étapes décrites à la section Ajouter des widgets à un tableau de bord.

Remarque

Vous devez être membre de l’équipe ou avoir reçu les autorisations pour modifier le tableau de bord.

  1. Pour ajouter une requête à un tableau de bord à partir de la page Requêtes, ouvrez le menu Plus d’actions icône d’actions (ou icône contextuelle) pour la requête.

    Capture d’écran du menu Autres actions, sélectionnez Ajouter au tableau de bord.

  2. Dans la boîte de dialogue Sélectionner un tableau de bord, choisissez le tableau de bord auquel vous souhaitez ajouter la requête.

    Capture d’écran de la boîte de dialogue Sélectionner un tableau de bord.

  3. Ouvrez le tableau de bord et vérifiez que la vignette de requête a été ajoutée. Vous pouvez configurer la vignette de requête pour modifier la couleur par défaut et spécifier la couleur de la vignette en fonction d’une règle conditionnelle que vous spécifiez.

    Capture d’écran de la boîte de dialogue Configurer pour le widget de vignette de requête.

  1. Pour ajouter une requête à un tableau de bord à partir de la page Requêtes, ouvrez le menu Plus d’actions pour la requête.

    Capture d’écran du menu Autres actions, sélectionnez Ajouter au tableau de bord.

  2. Dans la boîte de dialogue Sélectionner un tableau de bord, choisissez le tableau de bord auquel vous souhaitez ajouter la requête.

    Capture d’écran de la boîte de dialogue Sélectionner un tableau de bord.

  3. Ouvrez le tableau de bord et vérifiez que la vignette de requête a été ajoutée. Vous pouvez configurer la vignette de requête pour modifier la couleur par défaut et spécifier la couleur de la vignette en fonction d’une règle conditionnelle que vous spécifiez.

    Capture d’écran de la boîte de dialogue Configurer pour le widget de vignette de requête.