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

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

Vous pouvez lier des éléments de travail pour suivre un travail et des dépendances associés et attacher des fichiers pour partager des informations avec votre équipe. Vous pouvez ensuite répertorier les éléments de travail en fonction d’un ou plusieurs des champs suivants :

Nombre de fichiers joints | Nombre de commentaires (Discussion) | Nombre de liens externes | Nombre de liens hypertexte | Commentaire de lien | Nombre de liens associés | Nombre de liens distants

Pour plus d’informations sur ces champs, consultez le tableau fourni plus loin dans cet article.

Opérateurs et macros pris en charge

Les clauses qui spécifient un champ entier peuvent utiliser les opérateurs suivants.

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

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

Ajoutez une requête et sélectionnez Arborescence des éléments de travail pour commencer votre requête. Vous devriez voir quelque chose de similaire aux exemples suivants :

Browser

Visual Studio 2015

Notes

Vous ne pouvez pas construire une requête qui affiche une vue hiérarchique des Test Plans, Suites de tests et Cas de test. Ces éléments ne sont pas liés entre eux à l’aide de types de liens parent-enfant. Toutefois, vous pouvez créer une requête de liens directs qui répertorie les éléments de travail liés aux tests. Vous pouvez également afficher la hiérarchie via la page Test Plans.

Options pour les filtres et les clauses de requête

Modifiez les options de filtre pour les éléments de travail associés et ajoutez des clauses de requête via les options suivantes.

Filtrer sur

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 bogues

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

Éléments parents des tâches qui m’ont été attribuées

Modifier les options de filtre pour Trouver d’abord 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.

Browser

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

• Cochez la case Requête sur plusieurs projets pour permettre de répertorier tous les éléments de travail liés qui correspondent aux critères de filtre, quel que soit le projet auquel ils appartiennent.
• Spécifiez la clause Chemin d’accès de la zone sous Fabrikam qu’il faut rechercher uniquement les éléments de travail liés aux éléments de travail définis sous le projet Fabrikam.
• Spécifiez des clauses Retourner uniquement les éléments qui ont des liens correspondants et Retourner les types de liens sélectionnés pour ne retourner que les éléments de travail qui sont liés sur la base des types de liens Prédécesseur et Successeur.

Visual Studio 2015

Utilisez ce type de requête pour répertorier tous les éléments de travail dépendants liés aux éléments du Product Backlog ou Bugs actifs qui ne sont ni supprimés, ni fermés, ni terminés. Seuls les éléments de travail dépendants qui figurent dans une zone produit autre que Phone Save \ Phone Customers sont retournés.

• Supprimez la clause **Projet d’équipe = @Project** pour permettre de répertorier tous les éléments de travail liés qui correspondent aux critères de filtre, quel que soit le projet auquel ils appartiennent dans la collection.
• Regroupez chacune des deux clauses pour retourner chaque Élément de backlog de produit dans le backlog ou le journal des travaux en cours, et la deuxième clause groupée retourne chaque Bogue dans le backlog ou le journal des travaux en cours.
• Regroupez les deux clauses avec l’opérateur OU au début de la deuxième clause pour retourner les éléments de travail qui correspondent à l’un ou l’autre des deux critères de filtre.
• Sélectionnez Retourner uniquement les éléments ayant les liens spécifiés pour retourner uniquement les éléments de travail de niveau supérieur qui ont des dépendances.
• Sélectionnez Retourner des liens de tout type pour retourner tous les éléments de travail liés qui correspondent aux critères de filtre pour tous les éléments de travail qui ne figurent pas sous le chemin d’accès de la zone Phone Saver \ Phone Customers et qui ne sont ni terminés, ni supprimés.

L’illustration suivante montre les résultats de la requête.

Répertorier les témoignages utilisateurs isolés

Si vous organisez généralement vos récits utilisateur sous des fonctionnalités, vous pouvez les trouver rapidement en effectuant les étapes suivantes.

1. Ouvrez le backlog du produit et activez l’option d’affichage Parents On.
2. Faites défiler vers le bas jusqu’à la section qui répertorie les Unparented Stories (Agile) ou les Unparented Backlog items (Scrum).

Vous pouvez également trouver des éléments de backlog sans parent à l’aide d’une requête Éléments de travail et 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.

Champs associés aux liens et pièces jointes

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 de l’é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
Reference Name=System.AttachedFileCount, Data type=Integer

Notes

Pour Azure Boards (service cloud), vous pouvez ajouter jusqu’à 100 pièces jointes à un élément de travail. Les tentatives d’ajout de plus de pièces jointes entraînent un message d’erreur lors de l’enregistrement de l’élément de travail.

Nombre de commentaires

Nombre de commentaires ajoutés à la section Discussion de l’élément de travail.
Reference Name=System.CommentCount, Data type=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.
Reference Name=System.ExternalLinkCount, Data type=Integer

Nombre de liens hypertextes

Nombre de liens hypertextes définis pour l'élément de travail.

Reference Name=System.HyperLinkCount, Data type=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. (Non pris en charge dans l’éditeur de requête.)

Reference Name=System.Links.Comment, Data type=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. (Non pris en charge dans l’éditeur de requête.)

Reference Name=System.Links.Description, Data type=PlainText

Parent

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

Notes

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.
Reference Name=System.Parent, Data type=Integer

Tous

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.
Reference Name=System.RelatedLinkCount, Data type=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.
Reference Name=System.RemoteLinkCount, Data type=Integer

Articles connexes

• Ajouter un lien à plusieurs éléments de travail
• Lier des éléments de travail à d’autres objets
• Aide-mémoire sur les requêtes
• Éditeur de requêtes
• Champs, opérateurs et macros de requête
• Index des champs d’élément de travail