Attribute Linker

概要と開発の背景

要件を Excel、ReqIF、DOORS 9 から取り込むと、トレーサビリティはほとんどの場合リンクではなくテキストとして届きます。「Parent ID」「Satisfies」「Derived from」のような列に、1 つ以上の ID やレガシー・キーが入っている形です。標準の画面では、これらの参照を成果物ごとに 1 つずつ手作業でリンクに変える必要があります。

Attribute Linker はその属性を読み取り、各参照が指す成果物を見つけ、1 回の実行でリンクを作成します。ターゲットは、プロジェクト全体での DOORS Next ID、またはターゲット・モジュール内の属性 (例:「Legacy ID」) の値で検索します。

解決する課題

• トレーサビリティがリンクではなく、属性内のテキストとしてインポートされている。
• 移行後に数百から数千のリンクを手作業で作成しなければならない。
• 何も指していない、または複数の成果物を指す参照に、かなり後になって気付く。
• どのリンクを作成し、どの参照を解決できなかったかの記録がない。

メリット

• すべての参照を記録: 実行後、各参照は Linked、Already linked、Not found、Ambiguous、Self reference のいずれかとして一覧表示されます。
• 推測しない: 複数の成果物に一致する参照は除外され、候補とともに一覧表示されます。
• 柔軟な照合: DOORS Next ID、またはターゲット・モジュールの属性に保存されたレガシー・キーで照合。カンマ、セミコロン、スペース、改行で区切られたリストに対応します。
• 安全な既定値: リンクはモジュール・コンテキストで作成されます (DOORS Next がモジュール内でリンクするときと同じ)。ベース成果物上のリンクは選択した場合のみです。
• 中断しても立て直せる実行: 既存のリンクはスキップ、進捗表示と Stop、非常に大きなモジュールでは停止後の再開、失敗時の Retry、未解決の参照の Excel 一覧、Excel 変更レポート。

使い方

1. モジュールの横の ELM Mini Dashboard にウィジェットを追加します。
2. Settings で Change をクリックし、参照を保持する Reference attributes、区切り文字、ターゲットの検索方法 (Artifact ID、またはターゲット・モジュールの Attribute in a module)、Link type、Direction を指定して Done をクリックします。
3. Links で Whole module を選ぶか、成果物を選択して Selection を選びます。
4. Create links をクリックし、確認内容を読んで確定します。ウィジェットが 1 回の実行で参照を検出し、不足しているリンクを作成します。
5. 結果ブロックと References の一覧を確認します。Not resolved フィルターで、リンクできなかった参照が理由とともに表示されます。必要に応じて Excel にエクスポートし、Log で変更レポートをダウンロードします。

知っておきたいこと

• あいまいな参照と成果物自身を指す参照はリンクされません。一覧に表示され、Excel にエクスポートできます。
• 実行中に属性値が変更された成果物は変更されず、一覧に表示されます。もう一度 Create links を実行してください。
• すべての参照がリンクされた属性を空にするオプション設定があります (既定ではオフ)。
• グローバル構成で作業している場合、ターゲット・モジュールと ID で見つかった成果物は、同じグローバル構成の別のコンポーネントにあってもかまいません。その場合、リンクはコンポーネント間をつなぎます。単一の stream または baseline では、開いているコンポーネントだけが使われます。
• 必ず change set の中で作業してください。作成したリンクを取り消せるのは、change set を破棄する場合だけです。