Partager via


Interroger les éléments de travail par nombre de liens ou de pièces jointes

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

Lier des éléments de travail pour suivre le travail et les dépendances connexes, et joindre des fichiers pour partager des informations avec votre équipe. Interroger des éléments de travail à l’aide des champs suivants :

  • Nombre de fichiers attachés
  • (Discussion) Nombre de commentaires
  • Nombre de liens externes
  • Nombre de liens hypertextes
  • Commentaire de lien
  • Nombre de liens associés
  • Nombre de liens distants
  • Nombre de fichiers attachés
  • (Discussion) Nombre de commentaires
  • Nombre de liens externes
  • Nombre de liens hypertextes
  • Commentaire de lien
  • Nombre de liens associés

Pour obtenir des descriptions détaillées des champs, consultez Champs associés aux liens et pièces jointes.

Prérequis

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 : avoir au moins le niveau d'accès basique.
Permissions Autorisation Contribuer définie sur Autoriser pour le dossier auquel vous souhaitez ajouter une requête. Par défaut, le groupe Contributeurs ne dispose pas de cette autorisation.

Note

Les utilisateurs disposant d'un accès partie prenante à un projet public disposent d'un accès complet aux fonctionnalités d'interrogation, 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.

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 (Basic).
Permissions Autorisation Contribuer définie sur Autoriser pour le dossier auquel vous souhaitez ajouter une requête. Par défaut, le groupe Contributeurs ne dispose pas de cette autorisation.

Opérateurs et macros pris en charge

Utilisez les opérateurs suivants pour les clauses qui spécifient un champ entier :

= , <> , > , < , >= , <=
=[Field], <>[Field], >[Field], <[Field], >=[Field], <=[Field]
In, Not In
Was Ever

Répertorier les éléments hiérarchiques dans une arborescence

Créez une requête et sélectionnez Arborescence des éléments de travail pour commencer. L’Éditeur de requête présente les exemples suivants :

Note

Vous ne pouvez pas construire une requête qui affiche une vue hiérarchique des plans de test, des suites de tests et des cas de test, car ces éléments ne sont pas liés à l’aide de types de liens parent-enfant. Utilisez une requête de liens directs pour répertorier les éléments de travail liés aux tests ou afficher la hiérarchie dans la page Plans de test.

Options pour les filtres et les clauses de requête

Modifiez les options de filtre pour les éléments de travail liés et ajoutez des clauses de requête à l’aide des options de l’Éditeur de requête.

Filtrer pour

Inclure ces clauses de requête

Seuls les éléments enfants de l’élément de travail 645

Ajouter aux filtres pour les éléments de travail de niveau supérieur :
ID = 645

Tâches ou bugs

Ajouter aux filtres pour les éléments de travail liés :
Work Item Type In Task,Bug

Éléments attribués à mon équipe (web)

Ajouter aux filtres supérieur et inférieur :
Assigned to In Group [Fabrikam Fiber]\Web

Les éléments principaux des tâches qui m'ont été attribuées

Modifier les options de filtre pour Faire correspondre en premier les éléments de travail liés
Ajouter aux filtres pour les éléments de travail liés :
Assigned To = @Me

Répertorier les éléments en fonction des dépendances liées

L’exemple suivant affiche une requête jointe par dépendance qui retourne des éléments avec des dépendances sur le travail exécuté par d’autres équipes et d’autres projets.

La requête suivante recherche des éléments de travail dans tous les projets qui relient des éléments de travail sous le chemin d’accès et le projet de zone Fabrikam à l’aide de types de liens Prédécesseur et Successeur.

Capture d’écran montrant une requête de liens directs dans le portail web.

  • Sélectionnez Requête entre les projets pour inclure des éléments de travail liés dépendants d’autres projets.
  • Ajoutez la clause Area Path Under Fabrikam pour filtrer les éléments de travail qui sont liés aux éléments définis sous le projet Fabrikam.
  • Sélectionnez Uniquement les éléments de retour qui ont des liens correspondants, puis sélectionnez Renvoyer les types de liens sélectionnés pour renvoyer uniquement les éléments de travail liés en tant que prédécesseur ou successeur.

Répertorier les témoignages utilisateurs isolés

Si vous organisez des histoires utilisateur sous des fonctionnalités spécifiques, recherchez rapidement des histoires sans parent en effectuant l’une des actions suivantes :

  1. Ouvrez le backlog du produit et activez l’option d’affichage Parents On.
  2. Faites défiler jusqu’à la section Articles nonparentés (Agile) ou Backlog nonparented (Scrum).

Capture d’écran montrant le backlog du produit avec des récits non associés.

Vous pouvez également rechercher des éléments de backlog non pris en charge à l’aide d’un élément de travail et d’une requête de liens directs. Par exemple, la requête suivante répertorie les témoignages utilisateurs actifs pour l’équipe Azure DevOps qui n’ont pas de lien Parent.

Capture d’écran montrant l’Éditeur de requête pour les récits utilisateur non parentés dans le portail Web.

Le tableau suivant décrit les champs associés aux liens et aux pièces jointes. La plupart de ces champs n’apparaissent pas dans le formulaire élément de travail, mais sont suivis pour tous les types d’éléments de travail.

Nombre de fichiers attachés

Nombre de fichiers joints à l’élément de travail et stockés dans la base de données de suivi des éléments de travail
Nom=System.AttachedFileCount de référence, Type de données=Integer

Note

Pour Azure Boards (service cloud), vous pouvez ajouter jusqu’à 100 pièces jointes à un élément de travail. Tentatives d'ajouter plus de résultats entraînent un message d’erreur lorsque vous enregistrez l’élément de travail.

Nombre de commentaires

Nombre de commentaires ajoutés à la section Discussion de l’élément de travail.
Nom=System.CommentCount de référence, Type de données=Integer

Nombre de liens externes

Le nombre de liens de l’élément de travail vers des artefacts qui ne sont pas des éléments de travail, tels que des pull requests, des commits, des changesets ou d’autres types de liens.
Nom=System.ExternalLinkCount de référence, Type de données=Integer

Nombre de liens hypertextes

Nombre de liens hypertexte que contient l’élément de travail.

Nom=System.HyperLinkCount de référence, Type de données=Integer

Commentaire de lien

Contient des commentaires du membre d'équipe qui a créé le lien. Vous pouvez configurer ce champ pour qu’il apparaisse sous forme de colonne dans une liste de liens sur un formulaire d’élément de travail. (L’Éditeur de requête ne prend pas en charge ce champ.)

Nom=System.Links.Comment de référence, Type de données=PlainText

Description du lien

Contient le type d'élément de travail, l'ID et le titre de l'élément de travail qui constitue la cible du lien. Vous pouvez configurer ce champ pour qu’il apparaisse sous forme de colonne dans une liste de liens sur un formulaire d’élément de travail. (L’Éditeur de requête ne prend pas en charge ce champ.)

Nom=System.Links.Description de référence, Type de données=PlainText

Parent

Lorsqu’il est inclus en tant qu’option de colonne dans une liste de résultats de backlog ou de requête, le système affiche le titre de l’élément de travail parent. En interne, le système stocke l’ID de l’élément de travail dans un champ Entier.

Note

Vous pouvez ajouter le champ Parent en tant que colonne ou le spécifier dans une clause de requête en indiquant l’ID de l’élément de travail parent.
Nom=System.Parent de référence, Type de données=Integer

Nombre de liens associés

Nombre de liens définis pour un élément de travail qui utilisent un type de lien de travail, comme Parent-Enfant, Prédécesseur-Successeur et Associé. Pour obtenir la liste complète, consultez Référence du type de lien.
Nom=System.RelatedLinkCount de référence, Type de données=Integer

Nombre de liens distants

Disponible pour Azure DevOps Services uniquement. Nombre de liens d’un élément de travail vers des éléments de travail définis dans une autre organisation. Le même Microsoft Entra ID doit gérer les organisations. Les types de liens pris en charge incluent Consomme à partir de, Produit pour et Lié à distance. Pour obtenir plus d’informations, consultez Ajouter un lien à des éléments de travail, Lier à un élément de travail à distance.
Nom=System.RemoteLinkCount de référence, Type de données=Integer

Affichez les éléments de travail et les objets associés dans un élément de travail à l’aide de l’extension de visualisation d’élément de travail disponible à partir de l’onglet Visual Studio Marketplace, Azure DevOps.

Pour ajouter des types de liens, consultez Gérer les types de liens [witadmin].

Tous les onglets qui prennent en charge la création de liens entre les éléments de travail utilisent l’élément LinksControl dans le formulaire d’élément de travail. Cet élément contrôle le filtrage et limite les types d’éléments de travail auxquels vous pouvez lier. Il contrôle également les types de liens que vous pouvez créer et si vous pouvez lier des éléments de travail dans un autre projet. Pour personnaliser les contrôles et restrictions de lien, modifiez la définition d’un élément de travail LinksControlOptions, et consultez les éléments XML LinksControlOptions.

Vous pouvez ajouter ou supprimer des colonnes dans la liste de liens et vous pouvez personnaliser les colonnes par défaut et l'ordre des colonnes. Pour plus d'informations, consultez Éléments XML LinksControlOptions.