# Captions

> Numera cada pie de figura y de tabla de un módulo según su capítulo, Fig. 2.1, Table 2.1, en una sola pasada.

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

- Disciplina: Calidad del contenido
- Funciona en: Módulo de IBM DOORS Next
- Productos compatibles: RM (IBM Engineering Requirements Management DOORS Next (Requirements Management))
- Modifica datos
- Keywords: numeración de pies de figura, números de figura, números de tabla, pies numerados, pies de figura en requisitos, pies de tabla, numeración de documentos DOORS Next
- Versión: 2.6 (Publicada 2026-10-28)
- Vendor: SmarterProcess (https://doorsnext.com, info@smarterprocess.pl)
- Flujo de trabajo: 1. Abrir un módulo → 2. Ver cada número en la vista previa → 3. Confirmar Number captions → 4. Pies numerados por capítulo → 5. Informe de cambios en Excel

## Qué es y por qué existe
Las especificaciones exportadas a Word o PDF necesitan figuras y tablas numeradas por capítulo: Fig. 2.1, Fig. 2.2, Table 2.1. En DOORS Next, un pie es un artefacto propio, colocado bajo la imagen o la tabla que describe, y su número es texto sin más. Cada imagen nueva, cada sección movida y cada capítulo nuevo rompe la numeración, y corregirla a mano significa abrir un pie tras otro.

Captions numera todos los pies de un módulo en una sola pasada. Lee los capítulos del módulo, calcula el número de cada pie de figura y de tabla, los muestra primero y después los escribe, sustituyendo solo el número antiguo al principio de cada pie.

## Problemas que resuelve
- Números de figura y de tabla que ya no siguen los capítulos después de añadir, mover o eliminar secciones.
- Dos figuras con el mismo número, o huecos en la numeración, que solo se descubren en el documento exportado.
- Horas abriendo un pie tras otro para escribir los números a mano antes de una revisión o una entrega.
- Pies con estilos de número distintos («Figure 3:», «Fig. 1.2», sin número) en un mismo documento.

## Ventajas
- **Numerado por capítulo:** Fig. 2.1, Fig. 2.2, Table 2.1, con un contador separado para figuras y tablas que vuelve a empezar en cada capítulo.
- **Véalo primero:** una vista previa lista cada pie con su número actual y el nuevo, antes de que cambie nada.
- **El texto del pie se mantiene:** solo se sustituye el número antiguo; las palabras y su negrita o cursiva quedan como estaban.
- **Se puede volver a ejecutar sin riesgo:** los pies que ya tienen el número correcto no se escriben, y un informe de cambios en Excel guarda cada texto antes y después.

## Cómo se usa
1. **Requisito:** Captions solo funciona si el proyecto tiene un tipo de artefacto llamado **Caption**. Los pies son artefactos de ese tipo, cada uno bajo su imagen o tabla; un atributo Caption Type (Figure o Table) es opcional.
2. Abra el módulo. En **Settings**, haga clic en **Change**, elija en **New number at headings up to** qué nivel de encabezado inicia una nueva numeración (nivel 1: 1.1, 1.2 … y luego 2.1) y en **Caption text after the number** elija **Keep the text**, **Only the number (remove the text)** o un atributo de la imagen o tabla, como **Name**. Haga clic en **Done**.
3. En **Module**, haga clic en **Preview** para ver cada pie en **Captions** con su número actual, el nuevo y su nuevo texto. Abra una fila y haga clic en **Show in module** para ver ese pie en el módulo.
4. Haga clic en **Number**, lea la confirmación y haga clic en **Number captions**. El bloque de resultado muestra cuántos pies se numeraron, se añadieron, ya eran correctos o fallaron, y **Log** descarga el informe de cambios.

## Conviene saber
- Ejecute Captions en un conjunto de cambios, para poder descartarlo si el resultado no es el esperado.
- Los pies anteriores al primer capítulo reciben el capítulo 0 (Fig. 0.1). Un pie sin Caption Type se numera sin palabra, con un contador propio.
- El atributo Caption Type es opcional: sin él, Captions distingue figuras y tablas por la palabra del número antiguo (Fig., Table) o por la figura o tabla junto al pie. Una figura o tabla sin pie recibe un pie nuevo justo debajo; se puede desactivar en Settings.
- De forma predeterminada, el pie se centra y se vacía el nombre de su artefacto, como en el widget Captions original; ambas opciones se pueden desactivar en Settings.
- El tipo de pie, su atributo y las palabras que preceden a los números (Fig., Table) se pueden cambiar en la configuración del widget, por ejemplo para pies en otro idioma.
- Captions también puede escribir el texto del pie por usted: en Settings, elija un atributo de la figura o tabla (por ejemplo, su Name) y su valor se escribe tras el número en lugar del texto anterior, como en Fig. 1.2 Battery pack layout; un valor vacío deja solo el número. Elija Only the number para quitar el texto de todos los pies, o Keep the text para cambiar solo los números.