# Base To Module Links

> Wandelt Links zwischen Basisartefakten in Links innerhalb des geöffneten Moduls um, sodass Rückverfolgbarkeit, die zu einem Modul gehört, in diesem Modul bleibt.

Source: https://widgets.doorsnext.com/de/widgets/base-to-module-links/

- 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 auf Basisartefakte, Links im Modulkontext, Links umwandeln, Rückverfolgbarkeit, Wiederverwendung von Anforderungen, Basislinks ins Modul, modulspezifische Links, base artifact links, module context links, traceability
- Version: 2.11 (Veröffentlicht 2026-10-27)
- Vendor: SmarterProcess (https://doorsnext.com, info@smarterprocess.pl)
- Arbeitsablauf: 1. Umzuwandelnde Linktypen markieren → 2. Find links: listet jeden Basislink (Bei Bedarf: Oder Selection: im Modul ausgewählte Artefakte) → 3. Convert now, prüfen und bestätigen → 4. Modullinks ersetzen Basislinks (Bei Bedarf: Fehlgeschlagen: Retry) → 5. Ergebnis mit Log, jeder Link in Excel

## Was es ist und warum es existiert
In DOORS Next kann ein Link zwischen den Basisartefakten oder im Kontext eines Moduls erstellt werden. Ein Link zwischen Basisartefakten erscheint in jedem Modul, das diese Anforderungen wiederverwendet. Gilt ein Link nur für ein Modul, zum Beispiel für eine Produktvariante oder ein Release, gehört er in den Kontext dieses Moduls: denselben Link im Modul anlegen, dann den Basislink löschen.

Von Hand dauert das lange, und Fehler passieren leicht. Base To Module Links wandelt die Links ganzer Module um, ohne einen einzigen Link zu verlieren. Es ist das Gegenstück zu Module To Base Links.

## Gelöste Probleme
- Rückverfolgbarkeit, die zu einem Modul gehört, aber in jedem anderen Modul mit denselben Anforderungen erscheint.
- Links, die versehentlich oder durch einen Import auf Basisebene angelegt wurden, aber Modullinks hätten sein sollen.
- Manuelle Umwandlung: für jeden Link das Artefakt jedes Endes im Modul finden, den neuen Link anlegen und den alten löschen.
- Das Risiko, Links zu verlieren, wenn die Umwandlung in der falschen Reihenfolge erfolgt.

## Vorteile
- **Modulspezifische Rückverfolgbarkeit:** Jedes Modul zeigt nur die Links, die zu ihm gehören.
- **Keine verlorenen Links:** Zuerst wird der Modullink angelegt; der Basislink wird erst gelöscht, wenn das erfolgreich war.
- **Sie bestimmen, was umgewandelt wird:** nur die ausgewählten Linktypen.
- **Vorschau und Excel-Export** aller Basislinks vor und nach der Umwandlung.
- **Änderungsbericht** mit dem Ergebnis jedes Links.

## Verwendung
1. Öffnen Sie das Modul. Klicken Sie unter **Link types** auf **Change**, markieren Sie die umzuwandelnden Linktypen und klicken Sie auf **Done**.
2. Wählen Sie unter **Convert** **Whole module** oder **Selection** (vorher Artefakte im Modul auswählen) und klicken Sie auf **Find links**. Noch ändert sich nichts: Das Ergebnis zeigt, wie viele Artefakte geprüft wurden, wie viele Basislinks haben und wie viele Links umgewandelt werden, und **Base links** listet sie auf.
3. Klicken Sie auf **Convert now** und bestätigen Sie mit **Convert N links**.
4. Das Ergebnis zeigt die umgewandelten Links, die geänderten Artefakte, die bereits im Modul vorhandenen Links und etwaige Fehler, mit **Retry** und dem **Log**. Das Download-Symbol an **Base links** speichert jeden Link samt Ergebnis in Excel.

## Gut zu wissen
- Ein umgewandelter Basislink verschwindet aus jedem anderen Modul, das diese Artefakte verwendet; arbeiten Sie in einem Änderungssatz (Change Set), um das Ergebnis zuerst zu prüfen.
- Mit **Keep base link** wird der Modul-Link erstellt und der ursprüngliche Basis-Link bleibt erhalten; es wird nichts gelöscht.
- Standardmäßig wird das andere Ende eines Links zu seinem Artefakt im selben Modul, sofern es dort vorhanden ist; eine Einstellung belässt es unverändert.
- Bereits im Modul bestehende Links werden erkannt und nicht doppelt angelegt.
- Links zu anderen ELM-Anwendungen (Testfälle, Arbeitselemente) werden nie verändert.
- Für das ganze Modul funktioniert **Convert now** auch ohne vorherige Suche: Es findet und wandelt die Links in einem Durchgang um, nach derselben Bestätigung.
- Ein Artefakt, das mehrmals im Modul verwendet wird, wird nur einmal gelistet und gezählt.
- Bei sehr großen Modulen können Sie **Stop** klicken, die Seite neu laden und mit **Continue from …** beim nächsten Artefakt weitermachen.