Holarch

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.

Cómo usarlo →

En esta página
  1. Resumen
  2. Conceptos
    1. Qué muestra el mapa
    2. Quién ve qué
    3. Colores
  3. Cómo usarlo
    1. Ver cómo se vinculan sus proyectos
    2. Empezar desde un proyecto
    3. Trazar un elemento a través del programa
    4. Ejemplo práctico: la demostración CubeSat EO-1 y un proyecto de carga útil
    5. Ejemplo práctico: el Hybrid Car y su paquete de baterías
    6. Consejos y buenas prácticas
    7. Errores habituales
    8. Cómo se relaciona con otras funciones
  4. La página Mapa del programa
    1. Barra
    2. Grafo
    3. Tabla
    4. Inspector
  5. API y MCP
  6. Mensajes
  7. Límites
  8. 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

ElementoSignificado
RecuadroUn 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
FlechaVínculos guardados en el proyecto del extremo de origen que apuntan a elementos del proyecto del extremo de la punta
Etiqueta de la flecharelació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 bibliotecaUna 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

ColorSignificado
Flecha azulVínculos entre proyectos que puede abrir
Flecha ámbarAlgunos de los destinos están eliminados (en la Papelera o desaparecidos)
Flecha grisVí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

  1. 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.
  2. Lea las flechas. Apunte a un recuadro para atenuar todo lo que no está conectado con él.
  3. 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.
  4. 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

  1. Abra el proyecto, después Verificación → Cobertura del programa, y haga clic en Abrir mapa del programa.
  2. El mapa muestra solo ese proyecto y los proyectos vinculados con él, directamente o a través de otros.
  3. 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

  1. 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.
  2. 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.
  3. Elija Pasos (de 1 a 6, 3 de forma predeterminada) para ir más lejos o quedarse más cerca.
  4. 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.
  5. 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

  1. Cree la demostración CubeSat EO-1 y después un segundo proyecto EO-1 Payload con el requisito PL.1 Imager resolution.
  2. 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.
  3. 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.
  4. 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.
  5. 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

  1. En Gestionar proyectos, haga clic en Archivos de proyecto ▾ → Nuevo proyecto de demostración → Hybrid Car (SysML v2).
  2. 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.
  3. 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

ProblemaCausaSolución
Falta un proyectoNo es miembro de él, está en la Papelera o no tiene vínculosPida acceso a su propietario; marque Mostrar proyectos sin enlaces para enumerar los proyectos sin vínculos
Todo va a Proyectos que no puede abrirLos vínculos apuntan a proyectos de los que no es miembroPida acceso al propietario de un proyecto
Flechas grises en el centro del mapaEl proyecto que contiene los vínculos tiene un propietario sin el plan TeamEl propietario cambia de plan en Ajustes de la cuenta → Plan y facturación
Un vínculo nuevo aún no apareceEl mapa sigue leyendo los cambios recientesHaga 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

ControlQué hace
Proyectos / Traza del elementoCambia la vista
ÁmbitoTodos 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 proyectosSe muestra tras abrir el mapa desde un proyecto; sale del conjunto vinculado de ese proyecto
Mostrar proyectos sin enlacesMuestra también los proyectos sin vínculos
Agrupar relacionesUna flecha por par de proyectos (las etiquetas enumeran cada relación), o una flecha por relación
PasosTraza del elemento: de 1 a 6 pasos de distancia
Agrupar por proyectoTraza del elemento: recuadros discontinuos alrededor de los elementos de cada proyecto
Grafo / TablaEl diagrama o una tabla ordenable; en una pantalla estrecha se abre primero la tabla
ActualizarVuelve 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

VistaColumnas
ProyectosProyecto de origen, Relación, Proyecto de destino, Vínculos, Eliminado
Traza del elementoProyecto, Número, Nombre, Clase, Pasos desde el elemento, Estado

Haga clic en el encabezado de una columna para ordenar.

Inspector

SelecciónContenido
Cuadro del proyectoNombre, tipo, número de elementos, vínculos salientes y entrantes; Abrir proyecto, Mostrar solo proyectos enlazados
FlechaProyecto 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.

LlamadaDevuelve
GET /api/v1/program-mapProyectos, 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>/traceLa 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_mapLo mismo que GET /program-map
MCP trace_chainLo mismo que la llamada de traza; los elementos de proyectos con marcados de datos regulados responden withheld

Consulte API y MCP.

Mensajes

MensajeSignificado
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ímiteValor
Pasos de la Traza del elemento1 a 6
Elementos en una Traza del elemento500
Vínculos enumerados por página en la lista de una flecha100
Vínculos por proyecto20.000 (consulte Vínculos a otros proyectos)