# Captions

> Numérote chaque légende de figure et de tableau d'un module selon son chapitre, Fig. 2.1, Table 2.1, en une seule passe.

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

- Discipline: Qualité du contenu
- Fonctionne dans: Module IBM DOORS Next
- Produits pris en charge: RM (IBM Engineering Requirements Management DOORS Next (Requirements Management))
- Modifie les données
- Keywords: numérotation des légendes, numéros de figures, numéros de tableaux, légendes numérotées, légendes de figures dans les exigences, légendes de tableaux, numérotation de documents DOORS Next
- Version: 2.6 (Publiée le 2026-10-28)
- Vendor: SmarterProcess (https://doorsnext.com, info@smarterprocess.pl)
- Déroulement: 1. Ouvrir un module → 2. Voir chaque numéro en aperçu → 3. Confirmer Number captions → 4. Légendes numérotées par chapitre → 5. Rapport de modifications dans Excel

## Ce que c'est et pourquoi il existe
Les spécifications exportées vers Word ou PDF ont besoin de figures et de tableaux numérotés par chapitre : Fig. 2.1, Fig. 2.2, Table 2.1. Dans DOORS Next, une légende est un artefact à part entière, placé sous l'image ou le tableau qu'il décrit, et son numéro n'est que du texte. Chaque nouvelle image, chaque section déplacée et chaque nouveau chapitre casse la numérotation, et la corriger à la main oblige à ouvrir les légendes une par une.

Captions numérote toutes les légendes d'un module en une seule passe. Il lit les chapitres du module, calcule le numéro de chaque légende de figure et de tableau, les affiche d'abord puis les écrit, en remplaçant uniquement l'ancien numéro au début de chaque légende.

## Problèmes résolus
- Des numéros de figures et de tableaux qui ne suivent plus les chapitres après l'ajout, le déplacement ou la suppression de sections.
- Deux figures avec le même numéro, ou des trous dans la numérotation, découverts seulement dans le document exporté.
- Des heures passées à ouvrir les légendes une par une pour saisir les numéros à la main avant une revue ou une livraison.
- Des légendes aux styles de numéro différents (« Figure 3: », « Fig. 1.2 », aucun numéro) dans un même document.

## Avantages
- **Numérotation par chapitre :** Fig. 2.1, Fig. 2.2, Table 2.1, avec un compteur distinct pour les figures et les tableaux qui repart à chaque chapitre.
- **Voir d'abord :** un aperçu liste chaque légende avec son numéro actuel et le nouveau, avant toute modification.
- **Le texte de la légende reste :** seul l'ancien numéro est remplacé ; les mots et leur gras ou italique restent tels quels.
- **Peut être relancé sans risque :** les légendes qui ont déjà le bon numéro ne sont pas réécrites, et un rapport de modifications Excel conserve chaque texte avant et après.

## Utilisation
1. **Prérequis :** Captions ne fonctionne que si le projet contient un type d'artefact nommé **Caption**. Les légendes sont des artefacts de ce type, chacune sous son image ou son tableau ; un attribut Caption Type (Figure ou Table) est facultatif.
2. Ouvrez le module. Dans **Settings**, cliquez sur **Change**, choisissez dans **New number at headings up to** le niveau de titre qui démarre une nouvelle numérotation (niveau 1 : 1.1, 1.2 … puis 2.1) et dans **Caption text after the number** choisissez **Keep the text**, **Only the number (remove the text)** ou un attribut de l'image ou du tableau, par exemple **Name**. Cliquez sur **Done**.
3. Sous **Module**, cliquez sur **Preview** pour voir chaque légende sous **Captions** avec son numéro actuel, le nouveau et son nouveau texte. Ouvrez une ligne et cliquez sur **Show in module** pour afficher cette légende dans le module.
4. Cliquez sur **Number**, lisez la confirmation et cliquez sur **Number captions**. Le bloc de résultat indique combien de légendes ont été numérotées, ajoutées, étaient déjà correctes ou ont échoué, et **Log** télécharge le rapport de modifications.

## Bon à savoir
- Exécutez Captions dans un ensemble de modifications, pour pouvoir l'abandonner si le résultat ne convient pas.
- Les légendes situées avant le premier chapitre reçoivent le chapitre 0 (Fig. 0.1). Une légende sans Caption Type est numérotée sans mot, avec son propre compteur.
- L'attribut Caption Type est facultatif : sans lui, Captions distingue figures et tableaux par le mot de l'ancien numéro (Fig., Table) ou par la figure ou le tableau voisin de la légende. Une figure ou un tableau sans légende reçoit une nouvelle légende juste en dessous ; cela se désactive dans Settings.
- Par défaut, la légende est centrée et le nom de son artefact vidé, comme dans le widget Captions d'origine ; les deux peuvent être désactivés dans Settings.
- Le type de légende, son attribut et les mots placés avant les numéros (Fig., Table) peuvent être modifiés dans les paramètres du widget, par exemple pour des légendes dans une autre langue.
- Captions peut aussi écrire le texte de la légende à votre place : dans Settings, choisissez un attribut de la figure ou du tableau (par exemple son Name), et sa valeur est écrite après le numéro à la place de l'ancien texte, comme dans Fig. 1.2 Battery pack layout ; une valeur vide ne laisse que le numéro. Choisissez Only the number pour retirer le texte de toutes les légendes, ou Keep the text pour ne changer que les numéros.