Find and Replace

概要と開発の背景

製品名が変わる、用語の名前が変わる、「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 … で同じ設定のまま停止した箇所から続行できます。