# Attribute Linker

> 属性に保存された ID やキーを、モジュール全体または選択範囲に対して、確認のうえで本物のリンクに変換します。

Source: https://widgets.doorsnext.com/ja/widgets/attribute-linker/

- 分野: リンクとトレーサビリティー
- 動作環境: IBM DOORS Next のモジュール
- 対応製品: RM (IBM Engineering Requirements Management DOORS Next (Requirements Management))
- データを変更
- Keywords: 属性からリンク作成, トレーサビリティのインポート, Parent ID, Excel インポート リンク, ReqIF インポート, DOORS 9 移行, レガシー ID, リンクの一括作成, トレーサビリティ
- バージョン: 1.19 (リリース日 2026-10-27)
- Vendor: SmarterProcess (https://doorsnext.com, info@smarterprocess.pl)
- 作業の流れ: 1. Settings：参照属性、リンク・タイプ、方向 → 2. Whole module (必要に応じて: または成果物を選択：Selection) → 3. Create links：確認後に作成 → 4. 一覧と未解決の参照を確認 → 5. Excel の変更レポート

## 概要と開発の背景
要件を 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 を破棄する場合だけです。