# Primary Text Manager

> Czyści tekst wielu artefaktów naraz, dodaje do niego prefiks lub sufiks albo zamienia go na Twój tekst i nie zmienia niczego innego.

Source: https://widgets.doorsnext.com/pl/widgets/primary-text-manager/

- 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: czyszczenie tekstu wymagań, pusty tekst główny, prefiks w wymaganiach, sufiks w wymaganiach, zamiana tekstu wymagań, masowa zmiana tekstu, masowa edycja DOORS Next
- Wersja: 1.14 (Data wydania 2026-10-28)
- Vendor: SmarterProcess (https://doorsnext.com, info@smarterprocess.pl)
- Przebieg pracy: 1. Wybierz Empty, prefiks, sufiks lub zamianę → 2. Otwórz moduł i potwierdź → 3. Tekst główny zmieniony w jednym przebiegu (W razie potrzeby: Tylko niektóre: zaznacz je i użyj Selection) → 4. Raport zmian w Excelu

## Czym jest i dlaczego powstał
Tekst wielu artefaktów często trzeba zmienić w ten sam sposób: znacznik statusu, np. „DRAFT:”, na początku, uwaga, np. „(TBC)”, na końcu, to samo standardowe zdanie wszędzie albo brak tekstu, bo po imporcie trafił on do atrybutów lub nowych artefaktów.

DOORS Next pozwala na to tylko artefakt po artefakcie w edytorze tekstu sformatowanego. Primary Text Manager robi to dla całego modułu lub zaznaczenia w jednym przebiegu i zmienia wyłącznie tekst główny: artefakty zachowują identyfikatory, atrybuty, powiązania i miejsce w module.

## Jakie problemy rozwiązuje
- Ręczna edycja tekstu setek artefaktów, jeden po drugim, aby dodać ten sam znacznik, uwagę lub zdanie.
- Tekst z szablonu lub tekst zastępczy („TBD”, tekst skopiowany ze starej specyfikacji), który zostaje w nowym module.
- Zdublowany tekst po imporcie, który skopiował treść do atrybutów lub innych artefaktów.
- Brak zapisu tego, co zmieniła masowa zmiana tekstu, i brak łatwej drogi powrotu.

## Korzyści
- **Cztery zmiany w jednym widżecie:** wyczyszczenie tekstu, dodanie prefiksu, dodanie sufiksu albo zamiana na własny tekst.
- **Zmienia się tylko tekst.** Nazwa, atrybuty, powiązania i struktura modułu zostają dokładnie takie, jakie były.
- **Jedno kliknięcie dla całego modułu:** potwierdzasz raz, a każdy artefakt, który wymaga zmiany, ją dostaje; pozostałe są pomijane.
- **Nigdy dwa razy:** prefiks lub sufiks, który już jest, nie zostanie dodany ponownie, a nagłówki są domyślnie chronione.
- **Całe moduły w jednym przebiegu,** bez limitu 200 artefaktów zaznaczenia, oraz raport zmian w Excelu z każdym tekstem przed i po.

## Jak używać
1. W **Settings** kliknij **Change**, w **What to do** wybierz **Empty**, **Add prefix**, **Add suffix** lub **Replace text**, wpisz tekst i kliknij **Done**.
2. Otwórz moduł. W sekcji **Apply** zostaw **Whole module** i kliknij kafelek akcji, np. **Add prefix**. Przeczytaj potwierdzenie, które mówi, co zostanie zapisane, i potwierdź czerwonym przyciskiem.
3. Widżet zmienia cały moduł w jednym przebiegu. Postęp jest widoczny w trakcie, a przebieg można w każdej chwili zatrzymać; na końcu blok wyniku pokazuje, ile artefaktów przetworzono, ile zmieniono, ile nie wymagało zmiany i ile się nie udało, a **Log** pobiera raport zmian.
4. Aby zmienić tylko niektóre artefakty, zaznacz je w DOORS Next i wybierz **Selection**: linia pod kafelkiem mówi, ile się zmieni i które zostaną bez zmian. Kliknij kafelek i potwierdź.

## Warto wiedzieć
- Uruchamiaj Primary Text Manager w zestawie zmian (change set), aby móc go odrzucić, jeśli wynik nie jest taki, jak trzeba.
- Prefiks lub sufiks jest dodawany dokładnie tak, jak go wpiszesz, razem ze spacjami, i przejmuje formatowanie pierwszego lub ostatniego akapitu. Artefakty bez tekstu nie dostają prefiksu ani sufiksu.
- Aby dodać prefiks lub sufiks ponownie tam, gdzie już jest, albo także do pustych tekstów, zaznacz **Change even if no change is needed** w Settings.
- Obrazy i inne pliki nigdy nie są zmieniane. Odznacz **Leave headings as they are** w Settings tylko wtedy, gdy nagłówki też mają się zmienić.