# Captions

> Numera ogni didascalia di figura e tabella di un modulo in base al suo capitolo, Fig. 2.1, Table 2.1, in un solo passaggio.

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

- Disciplina: Qualità dei contenuti
- Funziona in: Modulo IBM DOORS Next
- Prodotti supportati: RM (IBM Engineering Requirements Management DOORS Next (Requirements Management))
- Modifica i dati
- Keywords: numerazione delle didascalie, numeri delle figure, numeri delle tabelle, didascalie numerate, didascalie delle figure nei requisiti, didascalie delle tabelle, numerazione documenti DOORS Next
- Versione: 2.6 (Rilasciata 2026-10-28)
- Vendor: SmarterProcess (https://doorsnext.com, info@smarterprocess.pl)
- Flusso di lavoro: 1. Aprire un modulo → 2. Vedere ogni numero in anteprima → 3. Confermare Number captions → 4. Didascalie numerate per capitolo → 5. Report delle modifiche in Excel

## Che cos'è e perché esiste
Le specifiche esportate in Word o PDF hanno bisogno di figure e tabelle numerate per capitolo: Fig. 2.1, Fig. 2.2, Table 2.1. In DOORS Next una didascalia è un artefatto a sé, posto sotto l'immagine o la tabella che descrive, e il suo numero è semplice testo. Ogni nuova immagine, ogni sezione spostata e ogni nuovo capitolo rompe la numerazione, e correggerla a mano significa aprire una didascalia dopo l'altra.

Captions numera tutte le didascalie di un modulo in un solo passaggio. Legge i capitoli del modulo, calcola il numero di ogni didascalia di figura e di tabella, li mostra prima e poi li scrive, sostituendo solo il vecchio numero all'inizio di ogni didascalia.

## Problemi che risolve
- Numeri di figure e tabelle che non seguono più i capitoli dopo che sono state aggiunte, spostate o eliminate delle sezioni.
- Due figure con lo stesso numero, o buchi nella numerazione, scoperti solo nel documento esportato.
- Ore passate ad aprire una didascalia dopo l'altra per digitare i numeri a mano prima di una revisione o di un rilascio.
- Didascalie con stili di numerazione diversi («Figure 3:», «Fig. 1.2», nessun numero) nello stesso documento.

## Vantaggi
- **Numerate per capitolo:** Fig. 2.1, Fig. 2.2, Table 2.1, con un contatore separato per figure e tabelle che riparte in ogni capitolo.
- **Prima si guarda:** un'anteprima elenca ogni didascalia con il numero attuale e quello nuovo, prima che cambi qualcosa.
- **Il testo della didascalia resta:** viene sostituito solo il vecchio numero; le parole e il loro grassetto o corsivo restano com'erano.
- **Si può rieseguire senza rischi:** le didascalie che hanno già il numero giusto non vengono scritte, e un report delle modifiche in Excel conserva ogni testo prima e dopo.

## Come si usa
1. **Requisito:** Captions funziona solo se nel progetto esiste un tipo di artefatto chiamato **Caption**. Le didascalie sono artefatti di quel tipo, ciascuna sotto la sua immagine o tabella; un attributo Caption Type (Figure o Table) è facoltativo.
2. Aprite il modulo. In **Settings** fate clic su **Change**, scegliete in **New number at headings up to** quale livello di titolo fa ripartire la numerazione (livello 1: 1.1, 1.2 … poi 2.1) e in **Caption text after the number** scegliete **Keep the text**, **Only the number (remove the text)** o un attributo dell'immagine o della tabella, ad esempio **Name**. Fate clic su **Done**.
3. In **Module** fate clic su **Preview** per vedere ogni didascalia in **Captions** con il numero attuale, quello nuovo e il nuovo testo. Aprite una riga e fate clic su **Show in module** per mostrare quella didascalia nel modulo.
4. Fate clic su **Number**, leggete la conferma e fate clic su **Number captions**. Il blocco dei risultati mostra quante didascalie sono state numerate, aggiunte, erano già corrette o non sono riuscite, e **Log** scarica il report delle modifiche.

## Da sapere
- Eseguite Captions in un change set, così potete scartarlo se il risultato non è quello voluto.
- Le didascalie prima del primo capitolo ricevono il capitolo 0 (Fig. 0.1). Una didascalia senza Caption Type viene numerata senza parola, con un contatore proprio.
- L'attributo Caption Type è facoltativo: senza di esso Captions distingue figure e tabelle dalla parola del vecchio numero (Fig., Table) o dalla figura o tabella vicina alla didascalia. Una figura o tabella senza didascalia ne riceve una nuova subito sotto; si può disattivare in Settings.
- Per impostazione predefinita la didascalia viene centrata e il nome del suo artefatto svuotato, come nel widget Captions originale; entrambe le opzioni si possono disattivare in Settings.
- Il tipo di didascalia, il suo attributo e le parole prima dei numeri (Fig., Table) si possono modificare nelle impostazioni del widget, per esempio per didascalie in un'altra lingua.
- Captions può anche scrivere il testo della didascalia per te: in Settings scegli un attributo della figura o della tabella (per esempio il suo Name) e il suo valore viene scritto dopo il numero al posto del vecchio testo, come in Fig. 1.2 Battery pack layout; un valore vuoto lascia solo il numero. Scegli Only the number per togliere il testo da tutte le didascalie, oppure Keep the text per cambiare solo i numeri.