Link Switcher

Ce que c'est et pourquoi il existe

Les modèles de traçabilité évoluent. Une équipe commence avec des liens génériques « Link To » puis décide qu'ils doivent être des « Satisfies » ; un import crée des liens « Validated By » dans le mauvais sens ; un nouveau modèle exige un second type de lien à côté de l'existant. Dans l'interface standard, chacun de ces liens doit être supprimé puis recréé un par un, et il est facile d'en perdre en route.

Link Switcher modifie des liens existants en masse et en toute sécurité : vous choisissez les liens à modifier, le type de lien qu'ils deviennent et leur nouveau sens, vous voyez chaque lien avant toute modification et vous lancez le changement en un seul passage contrôlé. Il peut aussi copier des liens sous un autre type en gardant les originaux.

Problèmes résolus

• Des centaines de liens du mauvais type après un import, une migration ou un changement du modèle de traçabilité.
• Des liens orientés dans le mauvais sens qu'il faut inverser.
• Supprimer et recréer des liens à la main, ce qui est lent et risque d'en perdre.
• Un nouveau type de lien qui doit coexister avec l'ancien pendant une période de transition.
• Aucune trace des liens modifiés.

Avantages

• Modification en masse : autant de types de lien que nécessaire deviennent un nouveau type, dans le même sens ou dans le sens inverse.
• Ordre sûr : le nouveau lien est créé d'abord, l'original n'est supprimé qu'ensuite ; si la création échoue, l'original reste.
• Mode copie : « Keep the original links » ajoute une copie du nouveau type et laisse les originaux intacts.
• Aperçu : chaque lien est listé par artefact avec ce qu'il devient, et les nombres sont affichés avant l'exécution.
• Sûr par défaut : seuls les liens du contexte du module sont modifiés, sauf si vous incluez ceux des artefacts de base ; cette option se désactive après chaque exécution.
• Les longues exécutions sous contrôle : progression, Stop et reprise pour les très grands modules, liste des liens non modifiés avec Retry et rapport de modifications Excel.

Utilisation

1. Sous Link types, cliquez sur Change. Sous From, cochez les types de liens à changer et choisissez leur Direction : All directions, Outgoing ou Incoming. La liste provient des types de liens définis dans votre projet.
2. Sous To, choisissez le New link type et la Direction of the new link : Same as original ou Reversed.
3. Si besoin, cochez Keep the original links (copier au lieu de changer) et Change links in the module and on base artifacts, puis cliquez sur Done.
4. Sous Change, choisissez Whole module ou Selection (artefacts sélectionnés dans DOORS Next) et cliquez sur Find links. Rien ne change encore : ouvrez une ligne sous Links pour voir chaque lien et ce qu'il devient.
5. Cliquez sur Change (ou Copy), lisez la confirmation et confirmez avec Change N links (ou Copy N links).
6. Le résultat affiche les liens changés, les nouveaux liens déjà présents, les liens sur les artefacts de base et les échecs, avec Retry. Le Log enregistre le rapport de modifications dans Excel.

Bon à savoir

• Un lien bidirectionnel reste bidirectionnel : seul son type change, et le choix Reversed ne s’applique pas à lui.
• Si les liens choisis ont déjà le nouveau type et le nouveau sens, il n'y a rien à modifier et le widget l'indique.
• Un lien entre deux artefacts du même module est modifié une seule fois.
• Les liens des artefacts de base changent dans tous les modules qui réutilisent ces artefacts ; utilisez cette option en connaissance de cause.
• Travaillez toujours dans un ensemble de modifications : l'abandonner est le seul moyen de récupérer les liens d'origine.
• Sur tout le module, Change fonctionne aussi sans recherche préalable, en une seule passe après la même confirmation. Sur les très grands modules, une exécution arrêtée reprend avec Continue from …, même après un rechargement de la page.
• Hors d'un module, le widget travaille sur les artefacts sélectionnés dans DOORS Next.
• Si l'artefact de base d'un artefact ne peut pas être lu, ses liens dans le module sont quand même changés et un avertissement nomme l'artefact.