Terms Linker

Ce que c'est et pourquoi il existe

Un glossaire partagé est l'un des meilleurs remèdes contre les exigences ambiguës : chaque terme possède une définition unique et validée. Il n'est toutefois utile que si les lecteurs peuvent accéder à la définition depuis l'endroit où le terme est employé, et si vous pouvez voir quelles exigences dépendent de quel terme.

Dans DOORS Next, cela signifie créer à la main un hyperlien dans le texte et un lien References Term pour chaque occurrence. Pour un module de centaines d'exigences et de dizaines de termes, cela représente des jours de travail, et personne ne le tient à jour. Terms Linker a été créé pour le faire automatiquement et de manière cohérente.

Problèmes résolus

• Des termes du glossaire utilisés dans les exigences sans aucun lien vers leur définition.
• Aucune traçabilité entre les termes et les exigences qui les utilisent : l'impact d'une modification de définition reste inconnu.
• Des heures de création manuelle de liens, incohérentes d'un auteur à l'autre.
• Des liens créés seulement en partie après un travail antérieur manuel ou interrompu.

Avantages

• Des exigences sans ambiguïté : les lecteurs ouvrent la définition d'un terme en un clic.
• Analyse d'impact : les liens References Term montrent quelles exigences sont concernées lorsqu'une définition change.
• Cohérence : mots entiers uniquement, le terme le plus long en premier (par exemple « système de freinage » avant « freinage »), et aucun lien à l'intérieur de liens existants.
• Aperçu avant modification : le widget liste les artefacts, les termes trouvés et leur nombre d'occurrences.
• Réversible : Terms Remover supprime exactement ce que Terms Linker a créé.

Utilisation

1. Dans Terms, cliquez sur Find all terms pour utiliser tous les termes du glossaire du projet, ou sur Pick terms pour en choisir certains.
2. Ouvrez un module et cliquez sur Find usage of terms in module. Le widget affiche les artefacts qui utilisent des termes ainsi que les termes les plus utilisés.
3. Examinez la liste, puis cliquez sur Link terms (N) et confirmez. Les hyperliens et les liens de termes sont créés par lots, avec progression et Stop.
4. Pour ne lier que certains artefacts, sélectionnez-les dans DOORS Next et cliquez sur Link terms (N) dans la section Selection.
5. Pour les très grands modules, Link without searching crée les liens en une seule passe et présente le résultat à la fin.

Bon à savoir

• Le type d'artefact des termes du glossaire (par défaut Term) et la correspondance insensible à la casse se règlent dans les Settings de la section Terms.
• Les liens sont créés sur l'artefact de base : ils sont donc visibles dans chaque module qui réutilise l'exigence.
• Exécutez le widget dans un ensemble de modifications et conservez le rapport de modifications comme trace de ce qui a été lié.