# Captions

> Nummeriert jede Abbildungs- und Tabellenbeschriftung eines Moduls nach ihrem Kapitel, Fig. 2.1, Table 2.1, in einem Durchlauf.

Source: https://widgets.doorsnext.com/de/widgets/captions/

- Disziplin: Inhaltsqualität
- Einsatzort: IBM DOORS Next-Modul
- Unterstützte Produkte: RM (IBM Engineering Requirements Management DOORS Next (Requirements Management))
- Ändert Daten
- Keywords: Beschriftungen nummerieren, Abbildungsnummern, Tabellennummern, nummerierte Beschriftungen, Abbildungsbeschriftungen in Anforderungen, Tabellenbeschriftungen, DOORS Next Dokumentnummerierung
- Version: 2.6 (Veröffentlicht 2026-10-28)
- Vendor: SmarterProcess (https://doorsnext.com, info@smarterprocess.pl)
- Arbeitsablauf: 1. Ein Modul öffnen → 2. Jede Nummer in der Vorschau sehen → 3. Number captions bestätigen → 4. Beschriftungen nach Kapitel nummeriert → 5. Änderungsbericht in Excel

## Was es ist und warum es existiert
Spezifikationen, die nach Word oder PDF exportiert werden, brauchen nummerierte Abbildungen und Tabellen, nummeriert nach Kapitel: Fig. 2.1, Fig. 2.2, Table 2.1. In DOORS Next ist eine Beschriftung ein eigenes Artefakt unter dem Bild oder der Tabelle, die sie beschreibt, und ihre Nummer ist einfacher Text. Jedes neue Bild, jeder verschobene Abschnitt und jedes neue Kapitel bringt die Nummerierung durcheinander, und sie von Hand zu korrigieren heißt, eine Beschriftung nach der anderen zu öffnen.

Captions nummeriert alle Beschriftungen eines Moduls in einem Durchlauf. Es liest die Kapitel des Moduls, ermittelt die Nummer jeder Abbildungs- und Tabellenbeschriftung, zeigt sie zuerst an und schreibt sie dann, wobei nur die alte Nummer am Anfang jeder Beschriftung ersetzt wird.

## Gelöste Probleme
- Abbildungs- und Tabellennummern, die nicht mehr zu den Kapiteln passen, nachdem Abschnitte hinzugefügt, verschoben oder gelöscht wurden.
- Zwei Abbildungen mit derselben Nummer oder Lücken in der Nummerierung, die erst im exportierten Dokument auffallen.
- Stundenlang eine Beschriftung nach der anderen öffnen, um vor einem Review oder Release Nummern von Hand einzutippen.
- Beschriftungen mit unterschiedlichen Nummernformaten („Figure 3:“, „Fig. 1.2“, gar keine Nummer) in einem Dokument.

## Vorteile
- **Nach Kapitel nummeriert:** Fig. 2.1, Fig. 2.2, Table 2.1, mit getrennten Zählern für Abbildungen und Tabellen, die in jedem Kapitel neu beginnen.
- **Erst ansehen:** Eine Vorschau listet jede Beschriftung mit ihrer jetzigen und der neuen Nummer auf, bevor sich etwas ändert.
- **Der Beschriftungstext bleibt:** Nur die alte Nummer wird ersetzt; die Wörter und ihr Fett- oder Kursivdruck bleiben, wie sie waren.
- **Sicher wiederholbar:** Beschriftungen, die bereits die richtige Nummer haben, werden nicht geschrieben, und ein Excel-Änderungsbericht hält jeden Text vorher und nachher fest.

## Verwendung
1. **Voraussetzung:** Captions funktioniert nur, wenn es im Projekt einen Artefakttyp namens **Caption** gibt. Die Beschriftungen sind Artefakte dieses Typs, jeweils unter ihrem Bild oder ihrer Tabelle; ein Attribut Caption Type (Figure oder Table) ist optional.
2. Öffnen Sie das Modul. Klicken Sie unter **Settings** auf **Change**, wählen Sie in **New number at headings up to**, welche Überschriftenebene eine neue Nummer beginnt (Ebene 1: 1.1, 1.2 … dann 2.1), und in **Caption text after the number** **Keep the text**, **Only the number (remove the text)** oder ein Attribut des Bildes oder der Tabelle, etwa **Name**. Klicken Sie auf **Done**.
3. Klicken Sie unter **Module** auf **Preview**, um jede Beschriftung unter **Captions** mit ihrer jetzigen Nummer, der neuen und ihrem neuen Text zu sehen. Öffnen Sie eine Zeile und klicken Sie auf **Show in module**, um diese Beschriftung im Modul anzuzeigen.
4. Klicken Sie auf **Number**, lesen Sie die Bestätigung und klicken Sie auf **Number captions**. Der Ergebnisblock zeigt, wie viele Beschriftungen nummeriert, hinzugefügt, bereits richtig oder fehlgeschlagen sind, und **Log** lädt den Änderungsbericht herunter.

## Gut zu wissen
- Führen Sie Captions in einem Änderungsset aus, damit Sie es verwerfen können, wenn das Ergebnis nicht passt.
- Beschriftungen vor dem ersten Kapitel erhalten Kapitel 0 (Fig. 0.1). Eine Beschriftung ohne Caption Type wird ohne Wort nummeriert, mit einem eigenen Zähler.
- Das Attribut Caption Type ist optional: Ohne es erkennt Captions Abbildung oder Tabelle am Wort der alten Nummer (Fig., Table) oder an der Abbildung oder Tabelle neben der Beschriftung. Eine Abbildung oder Tabelle ohne Beschriftung erhält direkt darunter eine neue; das lässt sich in Settings abschalten.
- Standardmäßig wird die Beschriftung zentriert und der Name ihres Artefakts geleert, wie im ursprünglichen Captions-Widget; beides lässt sich unter Settings abschalten.
- Der Beschriftungstyp, sein Attribut und die Wörter vor den Nummern (Fig., Table) lassen sich in den Widget-Einstellungen ändern, zum Beispiel für Beschriftungen in einer anderen Sprache.
- Captions kann auch den Beschriftungstext für Sie schreiben: Wählen Sie in Settings ein Attribut der Abbildung oder Tabelle (zum Beispiel ihren Name), und sein Wert wird nach der Nummer anstelle des alten Textes geschrieben, wie in Fig. 1.2 Battery pack layout; ein leerer Wert lässt nur die Nummer stehen. Wählen Sie Only the number, um den Text aus allen Beschriftungen zu entfernen, oder Keep the text, um nur die Nummern zu ändern.
