# Find and Replace

> Findet ein Wort oder eine Wendung im ganzen Modul, zeigt jede Stelle mit dem neuen Text und ersetzt sie überall auf einmal.

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

- Disziplin: Inhaltsqualität
- Einsatzort: IBM DOORS Next-Modul
- Unterstützte Produkte: RM (IBM Engineering Requirements Management DOORS Next (Requirements Management))
- Ändert Daten
- Keywords: suchen und ersetzen DOORS Next, Text in Anforderungen ersetzen, Massenersetzung, Begriff im Modul umbenennen, globales Ersetzen, Anforderungen durchsuchen und ersetzen, DOORS Next Massenbearbeitung
- Version: 2.10 (Veröffentlicht 2026-10-28)
- Vendor: SmarterProcess (https://doorsnext.com, info@smarterprocess.pl)
- Arbeitsablauf: 1. Eingeben, was gesucht und was eingesetzt wird → 2. Modul durchsuchen und jede Stelle zeigen → 3. Liste prüfen und bestätigen (Bei Bedarf: Nur einige: auswählen und Selection nutzen) → 4. Text in allen ersetzt → 5. Änderungsbericht in Excel

## Was es ist und warum es existiert
Ein Produktname ändert sich, ein Begriff wird umbenannt, ein Platzhalter wie „TBD“ bekommt endlich seinen Wert, oder eine alte Einheit muss weg. In einer Spezifikation mit Hunderten von Anforderungen muss derselbe Text in vielen Artefakten auf einmal geändert werden.

DOORS Next kann nur ein Artefakt nach dem anderen bearbeiten. Find and Replace durchsucht ein ganzes Modul oder eine Auswahl, zeigt jede Stelle mit dem Text und wie sie danach lautet, und ersetzt den Text nach einer einzigen Bestätigung überall. Nur der sichtbare Text ändert sich: Formatierung, Links, Bilder und Tabellen bleiben, wie sie sind.

## Gelöste Probleme
- Hunderte Artefakte einzeln öffnen, um dasselbe Wort oder dieselbe Wendung zu ändern.
- Übersehene Stellen: ein alter Begriff bleibt in einigen Anforderungen, die niemand gefunden hat.
- Massenänderungen, die Formatierung oder Links zerstören, weil der gespeicherte Text blind bearbeitet wurde.
- Kein Nachweis, was eine Massenänderung getan hat, und kein einfacher Weg zurück.

## Vorteile
- **Erst sehen, dann ändern:** jedes Artefakt mit dem Text und für jede Stelle der alte Text durchgestrichen und der neue dahinter.
- **Genaue Treffer:** Match case und Whole words only, damit „pump“ weder „pumps“ noch „Pump“ ändert, wenn Sie es nicht wollen.
- **Formatierung bleibt:** Fettdruck, Listen, Links und Bilder bleiben erhalten; nur der gesuchte Text ändert sich.
- **Auch Namen:** auf Wunsch werden neben dem Haupttext auch die Artefaktnamen durchsucht.
- **Ganze Module in einem Lauf,** ohne die 200-Artefakte-Grenze von Auswahlen, und ein Excel-Änderungsbericht mit jedem Text vorher und nachher.

## Verwendung
1. Geben Sie in **Settings** (bei eingeklappten Einstellungen zuerst auf **Change** klicken) den Text in **Find what** und den neuen Text in **Replace with** ein (leer lassen, um den Text zu entfernen). Wählen Sie **Match case**, **Whole words only** und wo gesucht wird: **Primary text**, **Name** oder beides. **Done** klappt die Einstellungen auf eine Zeile ein.
2. Öffnen Sie ein Modul, wählen Sie unter **Replace** die Option **Whole module** und klicken Sie auf **Find**. Das Ergebnis zeigt, wie viele Artefakte den Text enthalten und wie oft; öffnen Sie eine Zeile, um jede Stelle mit dem durchgestrichenen alten und dem neuen Text dahinter zu sehen.
3. Klicken Sie auf **Replace**, lesen Sie die Bestätigung und klicken Sie auf **Replace in N artifacts**. Eine Fortschrittskarte zeigt den Lauf, und Sie können jederzeit mit **Stop** anhalten. Klicken Sie im Ergebnis auf **Log**, um den Änderungsbericht herunterzuladen.
4. Um nur einige Artefakte zu ändern, wählen Sie sie in DOORS Next aus und wählen Sie **Selection · N**: Das Widget durchsucht sie sofort. Klicken Sie auf **Replace** und bestätigen Sie.

## Gut zu wissen
- Führen Sie Find and Replace in einem Change Set aus, damit Sie es verwerfen können, wenn das Ergebnis nicht passt.
- Der Text wird genau so gesucht, wie er eingegeben wurde, Leerzeichen eingeschlossen; es gibt keine Platzhalterzeichen. Ein Leerzeichen findet auch ein geschütztes Leerzeichen.
- Ein durch Formatierung getrennter Text (ein Teil eines Wortes fett) wird nicht ersetzt; die Suche zählt solche Stellen, damit Sie sie von Hand korrigieren können.
- Bilder und andere Dateien behalten ihren Inhalt; nur ihr Name ändert sich, wenn Name gewählt ist.
- Für das ganze Modul funktioniert **Replace** auch ohne vorherige Suche: Jedes Artefakt wird gelesen und der Text dort ersetzt, wo er vorkommt; die Zahlen stehen am Ende fest.
- Bei sehr großen Modulen kann der Browser langsam werden. Halten Sie den Lauf mit **Stop** an, laden Sie die Seite neu und öffnen Sie das Modul wieder: **Continue from …** macht mit denselben Einstellungen dort weiter, wo der Lauf angehalten wurde.