# Structure Writer

> Convierte la estructura de un módulo en valores de atributos (la ruta de capítulos, un identificador de estilo documental y un número de orden) para todos los artefactos a la vez.

Source: https://widgets.doorsnext.com/es/widgets/structure-writer/

- Disciplina: Estructura de módulos
- Funciona en: Módulo de IBM DOORS Next
- Productos compatibles: RM (IBM Engineering Requirements Management DOORS Next (Requirements Management))
- Modifica datos
- Keywords: atributo de ruta jerárquica, ruta de capítulos, número de sección en atributo, identificador con formato, migración de identificadores de DOORS 9, prefijo y sufijo de identificador, número de secuencia, atributo de orden, numeración automática, exportación en orden del módulo, IBM DOORS Next
- Versión: 1.16 (Publicada 2026-10-28)
- Vendor: SmarterProcess (https://doorsnext.com, info@smarterprocess.pl)
- Flujo de trabajo: 1. En Rules, active los valores y elija los atributos de destino → 2. Abra un módulo, elija Whole module o Selection → 3. Write y confirmar: ruta, ID y número → 4. Informe de cambios en Excel

## Qué es y por qué existe
En un módulo de DOORS Next, el lugar de un requisito (en qué capítulo está, qué número tiene, dónde aparece en el documento) solo se ve dentro de la vista del módulo. En cuanto los artefactos aparecen en una vista de varios módulos, una exportación, un filtro, un informe u otra herramienta, ese contexto desaparece. Los equipos que vienen de DOORS 9 también echan de menos sus identificadores de documento habituales, como «SRS-1234».

Structure Writer copia la estructura en atributos, para que viaje con el artefacto. Para cada artefacto de un módulo puede escribir la ruta de sus capítulos superiores («1 Introducción > 1.2 Alcance»), un identificador con formato compuesto por un prefijo, el identificador del artefacto y un sufijo («SRS-001234-A») y un número que crece en el orden del módulo, para ordenar. Usted elige cuál de los tres valores necesita y en qué atributo va cada uno.

## Problemas que resuelve
- Las exportaciones y las vistas de varios módulos pierden el capítulo al que pertenece un requisito.
- Fuera del módulo no se pueden ordenar los requisitos en el orden del documento.
- Los proyectos migrados necesitan identificadores de estilo documental con prefijo, y escribirlos a mano es lento y provoca errores.
- Las herramientas de numeración antiguas cambiaban un artefacto cada vez y tardaban minutos por cada cien artefactos.
- Tras mover o insertar un capítulo, las rutas y los números mantenidos a mano quedan mal sin que nadie lo note.

## Beneficios
- **Tres valores en una ejecución:** ruta jerárquica, identificador con formato y número de secuencia, cada uno opcional y en su propio atributo.
- **Ruta flexible:** cada nivel como número de sección y nombre, solo número, solo nombre, identificador o identificador y nombre, con su propio separador, con o sin el propio artefacto.
- **Módulos completos, rápido:** sin límite de 200 artefactos; la estructura se lee una vez y los valores se guardan por lotes.
- **Comprobado antes:** para una selección, el mosaico Write indica cuántos artefactos cambian y la confirmación cuántas rutas, ID y números se escriben; los valores que ya son correctos nunca se vuelven a guardar.
- **Siempre correcto:** tras reestructurar, basta con ejecutarlo de nuevo y solo se actualizan los valores que cambiaron.
- **Evidencia:** un informe de cambios en Excel con cada valor antes y después.

## Cómo se usa
1. En **Rules**, active los valores que necesite y elija el atributo de destino de cada uno: la ruta jerárquica (formato de nivel y separador), el identificador con formato (prefijo, sufijo, relleno con ceros) y el número de secuencia (inicio y paso).
2. Si lo desea, limite la ejecución a un tipo de artefacto, omita los encabezados o rellene solo los destinos vacíos (**Additional settings**).
3. Abra un módulo, elija **Whole module** (todo el módulo) y haga clic en **Write** (escribir): lea la confirmación y haga clic en **Write values**. Los valores se escriben en todo el módulo en una sola pasada y solo se guardan los que realmente cambian.
4. O seleccione algunos artefactos del módulo y elija **Selection** (selección): el mosaico **Write** indica cuántos de ellos cambian; haga clic en **Write** y confirme con **Write values**. Sus rutas y números siguen saliendo de todo el módulo.
5. El resultado cuenta los artefactos escritos, ya correctos, omitidos y no guardados; **Log** (registro) guarda el informe de cambios si necesita un registro.

## Conviene saber
- Trabaje siempre en un conjunto de cambios: por defecto se sobrescriben los valores existentes, porque los valores siguen a la estructura. Active «Only fill empty targets» para conservar los valores escritos a mano.
- Los valores de los atributos pertenecen al artefacto, no a su lugar: un artefacto usado dos veces en el módulo recibe los valores de su primer lugar, y uno usado también en otro módulo recibe los del módulo en el que se ejecutó el widget por última vez.
- Los artefactos del nivel superior no tienen capítulo superior, así que solo reciben ruta si se incluye el propio artefacto.
- El número de secuencia cuenta solo los artefactos que se escriben, en el orden en que aparecen en el módulo.
- En módulos muy grandes puede detener una ejecución, recargar la página y continuar desde donde se detuvo, con la misma configuración.