# Style Cleaner

> Usuwa czcionki, kolory i marginesy, które Word i inne narzędzia zostawiają w treści wymagań, aby każdy artefakt wyglądał tak, jak przewiduje DOORS Next.

Source: https://widgets.doorsnext.com/pl/widgets/style-cleaner/

- Dyscyplina: Jakość treści
- Działa w: Moduł IBM DOORS Next
- Obsługiwane produkty: RM (IBM Engineering Requirements Management DOORS Next (Requirements Management))
- Zmienia dane
- Keywords: usuwanie formatowania Word, czyszczenie tekstu wymagań, style inline, czcionki i kolory, porządkowanie formatowania, kopiowanie z Worda, rich text cleanup, remove Word formatting, IBM DOORS Next
- Wersja: 3.41 (Data wydania 2026-10-27)
- Vendor: SmarterProcess (https://doorsnext.com, info@smarterprocess.pl)
- Film: https://www.youtube.com/watch?v=zOZanO6FYKw
- Przebieg pracy: 1. Otwórz moduł → 2. Znajduje artefakty ze stylami inline → 3. Sprawdź listę i style każdego artefaktu → 4. Usuń style ze wszystkich (W razie potrzeby: Tylko niektóre: zaznacz je i użyj Selection) → 5. Raport zmian w Excelu

## Czym jest i dlaczego powstał
Wymagania rzadko powstają bezpośrednio w DOORS Next. Są wklejane z Microsoft Word, importowane z ReqIF lub Excela albo kopiowane z wiadomości e-mail. Każde z tych źródeł wnosi ukryte formatowanie: czcionki, rozmiary, kolory, interlinię i marginesy zapisane wewnątrz tekstu artefaktu.

W efekcie każdy akapit modułu wygląda nieco inaczej, generowane z niego dokumenty sprawiają nieprofesjonalne wrażenie, a w innym motywie tekst bywa wręcz nieczytelny. Ręczne usuwanie tego formatowania oznacza otwieranie każdego artefaktu w edytorze tekstu sformatowanego. Style Cleaner powstał, aby zrobić to dla całego modułu za jednym razem.

## Jakie problemy rozwiązuje
- Specyfikacje z pomieszanymi czcionkami, rozmiarami i kolorami po imporcie z Worda, Excela lub innych narzędzi.
- Publikowane dokumenty i raporty, które przejmują obce formatowanie.
- Brak możliwości sprawdzenia w standardowym interfejsie, które artefakty zawierają ukryte formatowanie i w jakim zakresie.
- Ręczne porządkowanie, które w dużych modułach zajmuje godziny i często zostaje przerwane w połowie.

## Korzyści
- **Spójny wygląd** każdego artefaktu – w DOORS Next i w każdym generowanym z niego dokumencie.
- **Najpierw przejrzystość:** zanim cokolwiek zostanie zmienione, widżet pokazuje, które artefakty zawierają formatowanie i które właściwości (np. czcionki lub kolory) występują najczęściej.
- **Całe moduły w jednym przebiegu,** bez limitu 200 artefaktów obowiązującego dla zaznaczenia.
- **Usuwane jest wyłącznie formatowanie.** Tekst, tabele, listy, obrazy i linki pozostają bez zmian.
- **Dowód wykonania:** raport zmian w Excelu rejestruje każdy oczyszczony artefakt.

## Jak używać
1. Otworzyć moduł, wybrać **Whole module** w sekcji **Clean** i kliknąć **Find**. Nic się jeszcze nie zmienia: widżet pokazuje, ile artefaktów sprawdził, ile z nich zawiera formatowanie, ile mają atrybutów stylu i jakie właściwości występują najczęściej.
2. Kliknąć dowolny artefakt na liście, aby zobaczyć, jakie dokładnie formatowanie zawiera, element po elemencie, oraz **Show in module**, aby do niego przejść.
3. Kliknąć **Remove styles**, przeczytać krótkie potwierdzenie i kliknąć w nim **Remove styles**. Karta postępu pokazuje przebieg, a **Stop** pozwala go w każdej chwili zatrzymać.
4. Aby oczyścić tylko wybrane artefakty, zaznaczyć je w DOORS Next i wybrać **Selection · N**: widżet od razu je sprawdza. Następnie kliknąć **Remove styles** i potwierdzić.
5. Na końcu wynik pokazuje, ile artefaktów oczyszczono i ile stylów usunięto. Kliknięcie **Log** pobiera raport zmian w Excelu.

## Warto wiedzieć
- Style Cleaner warto uruchamiać w zestawie zmian (change set), aby przed dostarczeniem przejrzeć wynik.
- **Highlight in module** zaznacza w DOORS Next wszystkie objęte zmianą artefakty, niczego nie modyfikując – na przykład w celu ich wcześniejszego przeglądu.
- Typowe momenty użycia: tuż po imporcie, przed przeglądem i przed publikacją dokumentu.
- Bez otwartego modułu (w widoku kolekcji lub folderu) **Whole module** jest zablokowane, a widżet pracuje tylko na zaznaczonych artefaktach.
- Przy bardzo dużych modułach przeglądarka może zwolnić, bo DOORS Next trzyma w pamięci każdy odczytany artefakt. Należy zatrzymać przebieg przyciskiem **Stop**, przeładować stronę i ponownie otworzyć moduł: **Continue from …** kontynuuje od artefaktu, na którym przebieg się zatrzymał.
- W **Settings** decyduje się, co zostanie usunięte. Na początku zaznaczone są tylko style wbudowane. Można dodać inne stare atrybuty formatowania, takie jak wyrównanie, szerokość czy kolor tła, oraz znaczniki formatowania, takie jak pogrubienie, kursywa, podkreślenie, czcionka czy indeks górny. Usunięty znacznik zostawia swój tekst na miejscu, a wybór jest zapamiętany w przeglądarce.