# Attribute Linker

> Convierte los ID y claves guardados en un atributo en enlaces reales, para un módulo entero o una selección, tras una confirmación.

Source: https://widgets.doorsnext.com/es/widgets/attribute-linker/

- Disciplina: Enlaces y trazabilidad
- Funciona en: Módulo de IBM DOORS Next
- Productos compatibles: RM (IBM Engineering Requirements Management DOORS Next (Requirements Management))
- Modifica datos
- Keywords: crear enlaces desde atributo, importar trazabilidad, Parent ID, enlaces de importación Excel, importación ReqIF, migración DOORS 9, ID heredado, creación masiva de enlaces, trazabilidad
- Versión: 1.19 (Publicada 2026-10-27)
- Vendor: SmarterProcess (https://doorsnext.com, info@smarterprocess.pl)
- Flujo de trabajo: 1. Settings: atributo de referencias, tipo de enlace, dirección → 2. Whole module (Si hace falta: O seleccione artefactos: Selection) → 3. Create links: tras confirmar → 4. Revise la lista y las referencias no resueltas → 5. Informe de cambios en Excel

## Qué es y por qué existe
Cuando los requisitos llegan desde Excel, ReqIF o DOORS 9, la trazabilidad casi nunca llega como enlaces. Llega como texto: una columna como "Parent ID", "Satisfies" o "Derived from" con uno o varios ID o claves heredadas. En la interfaz estándar cada una de esas referencias se convierte en enlace a mano, artefacto por artefacto.

Attribute Linker lee ese atributo, encuentra el artefacto que nombra cada referencia y crea los enlaces en una sola ejecución. Los destinos se buscan por su ID de DOORS Next en todo el proyecto o por el valor de un atributo (por ejemplo "Legacy ID") en un módulo de destino.

## Problemas que resuelve
- Trazabilidad importada como texto en un atributo en lugar de enlaces.
- Cientos o miles de enlaces que crear a mano después de una migración.
- Referencias que no apuntan a nada, o a más de un artefacto, descubiertas mucho más tarde.
- Ningún registro de qué enlaces se crearon y qué referencias no se pudieron resolver.

## Ventajas
- **Ninguna referencia se pierde:** tras la ejecución, cada referencia aparece como Linked, Already linked, Not found, Ambiguous o Self reference.
- **Nunca adivina:** una referencia que coincide con varios artefactos se omite y se lista con los candidatos.
- **Búsqueda flexible:** por ID de DOORS Next o por una clave heredada en un atributo de un módulo de destino; listas separadas por comas, puntos y coma, espacios o saltos de línea.
- **Valores seguros por defecto:** los enlaces se crean en el contexto del módulo, como hace DOORS Next dentro de un módulo; en los artefactos base solo si usted lo elige.
- **Ejecuciones que se recuperan:** se omiten los enlaces existentes, progreso y Stop, continuación tras una parada en módulos muy grandes, fallos con Retry, lista en Excel de las referencias no resueltas e informe de cambios en Excel.

## Cómo se usa
1. Añada el widget al ELM Mini Dashboard junto al módulo.
2. En **Settings**, haga clic en **Change** e indique los **Reference attributes** con las referencias, los separadores, cómo se buscan los destinos (**Artifact ID** o **Attribute in a module** de un módulo de destino), el **Link type** y la **Direction**; después haga clic en **Done**.
3. En **Links**, elija **Whole module**, o seleccione artefactos y elija **Selection**.
4. Haga clic en **Create links**, lea la confirmación y confirme. El widget encuentra las referencias y crea los enlaces que faltan en una sola ejecución.
5. Revise el bloque de resultado y la lista **References**: el filtro **Not resolved** muestra cada referencia que no se pudo enlazar, con el motivo. Expórtelas a Excel si hace falta y descargue el informe de cambios con **Log**.

## Conviene saber
- Las referencias ambiguas y las que apuntan al propio artefacto nunca se enlazan; se listan y pueden exportarse a Excel.
- Si el valor de un atributo cambia durante la ejecución, ese artefacto no se toca y queda en la lista: vuelva a ejecutar Create links.
- Un ajuste opcional vacía el atributo cuando todas sus referencias están enlazadas; está desactivado por defecto.
- Si trabaja en una configuración global, el módulo de destino y los artefactos encontrados por ID también pueden estar en otro componente de esa misma configuración global; los enlaces conectan entonces los componentes. En un único stream o baseline solo se usa el componente abierto.
- Trabaje siempre en un change set: descartarlo es la única forma de deshacer los enlaces creados.