Attribute Linker

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.