Module Diff

Was es ist und warum es existiert

„Was hat sich in diesem Modul seit der letzten Baseline geändert?“ ist eine der häufigsten Fragen vor einem Review, einem Release oder einem Audit. DOORS Next kann Konfigurationen vergleichen, doch bei einem großen Modul dauert der Vergleich lange und das Ergebnis ist schwer zu überblicken.

Module Diff beantwortet die Frage im ELM Mini Dashboard neben dem Modul. Wählen Sie eine Baseline des aktuellen Streams oder einen anderen Stream oder eine Baseline derselben Komponente, und das Widget listet jede hinzugefügte, entfernte, geänderte oder verschobene Anforderung auf, mit dem Text vorher und nachher. Das Widget liest nur. In DOORS Next ändert sich nichts.

Welche Probleme es löst

• Der Vergleich eines großen Moduls mit einer Baseline dauert zu lange und wird deshalb ausgelassen oder erst am Ende gemacht.
• Reviewer müssen die wenigen geänderten Anforderungen unter Tausenden unveränderten finden.
• Verschobene Anforderungen und Änderungen der Gliederung werden leicht übersehen.
• Änderungsreviews und Audits brauchen einen Nachweis der Änderungen, der von Hand mühsam zu erstellen ist.

Nutzen

• Schnell: Die andere Konfiguration wird in Paketen gelesen und von den Texten werden nur kurze Fingerabdrücke behalten, so dass auch große Module schnell verglichen werden.
• Eine Liste: hinzugefügte, entfernte und geänderte Anforderungen in Modulreihenfolge, mit ihren Überschriften zur Orientierung, oder mit All artifacts alle Anforderungen.
• Vorher und nachher: Öffnen Sie eine Anforderung, um alten und neuen Text Zeile für Zeile zu sehen, dazu Name, Artefakttyp, Platz im Modul und was Sie zum Vergleich gewählt haben: Links nach Linktyp, Tags, Kommentare und Attribute.
• Leicht zu navigieren: Überschriften heben sich in der Liste ab und lassen sich mit ihrem +/−-Kästchen zuklappen, und die Suche und die Listen darüber grenzen die Liste nach Text, Artefakttyp oder Überschriften ein.
• In beide Richtungen: Swap dreht den Vergleich sofort um, ohne etwas neu zu lesen.
• Auch die Struktur: Anforderungen, die in ein anderes Kapitel verschoben wurden oder Reihenfolge oder Ebene geändert haben, werden so markiert.
• Bereit für Review oder Audit: Der Vergleich geht nach Excel, im selben Layout wie jedes SmarterWidgets-Protokoll, mit Zahlen und beiden Konfigurationen.
• Sicher für alle: Das Widget liest nur, jeder kann es jederzeit verwenden.

So wird es verwendet

1. Öffnen Sie das Modul. Unter Compare zeigt From die Konfiguration, in der Sie arbeiten. Wählen Sie unter To die Baseline oder den Stream zum Vergleich: zuerst die Baselines dieses Streams, dann die anderen Streams und Baselines der Komponente. Swap dreht den Vergleich um.
2. Klicken Sie unter Attributes to compare auf Change und kreuzen Sie an, was verglichen werden soll: Primary Text (Contents), Tags, Comments, Attribute wie Status oder Priorität und Linktypen, oder Select all. Name, Artefakttyp und Platz im Modul werden immer verglichen.
3. Klicken Sie auf Compare module. Ein Fortschrittsbalken zeigt den Stand; Sie können jederzeit anhalten.
4. Das Ergebnis zählt hinzugefügte (nur in To), entfernte (nur in From), geänderte und unveränderte Anforderungen. Differences listet die Änderungen unter ihren Überschriften; das Suchfeld und die Listen darüber grenzen die Liste nach Text, Artefakttyp oder Überschriften ein, und All artifacts listet alle Anforderungen.
5. Öffnen Sie eine Anforderung, um den Text vorher und nachher Zeile für Zeile und ihre Attribute nebeneinander zu sehen. Show in module führt zu ihr.
6. Log neben dem Ergebnis (oder das Download-Symbol an Differences) speichert den Vergleich für ein Review oder Audit in Excel.

Gut zu wissen

• Texte werden als reiner Text verglichen: Eine reine Formatierungsänderung (fett, Farbe) zählt nicht als Änderung.
• Links, Tags und Kommentare werden in beiden Konfigurationen auf dieselbe Weise gelesen, so dass nur echte Unterschiede erscheinen.
• In einer globalen Konfiguration wird das Modul innerhalb seiner eigenen Komponente verglichen, mit deren Streams und Baselines.
• Sehr große Module lassen sich in Teilen vergleichen: Lauf anhalten, Seite neu laden, das Modul wieder öffnen und mit Continue dort weitermachen, wo er angehalten wurde.
• Anforderungen, die in der anderen Konfiguration nicht gelesen werden konnten, werden als nicht verglichen aufgeführt, mit dem Grund.