Primary Text Manager

概要と開発の背景

多数の成果物のテキストを同じように変更したい場面はよくあります。先頭に「DRAFT:」のような状態マークを付ける、末尾に「(TBC)」のような注記を付ける、すべてに同じ定型文を入れる、あるいはインポート後にテキストを属性や新しい成果物に移したためテキストを空にする、といった場合です。

DOORS Next では、リッチ・テキスト・エディターで成果物を 1 つずつ編集するしかありません。Primary Text Manager は、モジュール全体または選択範囲に対してこれを 1 回の実行で行い、プライマリー・テキストだけを変更します。成果物の ID、属性、リンク、モジュール内の位置はそのまま保たれます。

解決する課題

• 同じマーク、注記、文を付けるために数百個の成果物のテキストを 1 つずつ編集する手間。
• 新しいモジュールに残ったテンプレートやプレースホルダーのテキスト (「TBD」、古い仕様からコピーしたテキスト)。
• 内容を属性や他の成果物にコピーしたインポート後に生じる重複テキスト。
• 一括でテキストを変更した後、何が変わったかの記録がなく、元に戻すのも簡単ではない。

メリット

• 1 つのウィジェットで 4 種類の変更: テキストを空にする、接頭辞を付ける、接尾辞を付ける、独自のテキストに置き換える。
• 変わるのはテキストだけです。 名前、属性、リンク、モジュール構造はそのまま残ります。
• モジュール全体をワンクリックで： 一度確認するだけで、変更が必要な成果物はすべて変更され、それ以外はスキップされます。
• 二重に付けません。 すでにある接頭辞や接尾辞は再度付けず、見出しはデフォルトで保護されます。
• モジュール全体を 1 回で処理できます。 選択時の 200 個の上限はなく、各テキストの変更前と変更後を Excel の変更レポートに残します。

使い方

1. Settings で Change をクリックし、What to do で Empty、Add prefix、Add suffix、Replace text のいずれかを選び、テキストを入力して Done をクリックします。
2. モジュールを開きます。Apply で Whole module のまま、アクションタイル（例：Add prefix）をクリックします。何が書き込まれるかを示す確認を読み、赤いボタンで確定します。
3. ウィジェットはモジュール全体を一度に変更します。実行中は進行状況が表示され、いつでも停止できます。終了すると、結果ブロックに処理、変更、変更不要、失敗した成果物の件数が表示され、Log で変更レポートをダウンロードできます。
4. 一部の成果物だけを変更するには、DOORS Next でそれらを選択して Selection を選びます。タイルの下の行に、変更される件数とそのままになる成果物が表示されます。タイルをクリックして確定します。

知っておきたいこと

• Primary Text Manager は変更セットの中で実行してください。結果が意図どおりでなければ、変更セットを破棄できます。
• 接頭辞や接尾辞は、スペースも含めて入力したとおりに追加され、最初または最後の段落の書式を引き継ぎます。テキストのない成果物には接頭辞も接尾辞も付きません。
• すでにある接頭辞や接尾辞をもう一度追加したい場合や、空のテキストにも追加したい場合は、Settings で Change even if no change is needed をオンにします。
• 画像などのファイルは決して変更されません。見出しも変更したい場合に限り、Settings の Leave headings as they are のチェックを外してください。