Attribute Composer

何であり、なぜ存在するのか

要求プロジェクトの属性の多くは新しい情報ではありません。成果物がすでに持っている内容を、決まった形で繰り返しているだけです。ID と優先度を並べた短いラベル、見出しを繰り返すタイトル、成果物タイプを含むキー、レポートやエクスポートのためにプレーンテキストにした要求テキストの写しなどです。こうした項目は今日、成果物ごとに手で入力されるか、誰も時間を割けないために空のまま残されています。

Attribute Composer は、それらを 1 回の実行で埋めます。ルール（値を構成するパーツとその順序）を一度作れば、ウィジェットはモジュール内のすべての成果物、または選択した成果物だけを対象に、各成果物が何を受け取るかを正確に示したうえで、選んだ属性へ結果を書き込みます。

解決する課題

• 命名規則（「ID / 優先度 / 名前」）に従うべき属性が、手入力のためにばらばらになる。
• 1 件ずつ入力するのは現実的でないため、何千もの成果物で項目が空のまま残る。
• エクスポート、レポート、外部ツールのために、要求テキストをプレーンテキストで別の属性に持たせたい。
• 同じ値を二重に入力しているため、元の属性を変更しても写しには反映されない。
• 一括更新が実際に何を書き込むのかを、保存前に確認する手段がない。

利点

• 1 つのルールでモジュール全体： 任意のデータ型の属性、名前、ID、成果物タイプ、プレーンテキストとしての要求テキスト、区切り文字などの独自テキストを、好きな順序で並べられます。
• 書き込む前にプレビュー： 各成果物の現在の値と新しい値を並べて確認できます。
• 既定で安全： 上書きを指定しない限り空の属性だけを埋め、空の結果は決して書き込まず、すでに正しい値は保存し直しません。
• きれいな結果： 空のパーツは区切り文字ごと省かれるため、「ID / / 名前」のようにはなりません。
• 再利用できる： ルールは名前を付けて保存し、同じ作業のときに読み込み直せます。
• 証跡： Excel の変更レポートに、成果物ごとの変更前後の値が記録されます。

使い方

1. DOORS Next でモジュールを開きます。Rule で Change をクリックし、Target attribute を選びます。テキスト属性、値が数値のときは数値属性、値がラベルの 1 つのときは列挙属性、はい/いいえ属性や日付属性、または成果物の名前です。
2. Parts, in order で Add attribute と Add text を使って値を組み立てます。各パーツは属性、名前、ID、成果物タイプ、プレーンテキストとしての要求テキスト、または区切り文字などの独自のテキストです。矢印で並べ替えると、パーツの下の行に結果のルールが表示されます。
3. Skip empty parts と Only fill empty targets をそのままにするかオフにし（オフにすると既存の値を上書きします）、1 つのタイプだけを変更する場合は Artifact type を選んで Done をクリックします。
4. Write で Whole module または Selection（DOORS Next で選択した成果物）を選び、Find をクリックします。変更される成果物ごとに新しい値が一覧表示され、行を開くと属性、現在の値、新しい値と Show in module が表示されます。
5. Write をクリックし、確認メッセージを読んで Write N values をクリックします。実行が終わると、結果ブロックに書き込まれた値、すでに正しかった値、スキップされた値、失敗した値の数が表示されます。Log で Excel の変更レポートをダウンロードでき、失敗した成果物は同じブロックから再試行できます。
6. モジュール全体で検索を省略するには、先に Find をクリックせずに Write をクリックします。確認後、ルールがモジュールのすべての成果物に 1 回のパスで適用され、件数は最後に表示されます。

知っておくとよいこと

• 必ず変更セットの中で作業してください。元の値に戻せるのは変更セットを破棄する方法だけです。
• 列挙はラベルで書き込まれ（複数値はカンマ区切り）、ユーザーは氏名で、日付は年-月-日の形式で書き込まれます。
• 要求テキストはプレーンテキストとして書き込まれます。段落、リスト項目、表の行は行になり、書式は失われます。
• 保存したルールは個人用です。ご自身のブラウザーに保存され、同僚と共有されることも、サーバーに保存されることもありません。
• 非常に長い値は書き込まれません。この上限はウィジェットの設定で変更できます。
• 非常に大きなモジュールでは、実行を停止してページを再読み込みし、同じルールで停止した場所から続行できます。