# Module Diff

> Pokazuje, co zmieniło się w module od linii bazowej, szybko, na jednej liście, ze starym i nowym tekstem obok siebie.

Source: https://widgets.doorsnext.com/pl/widgets/module-diff/

- Dyscyplina: Konfiguracja i nadzór
- Działa w: Moduł IBM DOORS Next
- Obsługiwane produkty: RM (IBM Engineering Requirements Management DOORS Next (Requirements Management))
- Tylko odczyt
- Keywords: porównanie modułu, porównanie z linią bazową, zmiany wymagań, co się zmieniło, przegląd zmian, diff, porównanie strumieni, zarządzanie konfiguracją, audyt
- Wersja: 1.14 (Data wydania 2026-10-28)
- Vendor: SmarterProcess (https://doorsnext.com, info@smarterprocess.pl)
- Przebieg pracy: 1. Otwórz moduł → 2. Wybierz baseline lub strumień oraz atrybuty → 3. Porównuje moduł z tą konfiguracją → 4. Podsumowanie i lista różnic → 5. Otwórz wymaganie: przed i po, obok siebie → 6. Log w Excelu do przeglądu lub audytu

## Czym jest i po co powstało
„Co zmieniło się w tym module od ostatniej linii bazowej?” to jedno z najczęstszych pytań przed przeglądem, wydaniem albo audytem. DOORS Next potrafi porównywać konfiguracje, ale na dużym module trwa to długo, a wynik trudno przejrzeć.

Module Diff odpowiada na to pytanie w ELM Mini Dashboard obok modułu. Wybierz linię bazową bieżącego strumienia albo inny strumień lub linię bazową tego samego komponentu, a widżet pokaże każde wymaganie dodane, usunięte, zmienione lub przeniesione, z tekstem przed i po. Widżet tylko czyta. W DOORS Next nic się nie zmienia.

## Jakie problemy rozwiązuje
- Porównanie dużego modułu z linią bazową trwa zbyt długo, więc jest pomijane albo robione dopiero na końcu.
- Recenzenci muszą szukać kilku zmienionych wymagań wśród tysięcy niezmienionych.
- Przeniesione wymagania i zmiany struktury łatwo przeoczyć.
- Przeglądy zmian i audyty wymagają zapisu tego, co się zmieniło, a ręczne zebranie go jest trudne.

## Korzyści
- **Szybko:** druga konfiguracja jest czytana partiami, a z tekstów zostają tylko krótkie odciski, więc nawet duże moduły porównuje się szybko.
- **Jedna lista:** dodane, usunięte i zmienione wymagania w kolejności modułu, z nagłówkami dla orientacji, albo wszystkie wymagania przez **All artifacts**.
- **Przed i po:** otwórz wymaganie, aby zobaczyć stary i nowy tekst linia po linii, nazwę, typ artefaktu, miejsce w module i to, co wybrano do porównania: powiązania według typu, tagi, komentarze i atrybuty.
- **Łatwo przejrzeć:** nagłówki są wyróżnione na liście i zwijają się polem +/−, a wyszukiwanie i listy nad nią zawężają ją według tekstu, typu artefaktu lub nagłówków.
- **W obu kierunkach:** **Swap** od razu odwraca porównanie, bez ponownego odczytu.
- **Także struktura:** wymagania przeniesione do innego rozdziału, ze zmienioną kolejnością lub poziomem są tak oznaczone.
- **Gotowe na przegląd lub audyt:** porównanie trafia do Excela w tym samym układzie co każdy log SmarterWidgets, z liczbami i nazwami obu konfiguracji.
- **Bezpieczne dla każdego:** widżet tylko czyta, więc każdy może go użyć w dowolnej chwili.

## Jak używać
1. Otwórz moduł. W sekcji **Compare** pole **From** pokazuje konfigurację, w której pracujesz. W **To** wybierz linię bazową lub strumień do porównania: najpierw linie bazowe tego strumienia, potem inne strumienie i linie bazowe komponentu. **Swap** odwraca porównanie.
2. W **Attributes to compare** kliknij **Change** i zaznacz, co ma być porównane: Primary Text (Contents), Tags, Comments, atrybuty, takie jak status lub priorytet, oraz typy powiązań, albo **Select all**. Nazwa, typ artefaktu i miejsce w module są porównywane zawsze.
3. Kliknij **Compare module**. Pasek postępu pokazuje stan; można przerwać w każdej chwili.
4. Wynik liczy wymagania dodane (tylko w To), usunięte (tylko w From), zmienione i niezmienione. **Differences** pokazuje zmiany pod ich nagłówkami; pole wyszukiwania i listy nad nią zawężają listę według tekstu, typu artefaktu lub nagłówków, a **All artifacts** pokazuje wszystkie wymagania.
5. Otwórz wymaganie, aby zobaczyć tekst przed i po, linia po linii, oraz jego atrybuty obok siebie. **Show in module** prowadzi do niego.
6. **Log** obok wyniku (albo ikona pobierania przy **Differences**) zapisuje porównanie w Excelu do przeglądu lub audytu.

## Warto wiedzieć
- Teksty są porównywane jako zwykły tekst: sama zmiana formatowania (pogrubienie, kolor) nie liczy się jako zmiana.
- Powiązania, tagi i komentarze są czytane w obu konfiguracjach w ten sam sposób, więc lista pokazuje tylko rzeczywiste różnice.
- W konfiguracji globalnej moduł jest porównywany w obrębie własnego komponentu, z jego strumieniami i liniami bazowymi.
- Bardzo duże moduły można porównać w częściach: zatrzymaj przebieg, przeładuj stronę, otwórz moduł ponownie i kliknij **Continue**, aby kontynuować od miejsca zatrzymania.
- Wymagania, których nie udało się odczytać w drugiej konfiguracji, są oznaczone jako nieporównane, z podaniem przyczyny.