Captions

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.