# Attribute Linker

> Macht aus IDs und Schlüsseln in einem Attribut echte Links, für ein ganzes Modul oder eine Auswahl, nach einer Bestätigung.

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

- Disziplin: Links und Rückverfolgbarkeit
- Einsatzort: IBM DOORS Next-Modul
- Unterstützte Produkte: RM (IBM Engineering Requirements Management DOORS Next (Requirements Management))
- Ändert Daten
- Keywords: Links aus Attribut erstellen, Traceability importieren, Parent ID, Excel-Import Links, ReqIF-Import, DOORS 9-Migration, Legacy ID, Links massenhaft anlegen, Rückverfolgbarkeit
- Version: 1.19 (Veröffentlicht 2026-10-27)
- Vendor: SmarterProcess (https://doorsnext.com, info@smarterprocess.pl)
- Arbeitsablauf: 1. Settings: Referenzattribut, Linktyp, Richtung → 2. Whole module (Bei Bedarf: Oder Artefakte auswählen: Selection) → 3. Create links: nach Bestätigung → 4. Liste und nicht aufgelöste Referenzen prüfen → 5. Änderungsbericht in Excel

## Was es ist und warum es existiert
Wenn Anforderungen aus Excel, ReqIF oder DOORS 9 kommen, kommt die Rückverfolgbarkeit selten als Links an. Sie kommt als Text: eine Spalte wie „Parent ID“, „Satisfies“ oder „Derived from“ mit einer oder mehreren IDs oder Altschlüsseln. In der Standardoberfläche muss jede dieser Referenzen von Hand in einen Link umgewandelt werden, Artefakt für Artefakt.

Attribute Linker liest dieses Attribut, findet das Artefakt, das jede Referenz nennt, und legt die Links in einem Lauf an. Ziele werden über ihre DOORS Next-ID im ganzen Projekt gefunden oder über den Wert eines Attributs (zum Beispiel „Legacy ID“) in einem Zielmodul.

## Gelöste Probleme
- Rückverfolgbarkeit, die als Text in einem Attribut statt als Links importiert wurde.
- Hunderte oder Tausende Links, die nach einer Migration von Hand anzulegen sind.
- Referenzen, die auf nichts oder auf mehrere Artefakte zeigen und erst viel später auffallen.
- Kein Nachweis, welche Links angelegt wurden und welche Referenzen nicht aufgelöst werden konnten.

## Vorteile
- **Jede Referenz wird erfasst:** Nach dem Lauf wird jede Referenz als Linked, Already linked, Not found, Ambiguous oder Self reference aufgelistet.
- **Rät nie:** Eine Referenz, die zu mehreren Artefakten passt, wird ausgelassen und mit den Kandidaten aufgelistet.
- **Flexible Zuordnung:** über die DOORS Next-ID oder über einen Altschlüssel in einem Attribut eines Zielmoduls; Listen getrennt durch Kommas, Semikolons, Leerzeichen oder Zeilenumbrüche.
- **Sichere Voreinstellungen:** Links entstehen im Modulkontext, wie DOORS Next es innerhalb eines Moduls tut; Links an Basisartefakten nur, wenn Sie es wählen.
- **Läufe, die sich erholen:** vorhandene Links werden übersprungen, Fortschritt und Stopp, Fortsetzen nach einem Stopp bei sehr großen Modulen, Fehler mit Retry, eine Excel-Liste der nicht aufgelösten Referenzen und ein Excel-Änderungsbericht.

## Verwendung
1. Fügen Sie das Widget dem ELM Mini Dashboard neben dem Modul hinzu.
2. Klicken Sie unter **Settings** auf **Change** und geben Sie die **Reference attributes** mit den Referenzen, die Trennzeichen, die Art der Zielsuche (**Artifact ID** oder **Attribute in a module** eines Zielmoduls), den **Link type** und die **Direction** an; klicken Sie dann auf **Done**.
3. Wählen Sie unter **Links** die Option **Whole module**, oder wählen Sie Artefakte aus und dann **Selection**.
4. Klicken Sie auf **Create links**, lesen Sie die Bestätigung und bestätigen Sie. Das Widget findet die Referenzen und legt die fehlenden Links in einem Lauf an.
5. Prüfen Sie den Ergebnisblock und die Liste **References**: Der Filter **Not resolved** zeigt jede Referenz, die nicht verlinkt werden konnte, mit dem Grund. Exportieren Sie diese bei Bedarf nach Excel und laden Sie den Änderungsbericht über **Log** herunter.

## Gut zu wissen
- Mehrdeutige Referenzen und Referenzen auf das Artefakt selbst werden nie verlinkt; sie werden aufgelistet und lassen sich nach Excel exportieren.
- Ändert sich ein Attributwert während des Laufs, bleibt dieses Artefakt unverändert und wird aufgelistet: Führen Sie Create links erneut aus.
- Eine optionale Einstellung leert das Attribut, sobald alle seine Referenzen verlinkt sind; sie ist standardmäßig aus.
- Wenn Sie in einer globalen Konfiguration arbeiten, können das Zielmodul und die per ID gefundenen Artefakte auch in einer anderen Komponente derselben globalen Konfiguration liegen; die Links verbinden dann die Komponenten. In einem einzelnen Stream oder Baseline wird nur die geöffnete Komponente verwendet.
- Arbeiten Sie immer in einem Change Set: Nur sein Verwerfen nimmt angelegte Links zurück.