Requisitos
Mapa del programa
Vea cómo se vinculan sus proyectos entre sí, con el número de vínculos por cada par de proyectos, y siga la cadena de vínculos de un elemento a través de otros proyectos.
En esta página
- Resumen
- Conceptos
- Cómo usarlo
- Ver cómo se vinculan sus proyectos
- Empezar desde un proyecto
- Trazar un elemento a través del programa
- Ejemplo práctico: la demostración CubeSat EO-1 y un proyecto de carga útil
- Ejemplo práctico: el Hybrid Car y su paquete de baterías
- Consejos y buenas prácticas
- Errores habituales
- Cómo se relaciona con otras funciones
- La página Mapa del programa
- API y MCP
- Mensajes
- Límites
- Relacionado
Resumen
Un programa que abarca varios proyectos (un proyecto del sistema, proyectos de subsistemas, un proyecto de pruebas, bibliotecas) se une mediante vínculos a otros proyectos. Cada vínculo se guarda en el proyecto que lo crea, así que ningún proyecto muestra por sí solo el panorama completo. El Mapa del programa sí: dibuja un recuadro por cada proyecto que puede abrir y una flecha por cada par de proyectos, etiquetada con la relación y el número de vínculos.
La página tiene dos vistas:
- Proyectos: todos los proyectos que puede abrir y los vínculos entre ellos, como grafo o como tabla.
- Traza del elemento: un elemento en el centro y los elementos vinculados con él en otros proyectos, anillo a anillo, hasta seis pasos de distancia.
El Mapa del programa está disponible para todos los que han iniciado sesión. Los vínculos en sí se crean en el plan Team; los vínculos guardados en un proyecto cuyo propietario tiene un plan que no los incluye se dibujan en gris. Los vínculos entre los proyectos de demostración Hybrid Car y Hybrid Car Battery Pack funcionan en todos los planes.
Conceptos
Qué muestra el mapa
| Elemento | Significado |
|---|---|
| Recuadro | Un proyecto que puede abrir: su nombre, su tipo de proyecto y su número de elementos; su nombre accesible añade los vínculos que contiene y recibe |
| Flecha | Vínculos guardados en el proyecto del extremo de origen que apuntan a elementos del proyecto del extremo de la punta |
| Etiqueta de la flecha | relación · vínculos · eliminados, por ejemplo traced from · 12 · 1 eliminado |
| Proyectos que no puede abrir (N vínculos) | Un recuadro discontinuo que cuenta todos los vínculos hacia un proyecto que usted no puede abrir |
| Recuadro de publicación de biblioteca | Una publicación de biblioteca que puede leer, vinculada desde sus proyectos |
Las flechas suelen apuntar hacia arriba: los proyectos de subsistemas guardan vínculos traced from y satisfies al proyecto del sistema, y los proyectos de pruebas guardan vínculos verifies. El mapa coloca los proyectos que contienen vínculos debajo de los proyectos a los que apuntan.
Quién ve qué
El mapa se construye solo con los proyectos que puede abrir: un proyecto del que es miembro con cualquier función, que no está en la Papelera y cuya regla de inicio de sesión en dos pasos de la organización cumple.
- Un vínculo hacia un proyecto que no puede abrir se cuenta en Proyectos que no puede abrir (N vínculos). Ese recuadro nunca nombra el proyecto ni el elemento, y se ve igual tanto si el proyecto existe, como si está en la Papelera o nunca existió.
- Los vínculos guardados en un proyecto que no puede abrir no se cuentan en ningún sitio, aunque apunten a sus proyectos.
- Ser administrador de la organización no añade nada: el mapa usa la pertenencia a los proyectos.
- Las exportaciones (CSV, SVG, PNG) contienen exactamente lo que muestra la página.
Colores
| Color | Significado |
|---|---|
| Flecha azul | Vínculos entre proyectos que puede abrir |
| Flecha ámbar | Algunos de los destinos están eliminados (en la Papelera o desaparecidos) |
| Flecha gris | Vínculos hacia proyectos que no puede abrir o a una publicación de biblioteca, o guardados en un proyecto cuyo propietario tiene un plan que no incluye vínculos a otros proyectos |
Cómo usarlo
Ver cómo se vinculan sus proyectos
- Haga clic en Gestionar proyectos y después en Mapa del programa. La vista Proyectos se abre con todos los proyectos que contienen o reciben vínculos.
- Lea las flechas. Apunte a un recuadro para atenuar todo lo que no está conectado con él.
- Haga clic en una flecha. El inspector enumera sus vínculos, de 100 en 100: el elemento que contiene cada vínculo, la relación y el elemento de destino. Haga clic en cualquiera de los dos elementos para abrirlo en su proyecto, o en Mostrar más para ver los 100 siguientes.
- Haga clic en Exportar CSV en el inspector para guardar los vínculos de esa flecha, o en Exportar ▾ en la barra para guardar todo el mapa como CSV, SVG o PNG.
Empezar desde un proyecto
- Abra el proyecto, después Verificación → Cobertura del programa, y haga clic en Abrir mapa del programa.
- El mapa muestra solo ese proyecto y los proyectos vinculados con él, directamente o a través de otros.
- Haga clic en Mostrar todos los proyectos para ver todo lo que puede abrir.
También puede hacer clic en un recuadro y elegir Mostrar solo proyectos enlazados.
Trazar un elemento a través del programa
- Seleccione el elemento. En la sección Trazabilidad del inspector, abra Otros proyectos ⋯ y elija Mostrar en el mapa del programa. Desde la lista de vínculos de una flecha, haga clic en Trazar este elemento.
- La vista Traza del elemento muestra el elemento en el centro y los elementos vinculados con él en anillos: el primer anillo a un paso, el segundo a dos pasos. Los vínculos se siguen en ambos sentidos.
- Elija Pasos (de 1 a 6, 3 de forma predeterminada) para ir más lejos o quedarse más cerca.
- Los elementos se colorean por proyecto, con un recuadro discontinuo alrededor de los elementos de cada proyecto. Desmarque Agrupar por proyecto para quitar los recuadros.
- Haga clic en un elemento para ver Abrir elemento y Trazar desde aquí, que lo coloca en el centro.
Ejemplo práctico: la demostración CubeSat EO-1 y un proyecto de carga útil
- Cree la demostración CubeSat EO-1 y después un segundo proyecto EO-1 Payload con el requisito PL.1 Imager resolution.
- En EO-1 Payload, seleccione PL.1. En Trazabilidad → Otros proyectos, haga clic en +, elija traced from, el proyecto CubeSat y su requisito de captura de imágenes, y haga clic en Añadir vínculo.
- Cree un tercer proyecto EO-1 Test Campaign con el caso de prueba TC.4 Resolution test y vincúlelo con verifies a PL.1 en EO-1 Payload.
- Abra Gestionar proyectos → Mapa del programa. El mapa muestra EO-1 Test Campaign abajo, EO-1 Payload encima y el proyecto CubeSat arriba, con las flechas verifies · 1 y traced from · 1.
- Haga clic en PL.1 → Trazabilidad ⋯ → Mostrar en el mapa del programa: el caso de prueba y el requisito del CubeSat quedan a un paso, uno a cada lado.
Ejemplo práctico: el Hybrid Car y su paquete de baterías
- En Gestionar proyectos, haga clic en Archivos de proyecto ▾ → Nuevo proyecto de demostración → Hybrid Car (SysML v2).
- Después cree Archivos de proyecto ▾ → Nuevo proyecto de demostración → Hybrid Car Battery Pack (SysML v2). Los requisitos del paquete del proveedor de baterías PackCapacity, PackMass y ChargeAcceptance están vinculados con traced from a los requisitos del coche VR-3, VR-6 y VR-5 en su demostración Hybrid Car más reciente, sin importar cuál de las dos cree primero; volver a crear la demostración Hybrid Car traslada los vínculos a la nueva. Estos vínculos de demostración funcionan en todos los planes. Sin un proyecto Hybrid Car, la demostración del paquete no tiene vínculos.
- Abra Gestionar proyectos → Mapa del programa. El mapa muestra los dos proyectos SysML v2 con la flecha traced from · 3.
Consejos y buenas prácticas
- Acuerde las relaciones que usan los subproyectos (traced from o satisfies para los requisitos, verifies para las pruebas) para que las flechas se lean igual en todas partes.
- Desactive Agrupar relaciones para ver una flecha por relación, por ejemplo para distinguir los vínculos de requisitos de los vínculos de pruebas entre los mismos dos proyectos.
- Arrastre los recuadros para organizar el mapa. Las posiciones se conservan en este navegador para cada ámbito.
- Use la vista Tabla para ordenar los pares de proyectos por número de vínculos o de destinos eliminados.
- Una flecha ámbar indica vínculos que hay que reparar: abra su lista de vínculos y después corrija o quite los vínculos en Trazabilidad → Otros proyectos del elemento.
Errores habituales
| Problema | Causa | Solución |
|---|---|---|
| Falta un proyecto | No es miembro de él, está en la Papelera o no tiene vínculos | Pida acceso a su propietario; marque Mostrar proyectos sin enlaces para enumerar los proyectos sin vínculos |
| Todo va a Proyectos que no puede abrir | Los vínculos apuntan a proyectos de los que no es miembro | Pida acceso al propietario de un proyecto |
| Flechas grises en el centro del mapa | El proyecto que contiene los vínculos tiene un propietario sin el plan Team | El propietario cambia de plan en Ajustes de la cuenta → Plan y facturación |
| Un vínculo nuevo aún no aparece | El mapa sigue leyendo los cambios recientes | Haga clic en Actualizar al cabo de un minuto |
Cómo se relaciona con otras funciones
- Vínculos a otros proyectos: el mapa los lee; no añade ni cambia nada. Cree los vínculos en Trazabilidad → Otros proyectos de un elemento (consulte Vínculos a otros proyectos).
- Cobertura del programa: la vista por elemento de los vínculos hacia un proyecto, con los huecos (consulte Cobertura del programa). Abrir mapa del programa ahí inicia el mapa desde ese proyecto.
- Bibliotecas: los vínculos a un elemento de una publicación de biblioteca aparecen como flechas hacia el recuadro de la publicación (consulte Bibliotecas).
- Diagrama Spider: la traza dentro de un proyecto, con recuadros discontinuos para los elementos vinculados en otros lugares. La Traza del elemento usa la misma disposición en anillos.
- API y MCP: el mismo mapa y la misma traza para las herramientas (consulte API y MCP).
La página Mapa del programa
Barra
| Control | Qué hace |
|---|---|
| Proyectos / Traza del elemento | Cambia la vista |
| Ámbito | Todos mis proyectos, una organización (cuando pertenece a alguna) o una carpeta con sus subcarpetas (cuando tiene carpetas; consulte Carpetas de proyectos) |
| Mostrar todos los proyectos | Se muestra tras abrir el mapa desde un proyecto; sale del conjunto vinculado de ese proyecto |
| Mostrar proyectos sin enlaces | Muestra también los proyectos sin vínculos |
| Agrupar relaciones | Una flecha por par de proyectos (las etiquetas enumeran cada relación), o una flecha por relación |
| Pasos | Traza del elemento: de 1 a 6 pasos de distancia |
| Agrupar por proyecto | Traza del elemento: recuadros discontinuos alrededor de los elementos de cada proyecto |
| Grafo / Tabla | El diagrama o una tabla ordenable; en una pantalla estrecha se abre primero la tabla |
| Actualizar | Vuelve a leer los vínculos |
| Exportar ▾ | Exportar CSV, Exportar SVG, Exportar PNG |
Grafo
- Haga clic en un recuadro para mostrar su proyecto en el inspector: Abrir proyecto y Mostrar solo proyectos enlazados. Haga doble clic en un recuadro, o pulse Shift+Enter sobre él, para abrir el proyecto.
- Haga clic en una flecha para enumerar sus vínculos en el inspector.
- Arrastre los recuadros para moverlos; desplácese o pellizque para hacer zoom; arrastre el fondo para desplazar la vista.
- Pulse Tab para llegar al mapa y después las teclas de flecha para moverse entre recuadros y flechas; Enter va al inspector. Cada recuadro y cada flecha tienen un nombre que lee el lector de pantalla, como «EO-1 Payload, proyecto LML, 1 vínculo saliente, 1 entrante».
Tabla
| Vista | Columnas |
|---|---|
| Proyectos | Proyecto de origen, Relación, Proyecto de destino, Vínculos, Eliminado |
| Traza del elemento | Proyecto, Número, Nombre, Clase, Pasos desde el elemento, Estado |
Haga clic en el encabezado de una columna para ordenar.
Inspector
| Selección | Contenido |
|---|---|
| Cuadro del proyecto | Nombre, tipo, número de elementos, vínculos salientes y entrantes; Abrir proyecto, Mostrar solo proyectos enlazados |
| Flecha | Proyecto de origen y de destino, vínculos por relación, la lista de vínculos (de 100 en 100, Mostrar más), Exportar CSV, Trazar este elemento en cada fila |
| Elemento (Traza del elemento) | Número y nombre, clase, proyecto, pasos desde el elemento trazado, estado; Abrir elemento, Trazar desde aquí |
| Proyectos que no puede abrir | «Vínculos a proyectos que no puede abrir. Pida acceso al propietario de un proyecto.» |
API y MCP
La API REST y MCP dan las mismas respuestas con el propio acceso y la lista de proyectos del token. Los proyectos de una organización que ha desactivado el acceso a la API se omiten, como los proyectos que no puede abrir.
| Llamada | Devuelve |
|---|---|
GET /api/v1/program-map | Proyectos, publicaciones, flechas (from, to, relation, links, deleted, plan) y el recuento oculto; from, unlinked, org como en la página |
GET /api/v1/projects/<project>/items/<item>/trace | La Traza del elemento: nodos con proyecto, número, nombre, clase y pasos, los vínculos entre ellos y el recuento oculto; steps 1–6 (3 de forma predeterminada) |
MCP program_map | Lo mismo que GET /program-map |
MCP trace_chain | Lo mismo que la llamada de traza; los elementos de proyectos con marcados de datos regulados responden withheld |
Consulte API y MCP.
Mensajes
| Mensaje | Significado |
|---|---|
| No hay vínculos entre sus proyectos. Añada uno desde la sección Trazabilidad de un elemento. | Ninguno de sus proyectos contiene ni recibe un vínculo que usted pueda ver |
| Este proyecto no tiene vínculos a otros proyectos. Añada uno desde la sección Trazabilidad de un elemento. | El mapa se abrió desde un proyecto sin vínculos |
| Este elemento no tiene vínculos a otros proyectos. Añada uno desde su sección Trazabilidad. | El elemento trazado no tiene vínculos |
| Todavía se están leyendo algunos proyectos. Actualice dentro de un minuto. | Todavía se están leyendo los cambios recientes de proyectos grandes; el mapa muestra lo que ya está listo |
| Se muestran los primeros 500 elementos. Reduzca los pasos. | La Traza del elemento ha alcanzado su límite |
| No se siguen N vínculos de proyectos cuyo propietario tiene un plan que no incluye vínculos a otros proyectos. | La Traza del elemento ha omitido vínculos guardados con un plan que no los incluye |
| No se ha podido leer el mapa del programa. Vuelva a cargar la página. | La solicitud ha fallado |
Límites
| Límite | Valor |
|---|---|
| Pasos de la Traza del elemento | 1 a 6 |
| Elementos en una Traza del elemento | 500 |
| Vínculos enumerados por página en la lista de una flecha | 100 |
| Vínculos por proyecto | 20.000 (consulte Vínculos a otros proyectos) |