Partager via

Guide de référence pour les types de liens

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

Utilisez différents types de liens pour gérer les relations entre les éléments de travail et d’autres artefacts, tels que les build, les commits et les pull requests. Cet article décrit les types de liens suivants.

  • Type de lien de travail : liens entre les éléments de travail, y compris les éléments de travail de gestion des cas de test sélectionnés
  • Lien hypertexte : connecte un élément de travail à n’importe quelle URL ou partage réseau
  • Type de lien externe : connecte un élément de travail à un objet externe, tel qu’un objet de code, une build ou une page wiki
  • Type de lien de travail à distance : connecte les éléments de travail définis dans différentes organisations
  • Type de lien GitHub : connecte un élément de travail à un commit, une issue ou une pull request GitHub.

Un champ spécifique conserve le nombre de liens pour les quatre premiers types de liens, tels que Le nombre de liens connexes, le nombre de liens hypertexte, le nombre de liens externes et le nombre de liens distants.

  • Type de lien de travail : liens entre les éléments de travail, y compris les éléments de travail de gestion des cas de test sélectionnés
  • Lien hypertexte : connecte un élément de travail à n’importe quelle URL ou partage réseau
  • Type de lien externe : connecte un élément de travail à un objet externe, tel qu’un objet de code, une build ou une page wiki
  • Type de lien GitHub : connecte un work item à un commit de dépôt GitHub ou à un pull request.

Un champ spécifique conserve le nombre de liens pour les trois premiers types de liens, tels que Le nombre de liens connexes, le nombre de liens hypertexte et le nombre de liens externes.

Les types de liens ont des restrictions topologiques. Utilisez les conseils des tableaux suivants pour choisir un type de lien en fonction des requêtes et rapports que vous prévoyez de créer. Pour en savoir plus sur les topologies, consultez topologies et restrictions de type de lien.

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 répertoriés dans le tableau suivant sont définis par le système.

Chaque type de lien de travail définit les étiquettes, la topologie et les restrictions utilisées lorsque vous construisez des 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 utilise une topologie d’arborescence et empêche les références circulaires entre les éléments de travail.

Capture d’écran montrant un diagramme conceptuel d’un type de lien d’élément de travail.

Le nombre de liens associés d’un élément de travail est égal à la somme de tous les liens définis avec un type de lien de travail.

Le tableau suivant 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) Capture d’écran montrant un diagramme conceptuel du type de lien Affecte.Capture d’écran montrant un diagramme conceptuel du type de lien Affecté par.

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 les éléments de travail sans créer de boucles fermées. Les utilisateurs l’utilisent généralement pour suivre les demandes de modification liées aux exigences.

Restrictions et recommandations :

  • Lier une demande de modification à une seule exigence à l’aide d’Affects. Lier les exigences à autant de demandes de modification enfant que nécessaire à l’aide d’Affected by.
  • Utilisez uniquement Affects-Affected par des liens pour lier des éléments de travail dans le même projet. Nous vous recommandons de le faire lorsque vous envisagez d’utiliser Excel pour modifier ou mettre à jour les données d’élément de travail.

Enfant-Parent
Capture d’écran montrant un schéma conceptuel du type de lien enfant.
Capture d’écran montrant un diagramme conceptuel du type de lien 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 et un ou plusieurs élément enfant. Utilisez-le pour organiser les éléments de travail au sein d’une hiérarchie. Vous pouvez créer cette hiérarchie entre les éléments de backlog à l’aide de la fonction de mappage ou entre les éléments de backlog et les tâches à l’aide du backlog sprint ou du Tableau des tâches.

Les utilisations classiques sont les suivantes :

  • Conservez les relations récapitulatives des tâches. Les liens parent-enfant représentent des tâches récapitulatives et leurs tâches subordonnées.
  • Lier des tâches aux PBIs, aux récits utilisateur ou aux exigences. 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 uniquement des liens parent-enfant pour lier des éléments de travail dans le même projet. Nous vous recommandons de le faire lorsque vous envisagez d’utiliser Excel pour modifier ou mettre à jour les données d’élément de travail.

Duplicate-Duplicate deCapture d’écran montrant un diagramme conceptuel du type de lien Duplicate.Capture d’écran montrant un diagramme conceptuel du type de lien Duplicate Of.

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 de navigation pour créer des relations un-à-plusieurs afin de suivre les tâches, les bogues ou d’autres éléments de travail identiques.

Restrictions et recommandations :

  • Un élément de travail ne peut avoir qu’un seul doublon.
  • Utilisez uniquement des liens de type "Duplicate" ou "Duplicate Of" pour lier des éléments de travail au sein du même projet. Nous vous recommandons de le faire lorsque vous envisagez d’utiliser Excel pour modifier ou mettre à jour les données d’élément de travail.

Référencé par des références
Capture d’écran montrant un diagramme conceptuel du type de lien Référencé par. Capture d’écran montrant un diagramme conceptuel du type de lien Référence.

Microsoft.VSTS.TestCase.
ParamètrePartagéRéférencéPar
Type de topologie : Dépendance
Catégorie de lien : définie par le processus

Utilisez-le pour lier des cas de test à des paramètres partagés et prendre en charge la répétition d’un test avec différentes données. En règle générale, vous n’ajoutez pas ce type de lien à un contrôle de liens délimité.

Associé
Capture d’écran montrant un diagramme conceptuel du type de lien associé.

System.LinkTypes.Related
Type de topologie : Réseau
Catégorie de lien : définie par le système

Utilisez ce lien nondirectionnel pour créer des relations entre les éléments de travail. Utilisez-le pour lier des éléments de travail au même niveau (par exemple, deux récits utilisateur qui se chevauchent). Le type de lien associé crée des relations simples avec quelques restrictions.

  • Associez les éléments de travail qui se trouvent au même niveau.
  • Lier des éléments de travail définis dans différents projets et gérés par différentes équipes.
  • Recherchez et affichez les éléments de travail et leurs éléments de travail associés dans une vue à deux niveaux.
  • Créez des relations simples avec quelques restrictions.

Successeur-Prédécesseur
Capture d’écran montrant un diagramme conceptuel de la dépendance successeur. Capture d’écran montrant un diagramme conceptuel de la dépendance Prédécesseur.

System.LinkTypes.Dependency
Type de topologie : Dépendance
Catégorie de lien : définie par le système
Choisissez Prédécesseur lors de la liaison à un élément de travail qui doit se terminer avant l’élément actif. Choisissez Successeur lors de la liaison à un élément de travail qui doit se terminer après l’élément actif.

Utilisez ce lien directionnel pour suivre les tâches qui doivent se terminer avant le début des autres. Les tâches liées apparaissent en tant que liens prédécesseurs-successeurs dans Azure Boards.

  • Effectuez le suivi des tâches qui doivent être effectuées avant que d’autres ne puissent commencer.
  • Prendre en charge les relations un-à-plusieurs.
  • Recherchez les éléments de travail prédécesseur et successeur dans une vue de requête de liaison directe à deux niveaux.

Restrictions et recommandations :

  • Une erreur s’affiche lorsque vous tentez de créer des relations circulaires.
  • Créez des liens prédécesseur-successeur uniquement pour les éléments de travail au sein du même projet lorsque vous envisagez d’exporter vers Excel. Vous pouvez créer des liens prédécesseur-successeur entre des projets, mais l’exportation/importation Excel inclut uniquement les éléments du projet qui définit la requête.

Testé par des tests
Capture d’écran montrant un diagramme conceptuel du type de lien Testé par type de lien. Capture d’écran montrant un diagramme conceptuel du type de lien 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

Lier des cas de test à des éléments de travail tels que des bogues, des récits utilisateur, des exigences et des PBIs. Utilisez-le pour suivre les cas de test qui valident les récits utilisateur (Agile), les PBIs (Scrum) ou les exigences (CMMI). Pour Azure DevOps local, plusieurs rapports SQL dépendent de ces liens. Consultez les activités de l’équipe de révision pour soutenir les rapports utiles.

Étapes de test Case-Shared
Capture d’écran montrant un diagramme conceptuel du lien Cas de test vers étapes partagées. Capture d’écran montrant un diagramme conceptuel du lien étapes partagées vers cas de test.

Microsoft.VSTS.TestCase.
SharedStepReferencedBy
Type de topologie : Dépendance
Catégorie de lien : définie par le processus

Utilisez-le pour lier des cas de test avec des étapes partagées. Partagez les étapes entre les cas de test pour éviter de dupliquer la même séquence d’étapes.

Un lien hypertexte lie un élément de travail à n’importe quelle URL. Le nombre de liens hypertexte effectue le suivi du nombre de liens hypertexte sur un élément de travail.

Capture d’écran montrant un diagramme conceptuel d’un lien hypertexte.

Nom de la liaison

Outil pris en charge

Type d’artefact

Utilisation

Lien hypertexte

Suivi des éléments de travail

Lien hypertexte

Utilisez cette option pour lier un élément de travail à une URL. Work item Hyperlink est le nom de ce type de lien dans l’API Artifact Link Types.

Les types de liens externes sont des éléments de travail définis par le système et relient d’autres objets stockés dans Azure DevOps. Le nombre de liens externes d’un élément de travail est égal à la somme de tous les liens définis avec les types de liens externes.

Capture d’écran montrant un diagramme conceptuel des types de liens externes.

Remarque

Utilisez un type de lien externe uniquement pour lier un objet Azure DevOps. Pour lier des éléments de travail à des objets en dehors d’Azure DevOps, utilisez un lien hypertexte.

Le tableau suivant décrit les types de liens externes que vous pouvez choisir lorsque vous ajoutez un lien à partir d’un élément de travail ou d’un cas de test.

Le tableau suivant décrit les types de liens externes que vous pouvez choisir lors de l’ajout d’un lien à partir d’un élément de travail ou d’un cas de test. Vous pouvez également spécifier l’un de ces types de liens pour étendre un contrôle de liens à l’aide de l’élément XML ExternalLinksFilter.

Nom de la liaison

Outil pris en charge

Type d’artefact

Utilisation

Alerte de sécurité

Sécurité avancée

Sécurité avancée

Utilisé pour lier un élément de travail à une alerte Advanced Security.

Branche

Git

Branche

Permet de lier un élément de travail à une branche.

Pipelines/Build

Construire

Construire

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

Validations

Permet de lier un élément de travail à une validation.

Trouvé dans la build

Pipelines/Build

Construire

Permet de lier un élément de travail à une build.

Intégré dans la build

Construire

Pipeline de build

Permet de lier un élément de travail à une build.

Intégré dans l’environnement de mise en production

Libération

Pipeline de déploiement

Permet de lier une version publiée à un élément de travail. Le système crée ce type lorsqu’un utilisateur active le rapport d'état de déploiement vers Work pour une définition de publication.

Demande de tirage (pull request)

Git

PullRequestId

Utilisez pour lier un élément de travail à une pull request.

Annexe de résultat

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 microsoft Test Manager.

Fichier de code source

VersionControl

LatestItemVersion

Permet de lier un élément de travail à un fichier sous Contrôle de version Team Foundation (TFVC).

Plan conceptuel

Spécifications

Plan conceptuel

Permet de lier un élément de travail à un fichier PowerPoint ou à un autre fichier qui contient des informations de montage séquentiel sur un réseau.

Tag

Git

Tag

Permet de lier un élément de travail à une balise définie pour une validation git ou un dépôt. Pour plus d’informations, consultez Utilisation de l’invite de commande 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 microsoft Test Manager.

Élément versionné

VersionControl

LatestItemVersion

Permet de lier un élément de travail à un fichier ou un ensemble de modifications défini dans un référentiel TFVC. Source Code File est le nom de ce type de lien dans l'API "Artifact Link Types".

Site collaboratif Wiki

Site collaboratif Wiki

Site collaboratif Wiki

Permet de lier un élément de travail à une page wiki. Pris en charge pour TFS 2018.2 et versions ultérieures.

Les types de liens GitHub sont des éléments de travail définis par le système et des liens vers des objets GitHub, comme illustré ici.

Capture d’écran montrant un diagramme conceptuel des types de liens GitHub.

Importante

Vous pouvez uniquement associer des artefacts GitHub aux dépôts connectés à Azure Boards.

Le tableau suivant décrit les types de liens GitHub que vous pouvez choisir lors de l’ajout d’un 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 de dépôt GitHub

Permet de lier un élément de travail à un problème GitHub.

Demande de tirage GitHub

Pull request du dépôt GitHub

Associer un élément de travail à un pull request GitHub.

Les types de liens de travail à distance prennent en charge la liaison d’éléments de travail définis dans différentes organisations, tant que le même ID Microsoft Entra gère ces organisations (voir Connecter votre organisation à Microsoft Entra ID).

Le nombre de liens distants d’un élément de travail est égal à 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) Capture d’écran montrant un diagramme conceptuel de consommation à partir de la topologie.Capture d’écran montrant un diagramme conceptuel de La topologie Produite pour la topologie.

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 dépendances entre les éléments de travail définis dans différentes organisations, tant que le même ID Microsoft Entra les gère. Les utilisateurs utilisent généralement cette option pour suivre les demandes de modification liées aux exigences au-delà des limites de l’organisation.

Lié à distance
Capture d’écran montrant un diagramme conceptuel de la topologie associée à distance.

System.LinkTypes.Remote.Related
Type de topologie : Réseau
Catégorie de lien : définie par le système

Utilisez ce lien nondirectionnel pour lier des éléments de travail définis dans différentes organisations, tant que le même ID Microsoft Entra les gère.

Créez des types de liens personnalisés, exportez et importez des définitions de type de lien et supprimez, activez, désactivez ou réactivez les types de liens personnalisés. Voir:

Vous pouvez répertorier les types de liens à l’aide d’outils en ligne de commande pris en charge.

Type de liste de relations d'élément de travail az boards

Types de liens pris en charge par votre organisation à l'aide de la commande az boards work-item relation list-type ou de l'API REST Work Item Relation Types - List. Pour plus d’informations, consultez Prise en main d’Azure DevOps CLI.

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 si ce paramètre n’est pas configuré par défaut ou récupéré avec git 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 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 l’outil witadmin listlinktypes en ligne de commande ou de la commande d’API REST Types de relation d’élément de travail - Liste.

Voici une liste des 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

Le tableau suivant fournit des descriptions pour chacun des attributs de type de lien retournés par Azure Boards CLI 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 un nom pour l'aller et un pour le retour.

Nom de 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 la référence des éléments LinkTypes.

directional

Indique si le type de lien est directionnel (true) ou non (false). Les types de liens directionnels sont définis en paires avec un composant avant et inverse. Pour plus d’informations, consultez la référence des éléments LinkTypes.

editable

Indique si le type de lien est modifiable () outrue non (false). Vous pouvez uniquement ajouter et modifier des types de liens personnalisés pour les déploiements locaux à l’aide witadmin de l’outil de ligne de commande 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 uniquement utiliser des types de liens personnalisés pour les déploiements locaux à l’aide de l’outil Gérer le witadmin type de lien en ligne de commande.

isForward

Indique si le type de lien spécifie le lien vers l’avant (true) ou non (False) dans une paire de types de liens.

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 se trouve dans la même organisation ou collection que l’élément de travail d’origine.

singleTarget

Indique si le type de lien autorise plusieurs cibles (false) ou est limité à une seule cible (true).

topology

Spécifie le type de topologie : dependency, networket tree. Pour obtenir des descriptions, consultez topologies et restrictions de type de lien.

usage

Spécifie le type d’utilisation : resourceLink or valeur workItemLink. The workItemLink indique un type de lien qui lie deux éléments de travail. La resourceLink valeur indique un type de lien utilisé pour lier un élément de travail à une ressource, telle qu’une URL ou une pièce jointe.

url

Répertorie les attributs du type de lien au format json.

Contenu connexe

  • Last updated on