Guide de référence pour les types de liens
Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2019
Vous pouvez utiliser différents types de liens pour gérer les différentes relations entre les éléments de travail et d’autres artefacts, tels que les builds, les validations, les demandes de tirage, etc. Dans cet article, nous décrivons les types de liens suivants.
- Type de lien de travail : lie des éléments de travail, y compris certains éléments de travail de gestion de cas de test
- Lien hypertexte : connecte un élément de travail à une URL ou un partage réseau
- Type de lien externe : connecte un élément de travail à un objet externe, comme un objet de code, une build ou une page wiki
- Type de lien de travail à distance : connecte un élément de travail défini dans des organisations différentes
- Type de lien GitHub : connecte un élément de travail à un commit, un problème ou une demande de tirage d’un dépôt GitHub.
Un champ spécifique conserve un nombre de liens pour les quatre premiers types de liens, tels que Nombre de liens associés, Nombre de liens hypertexte, Nombre de liens externes et Nombre de liens distants.
- Type de lien de travail : lie des éléments de travail, y compris certains éléments de travail de gestion de cas de test
- Lien hypertexte : connecte un élément de travail à n’importe quel partage réseau ou URL
- Type de lien externe : connecte un élément de travail à un objet externe, comme un objet de code, une build ou une page wiki
- Type de lien GitHub : connecte un élément de travail à un commit ou une demande de tirage d’un dépôt GitHub.
Un champ spécifique conserve un nombre de liens pour les trois premiers types de liens, tels que Nombre de liens associés, Nombre de liens hypertextes et Nombre de liens externes.
Les types de liens sont soumis à certaines restrictions en fonction de leur topologie. Utilisez l’aide fournie dans les tableaux suivants pour choisir le type de lien à utiliser en fonction des types de requêtes et de rapports que vous voulez créer. Pour en savoir plus sur les différentes topologies, consultez Topologies et restrictions de types de liens.
Type de lien de travail
Les types de liens de travail sont définis par le système, définis par le processus ou définis par l’utilisateur (personnalisé). Les liens listés dans le tableau suivant sont définis par le système.
Chaque type de lien de travail définit les étiquettes de lien, le type de topologie et les restrictions utilisés lors de l’établissement de liens entre des éléments de travail. Par exemple, le type de lien parent-enfant définit deux étiquettes : Parent et Enfant. Le type de lien prend également en charge une topologie hiérarchique ou d’arborescence et empêche la création de références circulaires entre les éléments de travail.
Le Nombre de liens associés d’un élément de travail correspond à la somme de tous les liens définis avec un type de lien de travail.
La table suivante décrit les types de liens d’élément de travail que vous pouvez spécifier pour étendre un contrôle de liens à l’aide de l’élément XML WorkItemLinksFilter.
Nom
Nom de la référence
Utilisation
Affecte Affecté par (CMMI uniquement)
Microsoft.VSTS.Common.Affects-Forward
Microsoft.VSTS.Common.Affects-Reverse
Type de topologie : dépendance
Catégorie de lien : définie par le processus
Utilisez ce lien directionnel pour créer des liens entre n’importe quel ensemble d’éléments de travail, mais pas ceux qui créeraient des boucles fermées. Généralement utilisé pour suivre les demandes de modification effectuées en fonction des exigences.
Restrictions et recommandations :
- Vous pouvez lier une demande de modification a une seule spécification à l'aide de Affecte. Vous pouvez lier des exigences à autant de demandes de modification enfants qu’il le faut à l’aide de Affecté par.
- Utilisez les liens Affecte affecté par uniquement pour lier des éléments de travail dans le même projet. Nous recommandons cette action si vous prévoyez d’utiliser Excel pour modifier ou mettre à jour des données d’éléments de travail.
Enfant-Parent
System.LinkTypes.Hierarchy-Forward
System.LinkTypes.Hierarchy-Reverse
Type de topologie : arborescence
Catégorie de lien : définie par le système
Utilisez ce lien directionnel pour créer des relations un-à-plusieurs entre un parent unique et un ou plusieurs éléments enfants. Permet d’organiser un élément de travail au sein d’une hiérarchie. Vous pouvez créer rapidement cette hiérarchie parmi les éléments du backlog à l’aide de la fonction de mappage ou parmi les éléments et tâches du backlog à l’aide du backlog de sprints ou du Tableau des tâches.
Les utilisations courantes incluent :
- Tenir à jour les relations entre les tâches récapitulatives. Des liens parent-enfant sont créés pour les tâches récapitulatives et leurs tâches subordonnées.
- Lier des tâches à des éléments de backlog de produit, des récits utilisateur ou des spécifications. Prend en charge les rapports Présentation du journal des travaux en souffrance, Vue d'ensemble des récits et Vue d'ensemble des spécifications.
Restrictions et recommandations :
- Utilisez Excel pour modifier en bloc les éléments de travail et les liens parent-enfant. Consultez Ajouter ou modifier les éléments de travail en bloc avec Excel.
- Un élément de travail ne peut avoir qu’un seul parent. Un élément de travail parent peut avoir plusieurs enfants.
- Utilisez les liens parent-enfant uniquement pour lier des éléments de travail dans le même projet. Cette action est recommandée si vous prévoyez d’utiliser Excel pour modifier ou mettre à jour des données d’éléments de travail.
Duplique-dupliqué de
System.LinkTypes.Duplicate-Forward
System.LinkTypes.Duplicate-Reverse
Type de topologie : arborescence
Catégorie de lien : définie par le système
Utilisez ce lien directionnel pour créer des relations un-à-plusieurs entre un parent unique et un ou plusieurs éléments enfants. Permet de suivre les tâches, les bogues ou d’autres éléments de travail qui sont des doublons les uns des autres.
Restrictions et recommandations :
- Un élément de travail ne peut avoir qu’un seul dupliqué.
- Utilisez uniquement Dupliquer ou Dupliqués de liens pour lier des éléments de travail dans le même projet. Cette action est recommandée si vous prévoyez d’utiliser Excel pour modifier ou mettre à jour des données d’éléments de travail.
Référencé par références
Microsoft.VSTS.TestCase.
SharedParameterReferencedBy
Type de topologie : dépendance
Catégorie de lien : définie par le processus
Utilisez pour lier des cas de test à des paramètres partagés. Permet de lier des cas de test à des paramètres partagés pour prendre en charge la possibilité de répéter un test avec différentes données. En général, vous n’ajoutez pas ce type de lien à un contrôle de liens délimités.
Associé
System.LinkTypes.Related
Type de topologie : réseau
Catégorie de lien : définie par le système
Utilisez ce lien non directionnel pour créer des liens entre n’importe quels ensembles d’éléments de travail. Utilisez pour lier des éléments de travail qui sont au même niveau, par exemple des récits utilisateur qui définissent des fonctionnalités qui se chevauchent. Le type de lien associé crée des relations simples avec peu de restrictions.
- Associer des éléments de travail qui sont au même niveau, par exemple des récits utilisateur qui définissent des fonctionnalités qui se chevauchent.
- Lier des éléments de travail qui sont définis dans différents projets d’équipe et gérés par différentes équipes.
- Rechercher et afficher des éléments de travail et leurs éléments de travail associés dans un affichage à deux niveaux.
- Créer des relations simples avec peu de restrictions.
Successeur/Prédécesseur
System.LinkTypes.Dependency
Type de topologie : dépendance
Catégorie de lien : définie par le système
Choisissez le type de lien Prédécesseur lors de la liaison à un élément de travail qui doit être terminé avant l’élément de travail à partir duquel vous effectuez la liaison. Choisissez le type de lien Successeur lors de la liaison à un élément de travail qui doit être terminé après l’élément de travail à partir duquel vous effectuez la liaison.
Utilisez ce lien directionnel pour créer des liens entre n’importe quel ensemble d’éléments de travail, mais pas ceux qui créeraient des boucles fermées. Utilisez pour suivre les tâches qui doivent être achevées avant que d’autres ne soient démarrées. Les tâches liées sont représentées sous forme de liens prédécesseur-successeur dans Azure Boards.
- Suivre les tâches qui doivent être achevées avant que d’autres ne soient démarrées.
- Prend en charge les relations un-à-plusieurs.
- Rechercher et afficher les éléments de travail prédécesseurs et leurs éléments de travail successeurs dans un affichage de requête de liens directs à deux niveaux.
Restrictions et recommandations :
- Une erreur s'affiche quand vous essayez de créer des liens qui définissent des relations circulaires.
- Créez des liens prédécesseur-successeur uniquement vers des éléments de travail qui se trouvent dans le même projet. Vous pouvez créer des liens prédécesseur-successeur entre des éléments de travail qui sont définis dans différents projets. Cependant, si vous exportez une requête vers Excel, seuls les éléments de travail qui sont définis pour le projet pour lequel la requête est définie sont importés.
Testé par-Tests
Microsoft.VSTS.Common.TestedBy-Forward
Microsoft.VSTS.Common.TestedBy-Reverse
Type de topologie : dépendance
Catégorie de lien : définie par le processus
Liez des cas de test à des éléments de travail, tels que des bogues, des récits utilisateur, des exigences et des éléments de backlog de produit. Permet de suivre les cas de test qui testent des récits utilisateur (Agile), des éléments de backlog de produit (Scrum) ou des exigences (CMMI). Peut également être lié à d’autres types d’éléments de travail, tels que des bogues, des problèmes ou des tâches. Pour Azure DevOps local, plusieurs rapports SQL dépendent de ces liens. Consultez Examiner les activités d’équipe pour prendre en charge des rapports utiles.
Cas de test-Étapes partagées
Microsoft.VSTS.TestCase.
SharedStepReferencedBy
Type de topologie : dépendance
Catégorie de lien : définie par le processus
Utilisez pour lier des cas de test avec des étapes partagées. Partagez des étapes entre des cas de test pour éviter d’avoir à créer plusieurs entrées de la même séquence d’étapes.
Hyperlink
Un lien hypertexte peut lier un élément de travail à n’importe quelle URL. Le nombre de liens hypertexte permet de suivre le nombre de liens hypertexte vers un élément de travail.
Nom de la liaison
Outil pris en charge
Type d'artefact
Utilisation
Hyperlink
Suivi des éléments de travail
Hyperlink
Permet de lier un élément de travail à une URL. Lien hypertexte d’élément de travail est le nom de ce type de lien dans l’API Types de liens d’artefact.
Type de lien externe
Les types de liens externes sont des types de liens définis par le système qui prennent en charge la liaison d’éléments de travail à d’autres objets stockés dans Azure DevOps, comme illustré dans l’image suivante. Le Nombre de liens externes d’un élément de travail correspond à la somme de tous les liens définis avec un type de lien de travail.
Remarque
Vous pouvez uniquement utiliser un type de lien externe pour établir un lien vers un objet Azure DevOps. Pour lier des éléments de travail à d’autres objets en dehors d’Azure DevOps, utilisez un lien hypertexte.
Le tableau suivant décrit les types de liens externes que vous pouvez choisir quand vous ajoutez un type de lien à partir d’un élément de travail ou d’un cas de test.
La table suivante décrit les types de liens externes que vous pouvez choisir lors de l’ajout d’un type de lien à partir d’un élément de travail ou d’un cas de test. En outre, vous pouvez utiliser un de ces types de liens pour délimiter l’étendue d’un contrôle en utilisant l’élément XML ExternalLinksFilter.
Nom de la liaison
Outil pris en charge
Type d'artefact
Utilisation
Branche
Git
Branche
Permet de lier un élément de travail à une branche.
Pipelines/Build
Build
Build
Permet de lier un élément de travail à une build.
Ensemble de modifications (ou résolu dans l’ensemble de modifications)
VersionControl
Ensemble de modifications
Permet de lier un élément de travail à un ensemble de modifications.
Validation (ou résolu dans la validation)
Git
Commit
Permet de lier un élément de travail à une validation.
Trouvé dans la build
Pipelines/Build
Build
Permet de lier un élément de travail à une build.
Intégré dans la build
Build
Pipeline de build
Permet de lier un élément de travail à une build.
Intégré dans l'environnement de mise en production
Libérer
Pipeline de mise en production
Utilisé pour lier une mise en production à un élément de travail. Le système crée un lien de ce type lorsqu’un utilisateur active l’option Rapporter l’état de déploiement au travail pour une définition de mise en production.
Demande de tirage (pull request)
Git
PullRequestId
Permet de lier un élément de travail à une demande de tirage.
Pièce jointe des résultats
Gestion des tests
TcmResultAttachment
Permet de lier un élément de travail à une pièce jointe associée à un résultat de test. Ces liens s’affichent lorsque vous associez un élément de travail à un résultat de test à partir de Test ou de Microsoft Test Manager.
Fichier de code source<
VersionControl
LatestItemVersion
Permet de lier un élément de travail à un fichier sous gestion de version Team Foundation (TFVC).
Storyboard
Configuration requise
Storyboard
Permet de lier un élément de travail à un fichier PowerPoint ou à un autre fichier qui contient des informations de plan contextuel sur un réseau.
Tag
Git
Tag
Utilisé pour lier un élément de travail à une étiquette définie pour un commit git ou un dépôt git. Pour plus d’informations, consultez Travailler à partir de l’invite de commandes Git.
Résultat de test
Gestion des tests
TcmResult
Permet de lier un élément de travail à un résultat de test. Ces liens s’affichent lorsque vous associez un élément de travail à un résultat de test à partir de Test ou de Microsoft Test Manager.
Élément avec version
VersionControl
LatestItemVersion
Utilisé pour lier un élément de travail à un fichier ou un ensemble de modifications défini dans un référentiel TFVC. Le Fichier code source est le nom de ce type de lien dans l’API Types de liens d’artefact.
Wiki
Wiki
Wiki
Permet de lier un élément de travail à une page wiki. Pris en charge pour TFS 2018.2 et versions ultérieures.
Type de lien GitHub
Les types de liens GitHub sont définis par le système et prennent en charge la liaison d’éléments de travail à des objets GitHub, comme illustré dans l’image suivante.
Important
Vous pouvez lier seulement à des artefacts GitHub avec des dépôts connectés à Azure Boards.
La table suivante décrit les types de liens GitHub que vous pouvez choisir lors de l’ajout d’un type de lien à partir d’un élément de travail.
Nom de la liaison
Type d'artefact
Utilisation
Validation GitHub
Validation du référentiel GitHub
Permet de lier un élément de travail à une validation GitHub.
Problème GitHub
Problème lié au référentiel GitHub
Permet de lier un élément de travail à un problème GitHub.
Demande de tirage (pull request) GitHub
Demande de tirage du référentiel GitHub
Permet de lier un élément de travail à une demande de tirage GitHub.
Type de lien de travail à distance
Les types de liens de travail à distance sont des types de liens définis par le système qui prennent en charge la liaison d’éléments de travail définis dans différentes organisations, tant que le même service Microsoft Entra ID les gère comme décrit dans Connecter votre organisation à Microsoft Entra ID.
Le Nombre de liens distants d’un élément de travail correspond à la somme de tous les liens définis avec un type de lien de travail distant.
Nom
Nom de la référence
Utilisation
Consomme de-Produit pour
(Topologie des dépendances)
System.LinkTypes.Remote.Dependency-Forward
System.LinkTypes.Remote.Dependency-Reverse
Type de topologie : dépendance
Catégorie de lien : définie par le système
Utilisez ce lien directionnel pour créer des liens entre des éléments de travail qui ont des dépendances et sont définis dans différentes organisations, tant que le même service Microsoft Entra ID les gère. Généralement utilisé pour suivre les demandes de modification effectuées en fonction des exigences.
Associé à distance
System.LinkTypes.Remote.Related
Type de topologie : réseau
Catégorie de lien : définie par le système
Utilisez ce lien non directionnel pour créer des liens entre des éléments de travail définis dans différentes organisations, tant que le même service Microsoft Entra ID les gère.
Type de lien personnalisé
Vous pouvez créer un type de lien personnalisé, exporter et importer des définitions de types de liens, et supprimer, activer, désactiver et réactiver des types de liens. Voir les articles suivants :
Répertorier les types de liens
Pour obtenir la liste des types de liens, vous pouvez utiliser l’un des outils en ligne de commande pris en charge.
az boards work-item relation list-type
Vous pouvez répertorier les types de liens pris en charge par votre organisation avec la commande az boards work-item relation list-type ou la commande API REST Types de relation d’élément de travail - Liste. Pour commencer, consultez Démarrage avec l’interface CLI Azure DevOps.
az boards work-item relation list-type [--org]
Paramètres facultatifs
- org : URL de l’organisation Azure DevOps. Vous pouvez configurer l’organisation par défaut à l’aide de
az devops configure -d organization=ORG_URL
. Obligatoire en l’absence d’une configuration par défaut ou d’une récupération à l’aide degit config
. Exemple :--org https://dev.azure.com/MyOrganizationName/
.
Exemple
La commande suivante répertorie les types de liens d’élément de travail au format de tableau qui sont définis pour l’organisation fabrikam.
az boards work-item relation list-type --org fabrikam --output table
Name ReferenceName Enabled Usage
-------------------- ----------------------------------------------------------- --------- ------------
Produces For System.LinkTypes.Remote.Dependency-Forward True workItemLink
Consumes From System.LinkTypes.Remote.Dependency-Reverse True workItemLink
Duplicate System.LinkTypes.Duplicate-Forward True workItemLink
Duplicate Of System.LinkTypes.Duplicate-Reverse True workItemLink
Referenced By Microsoft.VSTS.TestCase.SharedParameterReferencedBy-Forward True workItemLink
References Microsoft.VSTS.TestCase.SharedParameterReferencedBy-Reverse True workItemLink
Tested By Microsoft.VSTS.Common.TestedBy-Forward True workItemLink
Tests Microsoft.VSTS.Common.TestedBy-Reverse True workItemLink
Test Case Microsoft.VSTS.TestCase.SharedStepReferencedBy-Forward True workItemLink
Shared Steps Microsoft.VSTS.TestCase.SharedStepReferencedBy-Reverse True workItemLink
Successor System.LinkTypes.Dependency-Forward True workItemLink
Predecessor System.LinkTypes.Dependency-Reverse True workItemLink
Child System.LinkTypes.Hierarchy-Forward True workItemLink
Parent System.LinkTypes.Hierarchy-Reverse True workItemLink
Related System.LinkTypes.Related True workItemLink
Remote Related System.LinkTypes.Remote.Related True workItemLink
Attached File AttachedFile True resourceLink
Hyperlink Hyperlink True resourceLink
Artifact Link ArtifactLink True resourceLink
Le format json par défaut fournit des informations supplémentaires sur les attributs définis pour les types de liens. Par exemple, les informations relatives aux types de liens Produit pour et Consomme de sont répertoriées comme suit.
{
"attributes": {
"acyclic": true,
"directional": true,
"editable": false,
"enabled": true,
"isForward": true,
"oppositeEndReferenceName": "System.LinkTypes.Remote.Dependency-Reverse",
"remote": true,
"singleTarget": true,
"topology": "dependency",
"usage": "workItemLink"
},
"name": "Produces For",
"referenceName": "System.LinkTypes.Remote.Dependency-Forward",
"url": "https://dev.azure.com/mseng/_apis/wit/workItemRelationTypes/System.LinkTypes.Remote.Dependency-Forward"
},
{
"attributes": {
"acyclic": true,
"directional": true,
"editable": false,
"enabled": true,
"isForward": false,
"oppositeEndReferenceName": "System.LinkTypes.Remote.Dependency-Forward",
"remote": true,
"singleTarget": true,
"topology": "dependency",
"usage": "workItemLink"
},
"name": "Consumes From",
"referenceName": "System.LinkTypes.Remote.Dependency-Reverse",
"url": "https://dev.azure.com/mseng/_apis/wit/workItemRelationTypes/System.LinkTypes.Remote.Dependency-Reverse"
},
witadmin listlinktypes
Vous pouvez répertorier les types de liens pris en charge pour votre collection de projets à l’aide de witadmin listlinktypes
l’outil en ligne de commande ou de la commande API REST Types de relations d’élément de travail - Liste.
Ici, nous répertorions les types de liens pour la collection par défaut fabrikam-sever :
C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer>witadmin listlinktypes /collection:http://fabrikam-server/DefaultCollection
Reference Name: Microsoft.VSTS.TestCase.SharedParameterReferencedBy
Names: Referenced By, References
Topology: Dependency
Is Active: True
Reference Name: Microsoft.VSTS.Common.TestedBy
Names: Tested By, Tests
Topology: Dependency
Is Active: True
Reference Name: Microsoft.VSTS.TestCase.SharedStepReferencedBy
Names: Test Case, Shared Steps
Topology: Dependency
Is Active: True
Reference Name: System.LinkTypes.Duplicate
Names: Duplicate, Duplicate Of
Topology: Tree
Is Active: True
Reference Name: System.LinkTypes.Dependency
Names: Successor, Predecessor
Topology: Dependency
Is Active: True
Reference Name: System.LinkTypes.Hierarchy
Names: Child, Parent
Topology: Tree
Is Active: True
Reference Name: System.LinkTypes.Related
Name: Related
Topology: Network
Is Active: True
Attributs du type de lien
La table suivante fournit des descriptions pour chacun des attributs de type de lien retournés par la CLI Azure Boards ou l’API REST.
Attribut
Description
Noms, name
Spécifie le nom convivial attribué aux types de liens. Les liens directionnels sont définis par paires et incluent donc un nom de transfert et un nom inversé.
Nom de la référence, referenceName
Spécifie le nom attribué au type de lien ou à la paire de types de liens.
acyclic
Indique si le type de lien autorise ou (true
) ou limite (false
) les relations circulaires. Par exemple, les liens de type d’arborescence limitent les relations circulaires. Pour plus d'informations, consultez Référence de tous les éléments LinkTypes.
directional
Indique si le type de lien est directionnel (true
) ou non (false
). Les types de liens directionnels sont définis par paires avec un composant vers l’avant et un composant inverse. Pour plus d'informations, consultez Référence de tous les éléments LinkTypes.
editable
Indique si le type de lien est modifiable (true
) ou non (false
). Vous pouvez uniquement ajouter et modifier des types de liens personnalisés pour les déploiements locaux à l’aide de l’outil de ligne de commande witadmin
Gérer le type de lien. Les types de liens système ont toujours editable=false
.
Est activé, enabled
Indique si le type de lien est actif (true
) ou non (false
). Vous pouvez utiliser des types de liens personnalisés seulement pour les déploiements locaux en utilisant l’outil de ligne de commande witadmin
Gérer le type de lien.
isForward
Indique si le type de lien spécifie le lien de transfert (true
) ou non (False
) dans une paire de types de lien.
oppositeEndReferenceName
Spécifie le nom de référence du type de lien qui définit le lien dans la direction opposée d’une paire de types de liens.
remote
Indique si le type de lien prend en charge la liaison à un élément de travail distant (true
) ou non (False
). Les types de liens avec remote=false
nécessitent que l’élément de travail cible réside dans la même organisation ou la même collection que l’élément de travail d’origine.
singleTarget
Indique si le type de lien autorise plusieurs cibles (false
) ou s’il est limité à une seule cible (true
).
topology
Spécifie le type de topologie, arborescence du ,
réseau, and
de dépendances. Pour obtenir des descriptions, consultez Topologies et restrictions de type de lien.
usage
Spécifie le type d’utilisation : resourceLink ou workItemLink
. La valeur workItemLinkvalue indicates a link type that links two work items. The
resourceLink indique un type de lien utilisé pour lier un élément de travail à une ressource, comme une URL ou une pièce jointe.
url
Répertorie les attributs du type de lien au format json.