Module Diff

Ce que c'est et pourquoi cela existe

« Qu'est-ce qui a changé dans ce module depuis la dernière baseline ? » est l'une des questions les plus fréquentes avant une revue, une livraison ou un audit. DOORS Next sait comparer des configurations, mais sur un grand module la comparaison est longue et le résultat difficile à parcourir.

Module Diff répond à la question dans l'ELM Mini Dashboard, à côté du module. Choisissez une baseline du flux courant, ou un autre flux ou une autre baseline du même composant, et le widget liste chaque exigence ajoutée, supprimée, modifiée ou déplacée, avec le texte avant et après. Le widget ne fait que lire. Rien ne change dans DOORS Next.

Problèmes résolus

• Comparer un grand module avec une baseline prend trop de temps ; on le saute ou on le fait seulement à la fin.
• Les relecteurs doivent retrouver les quelques exigences modifiées parmi des milliers d'exigences inchangées.
• Les exigences déplacées et les changements de plan passent facilement inaperçus.
• Les revues de modifications et les audits demandent une trace de ce qui a changé, difficile à réunir à la main.

Bénéfices

• Rapide : l'autre configuration est lue par lots et seules de courtes empreintes des textes sont conservées, si bien que même les grands modules sont comparés rapidement.
• Une seule liste : exigences ajoutées, supprimées et modifiées dans l'ordre du module, avec leurs titres pour se repérer, ou toutes les exigences avec All artifacts.
• Avant et après : ouvrez une exigence pour voir l'ancien et le nouveau texte ligne par ligne, le nom, le type d'artefact, la place dans le module et ce que vous avez choisi de comparer : liens par type de lien, tags, commentaires et attributs.
• Facile à parcourir : les titres ressortent dans la liste et se replient avec leur case +/−, et la recherche et les listes au-dessus la restreignent par texte, type d'artefact ou titres.
• Dans les deux sens : Swap inverse la comparaison aussitôt, sans rien relire.
• La structure aussi : les exigences déplacées dans un autre chapitre, dont l'ordre ou le niveau a changé, sont signalées comme telles.
• Prêt pour une revue ou un audit : la comparaison part dans Excel avec la même mise en page que tous les journaux SmarterWidgets, avec les totaux et les deux configurations nommées.
• Sûr pour tous : le widget ne fait que lire, chacun peut donc l'utiliser à tout moment.

Comment l'utiliser

1. Ouvrez le module. Sous Compare, From indique la configuration dans laquelle vous travaillez. Sous To, choisissez la baseline ou le flux à comparer : d'abord les baselines de ce flux, puis les autres flux et baselines du composant. Swap inverse la comparaison.
2. Sous Attributes to compare, cliquez sur Change et cochez ce qui doit être comparé : Primary Text (Contents), Tags, Comments, des attributs comme le statut ou la priorité, et les types de liens, ou Select all. Le nom, le type d'artefact et la place dans le module sont toujours comparés.
3. Cliquez sur Compare module. Une barre de progression montre l'avancement ; vous pouvez arrêter à tout moment.
4. Le résultat compte les exigences ajoutées (seulement dans To), supprimées (seulement dans From), modifiées et inchangées. Differences liste les modifications sous leurs titres ; le champ de recherche et les listes au-dessus restreignent la liste par texte, type d'artefact ou titres, et All artifacts liste toutes les exigences.
5. Ouvrez une exigence pour voir le texte avant et après, ligne par ligne, et ses attributs côte à côte. Show in module vous y emmène.
6. Log à côté du résultat (ou l'icône de téléchargement de Differences) enregistre la comparaison dans Excel pour une revue ou un audit.

Bon à savoir

• Les textes sont comparés en texte brut : un simple changement de mise en forme (gras, couleur) ne compte pas comme une modification.
• Les liens, tags et commentaires sont lus de la même façon dans les deux configurations, si bien que seules les vraies différences sont listées.
• Dans une configuration globale, le module est comparé au sein de son propre composant, avec les flux et baselines de ce composant.
• Les très grands modules peuvent être comparés en plusieurs fois : arrêtez l'exécution, rechargez la page, rouvrez le module et cliquez sur Continue pour reprendre là où elle s'est arrêtée.
• Les exigences qui n'ont pas pu être lues dans l'autre configuration sont listées comme non comparées, avec la raison.