# Find and Replace

> モジュール全体から語句を見つけ、各箇所を新しいテキストとともに表示し、すべてを一度に置換します。

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

- 分野: コンテンツ品質
- 動作環境: IBM DOORS Next のモジュール
- 対応製品: RM (IBM Engineering Requirements Management DOORS Next (Requirements Management))
- データを変更
- Keywords: DOORS Next 検索と置換, 要件のテキスト置換, テキスト一括置換, モジュール内の用語変更, 全体置換, 要件の検索と置換, DOORS Next 一括編集
- バージョン: 2.10 (リリース日 2026-10-28)
- Vendor: SmarterProcess (https://doorsnext.com, info@smarterprocess.pl)
- 作業の流れ: 1. 検索するテキストと置き換えるテキストを入力 → 2. モジュールを検索し各箇所を表示 → 3. 一覧を確認して承認 (必要に応じて: 一部だけ：選択して Selection を使用) → 4. すべての箇所でテキストを置換 → 5. Excel の変更レポート

## 概要と開発の背景
製品名が変わる、用語の名前が変わる、「TBD」のようなプレースホルダーにようやく値が決まる、古い単位を取り除く必要がある。数百件の要件を持つ仕様書では、同じテキストを多数の成果物で一度に変更しなければなりません。

DOORS Next では一度に 1 つの成果物しか編集できません。Find and Replace はモジュール全体または選択範囲を検索し、テキストがある各箇所と変更後の見え方を表示し、1 回の確認ですべてを置換します。変わるのは表示されるテキストだけで、書式、リンク、画像、表はそのまま残ります。

## 解決する課題
- 同じ語句を変えるために数百の成果物を 1 つずつ開くこと。
- 見落とし：誰も見つけられなかったいくつかの要件に古い用語が残ること。
- 保存されたテキストをやみくもに編集したために書式やリンクが壊れる一括変更。
- 一括変更で何が行われたかの記録がなく、簡単に元に戻せないこと。

## メリット
- **変更前に確認：**テキストを含むすべての成果物と、各箇所で取り消し線付きの古いテキストとその後ろの新しいテキストを表示します。
- **正確な一致：**Match case と Whole words only により、必要な場合を除き「pump」が「pumps」や「Pump」を変えることはありません。
- **書式はそのまま：**太字、リスト、リンク、画像は保持され、検索したテキストだけが変わります。
- **名前も対象に：**必要に応じて、プライマリーテキストに加えて成果物の名前も検索します。
- **モジュール全体を 1 回で処理：**選択時の 200 個の上限なしで処理し、すべてのテキストの変更前後を記録した Excel の変更レポートを作成します。

## 使い方
1. **Settings** で (折りたたまれている場合は **Change** をクリック)、**Find what** に検索するテキスト、**Replace with** に新しいテキストを入力します (空欄にするとテキストが削除されます)。**Match case**、**Whole words only**、検索対象 (**Primary text**、**Name**、または両方) を選びます。**Done** で Settings が 1 行に折りたたまれます。
2. モジュールを開き、**Replace** で **Whole module** を選んで **Find** をクリックします。結果に、テキストを含む成果物の数と出現回数が表示されます。行を展開すると、古いテキストに取り消し線が引かれ、その後に新しいテキストが続く形で各箇所を確認できます。
3. **Replace** をクリックし、確認内容を読んで **Replace in N artifacts** をクリックします。進捗はカードに表示され、いつでも **Stop** で停止できます。結果の **Log** をクリックすると変更レポートをダウンロードできます。
4. 一部の成果物だけを変更するには、DOORS Next でそれらを選択し、**Selection · N** を選びます。選択した成果物はすぐに検索されます。**Replace** をクリックして確認します。

## 知っておきたいこと
- 結果が意図どおりでない場合に破棄できるよう、Find and Replace は change set の中で実行してください。
- テキストはスペースを含め入力どおりに検索されます。ワイルドカードはありません。スペースはノーブレークスペースも検索します。
- 書式で分割されたテキスト（単語の一部が太字など）は置換されません。検索がその箇所を数えるので、手作業で修正できます。
- 画像やその他のファイルの内容は変わりません。Name を選んだ場合は名前だけが変わります。
- モジュール全体では、検索せずに **Replace** を実行することもできます。すべての成果物を読み込み、テキストがある箇所で置換し、数値は最後にわかります。
- 非常に大きなモジュールではブラウザーが遅くなることがあります。**Stop** で停止し、ページを再読み込みしてモジュールを開き直すと、**Continue from …** で同じ設定のまま停止した箇所から続行できます。