# Attribute Linker

> Transforme les ID et clés stockés dans un attribut en vrais liens, pour un module entier ou une sélection, après confirmation.

Source: https://widgets.doorsnext.com/fr/widgets/attribute-linker/

- Discipline: Liens et traçabilité
- Fonctionne dans: Module IBM DOORS Next
- Produits pris en charge: RM (IBM Engineering Requirements Management DOORS Next (Requirements Management))
- Modifie les données
- Keywords: créer des liens depuis un attribut, importer la traçabilité, Parent ID, liens import Excel, import ReqIF, migration DOORS 9, ID historique, création de liens en masse, traçabilité
- Version: 1.19 (Publiée le 2026-10-27)
- Vendor: SmarterProcess (https://doorsnext.com, info@smarterprocess.pl)
- Déroulement: 1. Settings : attribut des références, type de lien, direction → 2. Whole module (Si besoin: Ou sélectionner des artefacts : Selection) → 3. Create links : après confirmation → 4. Vérifier la liste et les références non résolues → 5. Rapport des modifications dans Excel

## Ce que c'est et pourquoi il existe
Quand les exigences viennent d'Excel, de ReqIF ou de DOORS 9, la traçabilité arrive rarement sous forme de liens. Elle arrive sous forme de texte : une colonne comme « Parent ID », « Satisfies » ou « Derived from » qui contient un ou plusieurs ID ou clés historiques. Dans l'interface standard, chacune de ces références doit être transformée en lien à la main, artefact par artefact.

Attribute Linker lit cet attribut, trouve l'artefact que nomme chaque référence et crée les liens en une seule exécution. Les cibles sont trouvées par leur ID DOORS Next dans tout le projet, ou par la valeur d'un attribut (par exemple « Legacy ID ») dans un module cible.

## Problèmes résolus
- Une traçabilité importée sous forme de texte dans un attribut au lieu de liens.
- Des centaines ou des milliers de liens à créer à la main après une migration.
- Des références qui ne pointent vers rien, ou vers plusieurs artefacts, découvertes bien plus tard.
- Aucune trace des liens créés ni des références qui n'ont pas pu être résolues.

## Avantages
- **Chaque référence est prise en compte :** après l'exécution, chaque référence est listée comme Linked, Already linked, Not found, Ambiguous ou Self reference.
- **Ne devine jamais :** une référence qui correspond à plusieurs artefacts est écartée et listée avec les candidats.
- **Correspondance souple :** par ID DOORS Next, ou par une clé historique stockée dans un attribut d'un module cible ; listes séparées par des virgules, points-virgules, espaces ou retours à la ligne.
- **Réglages sûrs par défaut :** les liens sont créés dans le contexte du module, comme le fait DOORS Next dans un module ; sur les artefacts de base seulement si vous le choisissez.
- **Des exécutions qui reprennent :** les liens existants sont ignorés, progression et Stop, reprise après un arrêt sur les très gros modules, échecs avec Retry, liste Excel des références non résolues et rapport de modifications Excel.

## Utilisation
1. Ajoutez le widget à l'ELM Mini Dashboard à côté du module.
2. Dans **Settings**, cliquez sur **Change** et indiquez les **Reference attributes** qui contiennent les références, les séparateurs, la façon de trouver les cibles (**Artifact ID**, ou **Attribute in a module** d'un module cible), le **Link type** et la **Direction**, puis cliquez sur **Done**.
3. Sous **Links**, choisissez **Whole module**, ou sélectionnez des artefacts et choisissez **Selection**.
4. Cliquez sur **Create links**, lisez la confirmation et confirmez. Le widget trouve les références et crée les liens manquants en une seule exécution.
5. Consultez le bloc de résultat et la liste **References** : le filtre **Not resolved** montre chaque référence qui n'a pas pu être liée, avec la raison. Exportez-les vers Excel si nécessaire et téléchargez le rapport de modifications avec **Log**.

## Bon à savoir
- Les références ambiguës et celles qui désignent l'artefact lui-même ne sont jamais liées ; elles sont listées et peuvent être exportées vers Excel.
- Si la valeur d'un attribut change pendant l'exécution, cet artefact n'est pas modifié et figure dans la liste : relancez Create links.
- Un réglage optionnel vide l'attribut une fois toutes ses références liées ; il est désactivé par défaut.
- Lorsque vous travaillez dans une configuration globale, le module cible et les artefacts trouvés par ID peuvent aussi se trouver dans un autre composant de cette même configuration globale ; les liens relient alors les composants. Dans un seul stream ou une seule baseline, seul le composant ouvert est utilisé.
- Travaillez toujours dans un change set : l'abandonner est le seul moyen d'annuler les liens créés.