# Structure Writer

> Macht aus der Struktur eines Moduls Attributwerte (den Kapitelpfad, eine dokumentartige ID und eine Sortiernummer) für alle Artefakte auf einmal.

Source: https://widgets.doorsnext.com/de/widgets/structure-writer/

- Disziplin: Modulstruktur
- Einsatzort: IBM DOORS Next-Modul
- Unterstützte Produkte: RM (IBM Engineering Requirements Management DOORS Next (Requirements Management))
- Ändert Daten
- Keywords: Hierarchiepfad Attribut, Kapitelpfad, Abschnittsnummer als Attribut, formatierte ID, DOORS 9 ID Migration, Präfix und Suffix für IDs, laufende Nummer, Sortierattribut, automatische Nummerierung, Export in Modulreihenfolge, IBM DOORS Next
- Version: 1.16 (Veröffentlicht 2026-10-28)
- Vendor: SmarterProcess (https://doorsnext.com, info@smarterprocess.pl)
- Arbeitsablauf: 1. Unter Rules Werte einschalten, Zielattribute wählen → 2. Modul öffnen, Whole module oder Selection wählen → 3. Write und bestätigen: Pfad, ID und Nummer → 4. Änderungsbericht in Excel

## Was es ist und warum es existiert
In einem DOORS Next Modul ist der Platz einer Anforderung (in welchem Kapitel sie steht, welche Nummer sie hat, wo sie im Dokument vorkommt) nur in der Modulansicht sichtbar. Sobald Artefakte in einer modulübergreifenden Ansicht, einem Export, einem Filter, einem Bericht oder einem anderen Werkzeug erscheinen, ist dieser Kontext weg. Teams, die von DOORS 9 kommen, vermissen außerdem ihre gewohnten Dokument-IDs wie „SRS-1234“.

Structure Writer kopiert die Struktur in Attribute, sodass sie mit dem Artefakt mitreist. Für jedes Artefakt eines Moduls kann er den Pfad der übergeordneten Kapitel schreiben („1 Einleitung > 1.2 Umfang“), eine formatierte ID aus Präfix, Artefakt-ID und Suffix („SRS-001234-A“) und eine Nummer, die in Modulreihenfolge wächst, zum Sortieren. Sie wählen, welche der drei Werte Sie brauchen und in welches Attribut jeder geht.

## Gelöste Probleme
- Exporte und modulübergreifende Ansichten verlieren das Kapitel, zu dem eine Anforderung gehört.
- Außerhalb des Moduls lassen sich Anforderungen nicht in Dokumentreihenfolge sortieren.
- Migrierte Projekte brauchen dokumentartige IDs mit Präfix, doch das Eintippen ist langsam und fehleranfällig.
- Alte Nummerierungswerkzeuge änderten ein Artefakt nach dem anderen und brauchten Minuten pro hundert Artefakte.
- Nach dem Verschieben oder Einfügen eines Kapitels sind von Hand gepflegte Pfade und Nummern unbemerkt falsch.

## Vorteile
- **Drei Werte in einem Lauf:** Hierarchiepfad, formatierte ID und laufende Nummer, jeder optional und jeder in seinem eigenen Attribut.
- **Flexibler Pfad:** jede Ebene als Abschnittsnummer und Name, nur Nummer, nur Name, ID oder ID und Name, mit eigenem Trennzeichen, mit oder ohne das Artefakt selbst.
- **Ganze Module, schnell:** keine Grenze von 200 Artefakten; die Struktur wird einmal gelesen, die Werte werden in Paketen gespeichert.
- **Vorher geprüft:** Bei einer Auswahl zeigt die Kachel Write, wie viele Artefakte sich ändern, und die Bestätigung, wie viele Pfade, IDs und Nummern geschrieben werden; bereits richtige Werte werden nie erneut gespeichert.
- **Bleibt korrekt:** nach einer Umstrukturierung einfach erneut ausführen, und nur geänderte Werte werden aktualisiert.
- **Nachweis:** ein Excel-Änderungsbericht mit jedem Wert vorher und nachher.

## Verwendung
1. Schalten Sie unter **Rules** die benötigten Werte ein und wählen Sie jeweils das Zielattribut: den Hierarchiepfad (Ebenenformat und Trennzeichen), die formatierte ID (Präfix, Suffix, Auffüllen mit Nullen) und die laufende Nummer (Start und Schrittweite).
2. Beschränken Sie den Lauf bei Bedarf auf einen Artefakttyp, lassen Sie Überschriften aus oder füllen Sie nur leere Ziele (**Additional settings**).
3. Öffnen Sie ein Modul, wählen Sie **Whole module** und klicken Sie auf **Write**: Lesen Sie die Bestätigung und klicken Sie auf **Write values**. Die Werte werden in einem Durchgang in das ganze Modul geschrieben, und nur Werte, die sich wirklich ändern, werden gespeichert.
4. Oder wählen Sie einige Artefakte im Modul aus und wählen Sie **Selection**: Die Kachel **Write** zeigt, wie viele davon sich ändern; klicken Sie auf **Write** und bestätigen Sie mit **Write values**. Ihre Pfade und Nummern stammen trotzdem aus dem ganzen Modul.
5. Das Ergebnis zählt geschriebene, bereits richtige, übersprungene und nicht gespeicherte Artefakte; **Log** speichert bei Bedarf den Änderungsbericht.

## Gut zu wissen
- Arbeiten Sie immer in einem Änderungssatz: Vorhandene Werte werden standardmäßig überschrieben, weil die Werte der Struktur folgen. Mit „Only fill empty targets“ bleiben von Hand eingegebene Werte erhalten.
- Attributwerte gehören zum Artefakt, nicht zu seinem Platz: Ein im Modul zweimal verwendetes Artefakt erhält die Werte seines ersten Platzes, ein auch in einem anderen Modul verwendetes Artefakt die Werte des Moduls, in dem das Widget zuletzt lief.
- Artefakte der obersten Ebene haben kein übergeordnetes Kapitel und erhalten nur dann einen Pfad, wenn das Artefakt selbst einbezogen wird.
- Die laufende Nummer zählt nur die geschriebenen Artefakte, in der Reihenfolge im Modul.
- Bei sehr großen Modulen können Sie einen Lauf stoppen, die Seite neu laden und dort weitermachen, wo er stoppte, mit denselben Einstellungen.