# Find and Replace

> Znajduje słowo lub frazę w całym module, pokazuje każde miejsce z nowym tekstem i zamienia je wszędzie naraz.

Source: https://widgets.doorsnext.com/pl/widgets/find-and-replace/

- 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: znajdź i zamień DOORS Next, zamiana tekstu w wymaganiach, masowa zamiana tekstu, zmiana nazwy pojęcia w module, globalna zamiana, wyszukiwanie i zamiana wymagań, masowa edycja DOORS Next
- Wersja: 2.10 (Data wydania 2026-10-28)
- Vendor: SmarterProcess (https://doorsnext.com, info@smarterprocess.pl)
- Przebieg pracy: 1. Wpisz, czego szukać i co wstawić → 2. Przeszukanie modułu i pokazanie każdego miejsca → 3. Sprawdź listę i potwierdź (W razie potrzeby: Tylko niektóre: zaznacz je i użyj Selection) → 4. Tekst zamieniony we wszystkich → 5. Raport zmian w Excelu

## Czym jest i dlaczego powstał
Zmienia się nazwa produktu, pojęcie dostaje nową nazwę, zastępczy „TBD” wreszcie ma wartość albo stara jednostka ma zniknąć. W specyfikacji liczącej setki wymagań ten sam tekst trzeba zmienić w wielu artefaktach naraz.

DOORS Next pozwala edytować tylko jeden artefakt naraz. Find and Replace przeszukuje cały moduł lub zaznaczenie, pokazuje każde miejsce z tekstem i to, jak będzie brzmiało po zmianie, a po jednym potwierdzeniu zamienia tekst wszędzie. Zmienia się tylko widoczny tekst: formatowanie, linki, obrazy i tabele zostają bez zmian.

## Jakie problemy rozwiązuje
- Otwieranie setek artefaktów po kolei, by zmienić to samo słowo lub frazę.
- Przeoczone miejsca: stare pojęcie zostaje w kilku wymaganiach, których nikt nie znalazł.
- Masowe zmiany, które psują formatowanie lub linki, bo zapisany tekst edytowano na ślepo.
- Brak zapisu tego, co zmieniła masowa operacja, i brak łatwej drogi powrotu.

## Korzyści
- **Najpierw zobacz, potem zmień:** każdy artefakt z tekstem, a przy każdym miejscu stary tekst przekreślony i nowy za nim.
- **Dokładne dopasowanie:** Match case i Whole words only, więc „pump” nie zmieni „pumps” ani „Pump”, chyba że tego chcesz.
- **Formatowanie zostaje:** pogrubienia, listy, linki i obrazy są zachowane; zmienia się tylko szukany tekst.
- **Także nazwy:** jeśli chcesz, przeszukuje nazwy artefaktów oprócz tekstu głównego.
- **Całe moduły w jednym przebiegu,** bez limitu 200 artefaktów zaznaczenia, z raportem zmian w Excelu z każdym tekstem przed i po.

## Jak używać
1. W **Settings** (gdy są zwinięte, kliknij **Change**) wpisz tekst w **Find what** i nowy tekst w **Replace with** (zostaw puste, aby usunąć tekst). Wybierz **Match case**, **Whole words only** i miejsce wyszukiwania: **Primary text**, **Name** lub oba. **Done** zwija Settings do jednej linii.
2. Otwórz moduł, wybierz **Whole module** w sekcji **Replace** i kliknij **Find**. Wynik pokazuje, ile artefaktów zawiera tekst i ile razy; rozwiń wiersz, by zobaczyć każde miejsce ze starym tekstem przekreślonym i nowym tuż za nim.
3. Kliknij **Replace**, przeczytaj potwierdzenie i kliknij **Replace in N artifacts**. Karta postępu pokazuje przebieg, a **Stop** pozwala go w każdej chwili zatrzymać. Kliknij **Log** w wyniku, aby pobrać raport zmian.
4. Aby zmienić tylko niektóre artefakty, zaznacz je w DOORS Next i wybierz **Selection · N**: widżet od razu je przeszukuje. Kliknij **Replace** i potwierdź.

## Warto wiedzieć
- Uruchamiaj Find and Replace w zestawie zmian (change set), aby móc go odrzucić, jeśli wynik nie jest taki, jak trzeba.
- Tekst jest wyszukiwany dokładnie tak, jak go wpisano, łącznie ze spacjami; nie ma symboli wieloznacznych. Spacja znajduje też spację nierozdzielającą.
- Tekst rozdzielony formatowaniem (część słowa pogrubiona) nie jest zamieniany; wyszukiwanie liczy takie miejsca, by można je poprawić ręcznie.
- Obrazy i inne pliki zachowują zawartość; po wybraniu Name zmienia się tylko ich nazwa.
- Na całym module **Replace** działa także bez wcześniejszego wyszukiwania: każdy artefakt jest odczytywany, a tekst zastępowany tam, gdzie występuje; liczby są znane na końcu.
- Przy bardzo dużych modułach przeglądarka może zwolnić. Zatrzymaj przebieg przyciskiem **Stop**, przeładuj stronę i ponownie otwórz moduł: **Continue from …** kontynuuje od miejsca zatrzymania, z tymi samymi ustawieniami.