Requisitos
Vínculos con otros proyectos
Trace un elemento hasta un requisito, una función o una prueba de otro proyecto; cada persona ve el elemento vinculado solo cuando puede abrir su proyecto.
En esta página
Resumen
Un vínculo a otro proyecto es una relación de traza desde un elemento de este proyecto hasta un elemento de otro proyecto, como un requisito de subsistema traced from un requisito de la especificación del sistema, o un procedimiento de prueba que verifies un requisito que mantiene otro equipo.
El vínculo forma parte de este proyecto. Solo guarda los ids de los dos elementos y la relación. El número, el nombre, la clase y el estado del elemento vinculado se leen de su propio proyecto cada vez que lo mira, con su propio acceso:
- Cuando puede abrir el otro proyecto, ve el elemento y puede hacer clic para ir a él.
- Cuando no puede, ve Elemento de un proyecto que usted no puede abrir. El nombre nunca le llega, ni en la aplicación, ni en las exportaciones, ni a través de la API ni de las herramientas de IA.
Los vínculos a otros proyectos forman parte del plan Team. Decide el plan del propietario del proyecto. En otros planes, los vínculos existentes siguen visibles y se pueden quitar, pero no se pueden añadir nuevos. Los vínculos entre los proyectos de demostración Hybrid Car y Hybrid Car Battery Pack funcionan en todos los planes.
Conceptos
Qué contiene un vínculo
| Parte | Significado |
|---|---|
| Fuente | Un elemento de este proyecto |
| Relación | Una relación del esquema de este proyecto, como traced from, satisfies o verified by |
| Objetivo | El id de un proyecto y el id de un elemento de él |
La relación se comprueba con la clase del origen. La clase del destino no se comprueba al crear el vínculo, porque el vínculo nunca lee el contenido del otro proyecto. Cuando la clase del destino no encaja con la relación, la sección Trazabilidad muestra ⚠ con «Esta relación no suele apuntar a …».
Quién ve qué
Cada persona ve cada elemento vinculado con la función que tiene en su proyecto:
| Su acceso al otro proyecto | Lo que se ve |
|---|---|
| Cualquier función (Propietario, Editor, Revisor, Lector) | Número, nombre, proyecto y un enlace que abre el elemento |
| Ninguno, o el proyecto ya no existe | Elemento de un proyecto que usted no puede abrir |
Un proyecto que no existe y un proyecto que no puede abrir se ven igual, de modo que un vínculo nunca le revela que un proyecto existe.
Estados de los vínculos
| Se muestra | Significado | Qué hacer |
|---|---|---|
| Número y nombre | El elemento existe y puede abrir su proyecto | Nada |
| Eliminado en <project> | El elemento está en la Papelera de su proyecto | Pida a alguien que pueda editar ese proyecto que lo restaure, o quite el vínculo |
| Eliminado | El elemento ya no existe | Quite el vínculo (Quitar vínculos rotos) |
| Elemento de un proyecto que usted no puede abrir | No tiene acceso al proyecto, o ya no existe | Pida acceso al propietario del proyecto si lo necesita |
| Cargando… | Se está leyendo el elemento | Espere un momento |
Los nombres se leen cuando una página muestra el vínculo, de nuevo cuando vuelve a la pestaña al cabo de un minuto, y cada cinco minutos. Un elemento al que se le ha cambiado el nombre muestra su nombre nuevo sin ningún cambio en este proyecto.
Destinos cambiados
Una fila muestra Cambiado cuando el elemento vinculado se ha editado en su proyecto después de crear el vínculo o de revisarlo por última vez. Apunte a ella para ver la fecha. Compruebe que el vínculo sigue siendo válido y después:
- Haga clic en ✓ en la fila para marcar ese vínculo como revisado.
- Haga clic en ⋯ junto a Otros proyectos y después en Marcar todos como revisados (n), para todos los vínculos señalados del elemento.
- O abra Necesidades y requisitos → Vínculos por revisar: la tarjeta Cambiado en otros proyectos enumera todos los vínculos señalados del proyecto, con ✓ en cada fila y Marcar todo como revisado.
Marcar como revisado aparece en el historial del elemento y en Actividad, y un solo Deshacer lo revierte. Los revisores y los lectores ven las señales, pero no pueden borrarlas. Los vínculos a publicaciones de bibliotecas no se señalan (una publicación no cambia).
Cómo usarlo
Cuándo y por qué
Use vínculos a otros proyectos cuando un único modelo sería demasiado grande o pertenece a equipos distintos: una especificación del sistema y sus especificaciones de subsistema, los requisitos compartidos de una línea de productos y cada producto, o los requisitos de un cliente y su diseño. Mantenga los vínculos en el proyecto de nivel inferior, apuntando hacia arriba: cada subsistema traza sus requisitos desde los requisitos del sistema.
Use relaciones normales dentro de un proyecto. Vincular existente… en la sección Trazabilidad relaciona elementos del mismo proyecto; un vínculo a otro proyecto es para elementos que están en otro lugar.
Añadir un vínculo
- Seleccione el elemento, por ejemplo un requisito de subsistema.
- En el inspector, abra la sección Trazabilidad. En Otros proyectos, haga clic en + (Añadir vínculo a otro proyecto…).
- Elija la Relación, como traced from.
- Elija el Proyecto. Sus elementos se enumeran por número.
- Para una biblioteca, elija la Versión: Actual (copia de trabajo) o una publicación como Release 1.1. Un vínculo a una publicación muestra su etiqueta en lugar de actual, y su nombre no abre ninguna página.
- Escriba en Buscar para encontrar un elemento por número o nombre. Elija una Clase para enumerar solo esa clase.
- Haga clic en el elemento y después en Añadir vínculo. El aviso indica «Vínculo añadido.» y el elemento aparece en Otros proyectos.
Un solo Deshacer quita el vínculo. Si se vuelve a añadir el mismo vínculo, se conserva el existente.
Abrir el elemento vinculado
Haga clic en el nombre del elemento vinculado. Su proyecto se abre en ese elemento.
Quitar vínculos
- Haga clic en × en la fila del vínculo para quitar un vínculo.
- Cuando hay vínculos que apuntan a elementos eliminados, haga clic en ⋯ junto a Otros proyectos y después en Quitar vínculos rotos (n).
Quitar un vínculo solo cambia este proyecto. Un vínculo nunca cambia el otro proyecto.
Ejemplo práctico: un subsistema de carga útil y la demostración CubeSat EO-1
- Cree un proyecto llamado EO-1 Payload con un requisito PL.1 Detector pixel pitch shall be at most 5.5 µm.
- Seleccione PL.1 y abra Trazabilidad → Otros proyectos → +.
- Elija traced from y el proyecto CubeSat EO-1, busque ground sample y haga clic en 1.2 Ground Sample Distance. Haga clic en Añadir vínculo.
- La fila indica traced from 1.2 Ground Sample Distance CubeSat EO-1 · actual. Un compañero que solo puede abrir EO-1 Payload ve Elemento de un proyecto que usted no puede abrir en la misma fila.
Consejos y buenas prácticas
- Vincule del nivel inferior al superior, para que el proyecto del sistema no tenga que cambiar cuando se añade un subsistema.
- Comparta el proyecto de nivel superior como Lector con las personas que trabajan en el de nivel inferior, para que vean los nombres.
- Ejecute Quitar vínculos rotos después de reorganizar un proyecto de nivel superior.
Errores habituales
| Problema | Causa | Solución |
|---|---|---|
| «Este elemento está en este proyecto. Use Vincular existente… en su lugar.» | El destino está en el mismo proyecto | Use Vincular existente… en el grupo de la relación |
| No hay + en Otros proyectos | Solo puede ver el proyecto, o el elemento está bloqueado | Pida la función de Editor o desbloquee el elemento |
| «Los vínculos a elementos de otros proyectos forman parte del plan Team.» | El propietario del proyecto no está en el plan Team | Cambie de plan en Ajustes de la cuenta → Plan y facturación |
| El selector indica «No se puede leer este proyecto. Elija otro proyecto.» | Ha perdido el acceso a ese proyecto | Pida acceso a su propietario |
Cómo se relaciona con otras funciones
- Matriz de trazabilidad: los vínculos desde las filas sobre las relaciones elegidas se enumeran bajo la cuadrícula en Otros proyectos; Exportar… los añade (consulte Trazabilidad).
- Diagrama Spider: los elementos vinculados aparecen como recuadros discontinuos alrededor de su elemento; desactívelos con Opciones → Otros proyectos.
- Mapa del programa: Gestionar proyectos → Mapa del programa muestra cómo se vinculan todos sus proyectos, y Otros proyectos ⋯ → Mostrar en el mapa del programa traza este elemento a través de otros proyectos (consulte Mapa del programa).
- Cobertura del programa: el proyecto al que vincula enumera estos vínculos en Verificación → Cobertura del programa, por elemento y por proyecto (consulte Cobertura del programa).
- Historial y actividad: añadir y quitar un vínculo queda registrado en el elemento.
- Papelera: al eliminar un elemento, sus vínculos pasan con él a la Papelera; al restaurar el elemento, se restauran.
- Solicitudes de cambio: Añadir cambio ▾ → Añadir un vínculo a otro proyecto… y Quitar un vínculo a otro proyecto… preparan vínculos; se añaden o se quitan cuando se aplica la solicitud.
- Bibliotecas: vincule con un elemento de una publicación de biblioteca con la opción Versión (consulte Bibliotecas).
Exportaciones e informes
Las exportaciones nombran los elementos vinculados con el acceso de la persona que exporta. Lo que esa persona no puede leer se escribe como «Elemento de otro proyecto».
| Exportación | Qué ocurre con los vínculos a otros proyectos |
|---|---|
| JSON del proyecto (exportación de la Base de datos) | Se conservan tal como están guardados: solo ids. Al importar el archivo se conservan |
| ReqIF (Base de datos y Documentos) | Un atributo External links en cada elemento vinculado: relación, id del proyecto e id del elemento, más el número y el nombre cuando puede leerlos |
| XMI | Se omiten; el informe de exportación los cuenta como «Link to another project» |
| Matriz de trazabilidad (Excel) | Una hoja Other projects aparte |
| Matriz de trazabilidad (CSV) | Una columna Other projects |
| Informe de matriz de trazabilidad de requisitos (RTM) | Una columna Other Projects |
API y MCP
La API y MCP devuelven los vínculos como ids. Para leer los nombres, llame a la operación de resolución; usa el propio acceso y la lista de proyectos del token. El Mapa del programa y la Traza del elemento están disponibles como GET /api/v1/program-map, GET /api/v1/projects/<project>/items/<item>/trace y las herramientas MCP program_map y trace_chain. Consulte API y MCP.
Las funciones de IA de la aplicación solo reciben los vínculos como ids.
Mensajes
| Mensaje | Significado |
|---|---|
| Vínculo añadido. | El vínculo se ha guardado |
| Este elemento está en este proyecto. Use Vincular existente… en su lugar. | El elemento elegido está en el mismo proyecto |
| Elija un elemento y añada el vínculo. | Se hizo clic en Añadir vínculo sin elegir un elemento |
| No hay otros proyectos a los que vincular. Cree o abra primero otro proyecto. | Solo tiene este proyecto |
| Los vínculos a elementos de otros proyectos forman parte del plan Team. | El propietario del proyecto no está en el plan Team |
| Un proyecto contiene como máximo 20.000 vínculos a otros proyectos. Quite algunos primero. | El proyecto ha alcanzado el límite |
Límites
| Límite | Valor |
|---|---|
| Vínculos por proyecto | 20,000 |
| Elementos leídos por solicitud | 500 |
| Elementos enumerados en el selector | 100 por búsqueda (acote la búsqueda para ver otros) |
Un vínculo apunta a la versión actual del otro proyecto, o a la copia de un elemento en una publicación de biblioteca (consulte Bibliotecas).