# Attribute Composer

> Füllt ein Attribut mit einem Wert, den Sie aus den Daten des Artefakts selbst zusammenstellen, für ein ganzes Modul auf einmal, mit Anzeige jedes neuen Werts, bevor etwas gespeichert wird.

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

- Disziplin: Inhaltsqualität
- Einsatzort: IBM DOORS Next-Modul
- Unterstützte Produkte: RM (IBM Engineering Requirements Management DOORS Next (Requirements Management))
- Ändert Daten
- Keywords: Attribut automatisch füllen, Attribute kombinieren, Attributwerte verketten, Anforderungstext in Attribut kopieren, Massenaktualisierung von Attributen, Namenskonvention, Label aus Attributen
- Version: 1.15 (Veröffentlicht 2026-10-27)
- Vendor: SmarterProcess (https://doorsnext.com, info@smarterprocess.pl)
- Arbeitsablauf: 1. Zielattribut und Bestandteile wählen → 2. Findet die Artefakte und stellt neue Werte zusammen → 3. Aktuelle und neue Werte prüfen (Bei Bedarf: Regel anpassen und erneut suchen) → 4. Werte nach Bestätigung schreiben → 5. Änderungsbericht in Excel

## Was es ist und warum es existiert
Viele Attribute in einem Anforderungsprojekt enthalten keine neue Information: Sie wiederholen in fester Form, was das Artefakt ohnehin schon hat. Ein kurzes Label aus ID und Priorität, ein Titel, der die Überschrift wiederholt, ein Schlüssel mit dem Artefakttyp, eine Kopie des Anforderungstexts als reiner Text für einen Bericht oder einen Export. Heute werden solche Felder von Hand gefüllt, Artefakt für Artefakt, oder sie bleiben leer, weil niemand die Zeit dafür hat.

Attribute Composer füllt sie in einem Lauf. Sie bauen einmal eine Regel (die Bestandteile des Werts und ihre Reihenfolge), und das Widget schreibt das Ergebnis in das gewählte Attribut, für jedes Artefakt eines Moduls oder nur für die ausgewählten, nachdem es genau gezeigt hat, was jedes Artefakt erhalten würde.

## Gelöste Probleme
- Attribute, die einer Namenskonvention folgen sollen („ID / Priorität / Name“) und bei manueller Eingabe auseinanderlaufen.
- Felder, die für Tausende von Artefakten leer bleiben, weil einzelnes Ausfüllen nicht realistisch ist.
- Der Anforderungstext, der als reiner Text in einem eigenen Attribut gebraucht wird, für Exporte, Berichte oder externe Werkzeuge.
- Doppelt eingegebene Werte, sodass eine Änderung im Quellattribut die Kopie nie erreicht.
- Keine Möglichkeit, vor dem Speichern zu sehen, was eine Massenaktualisierung tatsächlich schreiben würde.

## Vorteile
- **Eine Regel, ein ganzes Modul:** Bestandteile in der von Ihnen gewählten Reihenfolge: Attribute jedes Datentyps, der Name, die ID, der Artefakttyp, der Anforderungstext als reiner Text und eigener Text wie Trennzeichen.
- **Vorschau, bevor etwas geschrieben wird:** jedes Artefakt mit seinem aktuellen und seinem neuen Wert nebeneinander.
- **Sicher voreingestellt:** Nur leere Zielattribute werden gefüllt, sofern Sie das Überschreiben nicht ausdrücklich wählen; ein leeres Ergebnis wird nie geschrieben, und ein bereits korrekter Wert wird nicht erneut gespeichert.
- **Saubere Ergebnisse:** Ein leerer Bestandteil nimmt sein Trennzeichen mit, sodass nie „ID /  / Name“ entsteht.
- **Wiederverwendbar:** Regeln lassen sich unter einem Namen speichern und wieder laden, wenn dieselbe Aufgabe wiederkommt.
- **Nachweis:** Ein Excel-Änderungsbericht listet jedes Artefakt mit dem Wert vor und nach dem Lauf.

## Verwendung
1. Öffnen Sie ein Modul in DOORS Next. Klicken Sie im Bereich **Rule** auf **Change** und wählen Sie das **Target attribute**: ein Textattribut, ein Zahlenattribut, wenn der Wert eine Zahl ist, ein Aufzählungsattribut, wenn der Wert eine seiner Bezeichnungen ist, ein Ja/Nein- oder Datumsattribut oder den Namen des Artefakts.
2. Stellen Sie den Wert unter **Parts, in order** mit **Add attribute** und **Add text** zusammen: Jeder Bestandteil ist ein Attribut, der Name, die ID, der Artefakttyp, der Anforderungstext als reiner Text oder eigener Text wie ein Trennzeichen. Verschieben Sie Bestandteile mit den Pfeilen; die Zeile darunter zeigt die resultierende Regel.
3. Lassen Sie **Skip empty parts** und **Only fill empty targets** aktiviert oder deaktivieren Sie sie (deaktiviert werden vorhandene Werte überschrieben), wählen Sie einen **Artifact type**, wenn sich nur ein Typ ändern soll, und klicken Sie auf **Done**.
4. Wählen Sie im Bereich **Write** **Whole module** oder **Selection** (die in DOORS Next ausgewählten Artefakte) und klicken Sie auf **Find**. Die Liste zeigt den neuen Wert jedes Artefakts, das sich ändern würde; beim Öffnen einer Zeile sehen Sie das Attribut, seinen aktuellen und den neuen Wert sowie **Show in module**.
5. Klicken Sie auf **Write**, lesen Sie die Bestätigung und klicken Sie auf **Write N values**. Am Ende zeigt der Ergebnisblock, wie viele Werte geschrieben wurden, bereits korrekt waren, übersprungen wurden oder fehlgeschlagen sind; **Log** lädt den Excel-Änderungsbericht herunter, und fehlgeschlagene Artefakte lassen sich im selben Block erneut versuchen.
6. Um die Suche für das ganze Modul zu überspringen, klicken Sie auf **Write**, ohne vorher **Find** zu klicken: Nach einer Bestätigung wird die Regel in einem Durchgang auf jedes Artefakt des Moduls angewendet, und die Zahlen folgen am Ende.

## Gut zu wissen
- Arbeiten Sie immer in einem Änderungsset: Nur dessen Verwerfen bringt die vorherigen Werte zurück.
- Aufzählungen werden mit ihren Bezeichnungen geschrieben (mehrere Werte durch Kommas getrennt), Benutzer mit ihrem Namen, Datumsangaben als Jahr, Monat und Tag (YYYY-MM-DD).
- Der Anforderungstext wird als reiner Text geschrieben: Absätze, Listeneinträge und Tabellenzeilen werden zu Zeilen, die Formatierung entfällt.
- Gespeicherte Regeln sind persönlich: Sie bleiben in Ihrem eigenen Browser und werden weder mit Kollegen geteilt noch auf dem Server gespeichert.
- Ein sehr langer Wert wird nicht geschrieben; die Grenze lässt sich in den Widget-Einstellungen ändern.
- Bei sehr großen Modulen können Sie einen Lauf anhalten, die Seite neu laden und mit derselben Regel dort weitermachen, wo er aufgehört hat.