Control y revisiones
Líneas de productos y configuraciones
Modele varios productos en un proyecto con características y configuraciones, indique qué elementos se aplican a qué productos con Applies To y la aplicabilidad, vea y edite el modelo como una sola configuración y genere documentos, RVTM y líneas base por configuración.
En esta página
- Resumen
- Conceptos
- Cómo usarlo
- Cuándo y por qué
- Iniciar una línea de productos
- Crear una configuración
- Indicar qué elementos pertenecen a qué productos
- Ver y editar una configuración
- Dar a una configuración su propio valor
- Generar una especificación para una configuración
- Ejemplo práctico: la demostración CubeSat EO-1
- Consejos y buenas prácticas
- Errores habituales
- Cómo se relaciona con otras funciones
- La página Línea de productos
- Se aplica a
- Ver como configuración
- Editar en una vista de configuración
- Valores de configuración
- Aplicabilidad
- Documentos, RVTM y verificación
- Líneas base y solicitudes de cambio
- Comprobaciones del modelo
- Búsqueda, importación y exportación
- API REST y MCP
- Planes
- Proyectos SysML v2
- Límites
- Páginas relacionadas
Resumen
Una línea de productos es una familia de productos que comparten la mayor parte de un mismo diseño. Modele el diseño compartido una vez, marque dónde difieren los productos y defina cada producto como una configuración. Así, cada página puede mostrar el modelo como una configuración, y cada cambio en el diseño compartido llega a todos los productos.
Se trabaja con líneas de productos en estos lugares:
- Control y revisiones → Línea de productos: las características, sus reglas y las configuraciones creadas a partir de ellas.
- El grupo Línea de productos del inspector: Aplica a y aplicabilidad del elemento seleccionado.
- Ver como ▾ en la barra superior: mostrar y editar el modelo como una configuración.
- Documentos, la RVTM, el Centro de pruebas, Líneas base y versiones y Solicitudes de cambio: resultados y control por configuración.
Las líneas de productos forman parte de los planes Individual y Team. Las líneas base por configuración, los propietarios de configuraciones y las configuraciones afectadas por una solicitud de cambio forman parte del plan Team. Consulte Planes.
Conceptos
Funciones
Una característica es una opción que difiere entre productos, como «X-band Downlink» o «Propulsion». Las características forman un árbol: una característica padre agrupa opciones relacionadas.
Cada característica tiene:
- Tipo: Mandatory (toda configuración que tiene la característica padre también la tiene) u Opcional (se elige por configuración). Las características nuevas son Opcional.
- Hijos: la regla sobre sus características hijas. Any number (elección libre), Choose one (exactamente una hija por configuración) o Choose at least one (una o más). Las características nuevas tienen Any number.
- Reglas: una característica requires (requiere) otra característica o la excludes (excluye). Excludes funciona en ambos sentidos.
- Restricción: una regla opcional que debe cumplirse en toda configuración que seleccione la característica, escrita como Aplica a.
Configuraciones
Una configuración es un producto: una selección de características. Cada configuración tiene:
- Un número y un nombre, como CFG-2 EO-1 Lite.
- Estado: Borrador, Publicada o Retirada. Las configuraciones nuevas están en Borrador, y también una copia de una configuración Publicada (Duplicar, copiar y pegar, importar en un proyecto abierto): no tiene registro de publicación propio. Una configuración retirada se puede ver, pero no editar. Una configuración se publica con Publicar configuración… (consulte Publicar una configuración).
- Fase (opcional): la fase del ciclo de vida en la que se encuentra, como Preliminary design o CDR. La fase decide qué reglas de completitud se aplican.
- Owner (opcional, plan Team): la persona o el equipo que debe aprobar las solicitudes de cambio que la modifican.
- Aplicabilidad (opcional): los números de serie o las fechas de fabricación de las unidades construidas según ella.
La selección efectiva de una configuración es más que las características que marca:
- las características seleccionadas;
- sus características padre, hasta la raíz;
- las hijas Mandatory de cada característica seleccionada;
- las características Mandatory de la raíz del árbol.
Veredictos
Holarch comprueba cada configuración con las reglas de características y muestra un veredicto:
- Válida: la selección cumple todas las reglas.
- Breaks: …: se incumple una regla, por ejemplo «Breaks: Encrypted Downlink requires X-band Downlink.» (Encrypted Downlink requiere X-band Downlink).
- Incomplete: …: falta una elección, por ejemplo «Incomplete: choose a Downlink (choose one).» (elija un Downlink).
Cuando fallan varias reglas, el veredicto nombra la primera en este orden: una característica Mandatory que otra característica seleccionada excluye, un grupo Choose one sin elección o con más de una, un grupo Choose at least one sin elección, un requires no cumplido, un excludes incumplido, una Restricción falsa.
Completitud
Un veredicto Válida solo cubre las reglas de características. Completitud comprueba los elementos que contiene una configuración:
- cada requisito hoja que contiene está verificado por un elemento que contiene (un caso de prueba que se aplica a ella);
- cada conexión (Conduit) que contiene tiene ambos extremos en ella, y cada relación con su propio Aplica a tiene ambos extremos en las configuraciones a las que se aplica;
- cada elemento que contiene tiene a su padre en ella.
Cada configuración indica Completo o el número de brechas, como «3 brechas». Las configuraciones retiradas no se comprueban. La completitud no tiene en cuenta la aplicabilidad: un elemento pertenece a una configuración cuando se aplica a ella.
Completitud por fase
La Fase de una configuración elige cuánto se comprueba. Cada fase usa uno de cinco niveles:
| Nivel | Fase predeterminada | Comprobaciones |
|---|---|---|
| 1 | Concepto | El padre de cada elemento está en la configuración. |
| 2 | Preliminary design | Nivel 1, cada conexión tiene ambos extremos en ella, y cada requisito hoja está satisfecho por un elemento que contiene. |
| 3 | Diseño detallado | Nivel 2, y cada requisito hoja está verificado por un elemento que contiene. |
| 4 | Prueba | Nivel 3, cada caso de prueba que verifica tiene un procedimiento (una descripción o pasos de prueba) y un resultado para esta configuración. |
| 5 | Producción | Nivel 4, cada caso de prueba que verifica tiene Passed para esta configuración, y no hay ninguna incidencia abierta vinculada a sus elementos. |
Con un proceso de IS, la lista Fase contiene en su lugar sus puertas de revisión (SRR, PDR, CDR, TRR, etc.), cada una con un nivel: SRR es 1, PDR 2, CDR 3, TRR 4, y las revisiones de producción y operativas 5. Sin una Fase, la completitud usa las reglas anteriores de Completitud (requisitos verificados, extremos de conexiones, padres).
Para cambiar el nivel de una fase, abra ⋯ → Ajustes… en la página Línea de productos y elija un nivel en Fases. Un solo Deshacer revierte el cambio.
La fila Completitud muestra por separado la completitud del modelo y la verificación, por ejemplo «Complete at CDR · 12/40 verified»: la primera parte es la comprobación para la fase; la segunda, los requisitos con un resultado Passed en esta configuración. La verificación se muestra a partir del nivel 3 y sin Fase.
Publicar una configuración
Una configuración se publica con Publicar configuración…: en la página Línea de productos, abra el ⋯ de la columna de la configuración, o pulse ⌘K / Ctrl+K y escriba «Release». Definir el Estado como Publicada en el inspector o en la base de datos abre el mismo diálogo.
El diálogo muestra:
- Fase: la fase para la que es la publicación. La completitud se comprueba para ella.
- Reglas de características y Revisiones: una configuración que incumple una regla, o que tiene dos revisiones vigentes a la vez, no se puede publicar: «CFG-2 cannot be Released. Breaks: Wallbox requires Large pack. Change its selection on the Product Line page first.» (CFG-2 no se puede publicar; cambie primero su selección en la página Línea de productos).
- Completitud en la fase, con Mostrar brechas, y Verificación (cuántos requisitos están verificados en ella).
- Riesgos altos abiertos, solo en una fase de nivel de completitud 5 (Production): los riesgos y peligros de la configuración que están abiertos con un nivel alto (el nivel residual cuando se ha definido uno), por ejemplo «Risk RSK-1 Battery fire: High, Open». Es una advertencia: no bloquea la publicación ni necesita motivo. Un Risk cuenta mientras su Status es Open y no es una Opportunity; un Hazard cuenta hasta que está Accepted o Closed.
- Condición de publicación, solo mientras la configuración no está completa: un Motivo (de 10 a 2.000 caracteres) y el Aprobador. Publicar permanece desactivado hasta que se indican ambos.
Haga clic en Publicar. El Estado de la configuración pasa a Publicada, y Holarch conserva un registro de publicación: la fase, la completitud y la verificación en el momento de la publicación, las brechas aceptadas, el motivo y el aprobador, y la definición publicada (véase más abajo). Un solo Deshacer revierte tanto la publicación como su registro.
La completitud y la verificación se registran tal como Holarch las calculó en su navegador en el momento de la publicación. Holarch en línea comprueba que la definición publicada coincide con su resumen SHA-256 y rechaza una publicación cuyo archivo no coincide; todavía no vuelve a comprobar la completitud.
Quién aprueba:
- Aplicación de escritorio: escriba el nombre del aprobador. Se registra como introducido por nombre; esta copia de Holarch no tiene cuentas.
- Holarch en línea, plan Individual: usted aprueba su propia publicación; el servidor registra su cuenta y la hora.
- Holarch en línea, plan Team: aprueba el Owner de la configuración, o un propietario del proyecto cuando no lo tiene. Una publicación incompleta queda como Pendiente de aprobación hasta que el aprobador abre Publicar configuración… en ella y hace clic en Aprobar publicación (Holarch le pide su contraseña). Solo puede aprobar su propia solicitud cuando el proyecto permite la autoaprobación (Solicitudes de cambio → Ajustes). Una publicación completa no necesita aprobación.
El servidor rechaza un cambio de Estado a Publicada que no venga con un registro de publicación, de modo que un cliente de la API o una página antigua no pueden saltarse el diálogo. También rechaza un guardado del proyecto que quite o cambie un registro de publicación, incluso de un propietario del proyecto.
Retirar publicación… (⋯ de la columna, o volver a definir el Estado como Borrador o Retirada) pide un motivo. El registro de publicación se mantiene y su historial recoge la retirada; un registro de publicación nunca se elimina. Publicar de nuevo crea la publicación 2.
Registrar publicación… (⋯ de la columna) se ofrece para una configuración que se publicó antes de que existieran los registros de publicación. Registra el estado actual de la configuración como su publicación, marcado como «registrada después».
- Definir el Estado de varias configuraciones a la vez (Base de datos → Atributos…) nombra las que incumplen una regla, que se quedan en Borrador, y abre Publicar configuración… para cada una de las demás, una tras otra.
- Retire una publicación en el modelo activo, no en una solicitud de cambio. Para publicar una configuración mediante una solicitud de cambio, prepare la publicación (consulte Publicar mediante una solicitud de cambio). Una solicitud de cambio que solo define el Estado de una configuración como Publicada no la publica cuando se aplica; la configuración conserva su Estado y se aplica el resto de la solicitud.
- Una propuesta de IA o de MCP no puede publicar una configuración: su revisión indica «Requiere un registro de publicación» y ofrece Publicar configuración…; al aplicar la propuesta se aplican sus demás cambios.
La publicación de configuraciones de proyectos SysML v2 todavía no está disponible.
Publicar mediante una solicitud de cambio
Una publicación puede formar parte de una solicitud de cambio, de modo que el comité que aprueba los cambios también aprueba la publicación. Mientras trabaja en una solicitud de cambio (o la tiene abierta), prepare la publicación:
- En la solicitud de cambio, Añadir cambio ▾ → Publicar una configuración… y elija la configuración.
- En la página Línea de productos, ⋯ → Publicar con CR-12… en la columna de la configuración.
- En el inspector o en la base de datos, defina el Estado como Publicada.
El diálogo es el mismo, con el título «Publicar CFG-2 con CR-12». Comprueba la completitud en la fase elegida y enumera los riesgos altos abiertos en el nivel 5, sobre el modelo tal como lo dejaría la solicitud de cambio, y advierte cuando la fase indica menos que la última publicación o deja brechas en la fase siguiente. Mientras la configuración no esté completa, introduzca el Motivo; los aprobadores de la solicitud ocupan el lugar del aprobador. Haga clic en Añadir a CR-12: la publicación se prepara como un cambio («Release CFG-2 at CDR»), la configuración sigue en Borrador hasta entonces (el chip de Estado de su columna indica «Publicación preparada en CR-12») y la configuración cuenta como afectada por la solicitud, por lo que se necesita la aprobación de su Owner donde se aplican reglas de aprobación.
Cuando se aplica la solicitud aprobada, Holarch publica la configuración y conserva su registro de publicación, con la fase, el motivo y las brechas aceptadas tal como se prepararon, y los aprobadores de la solicitud y via CR-12. Un solo Deshacer revierte tanto la solicitud aplicada como la publicación. Holarch no publica una configuración cuando, en el momento de aplicar, se ha eliminado o retirado, ya está publicada o espera aprobación, incumple una regla de características o tiene brechas que la solicitud no aceptó. El resto de la solicitud se aplica igualmente, y el historial de la solicitud y el resultado indican el motivo. Vuelva a preparar la publicación después de corregirlo.
Holarch en línea registra las aprobaciones a partir de los votos de la solicitud (cuentas y horas del servidor), nunca a partir de nombres escritos en la página. Una publicación incompleta aprobada por la solicitud no necesita un Aprobar publicación aparte. Solo la persona que aplica la solicitud puede registrar sus publicaciones, en la hora siguiente a la comprobación de la aprobación; un guardado del proyecto o un cliente de la API no pueden añadir una publicación mediante una solicitud de cambio.
La definición publicada
Cada registro de publicación conserva la configuración tal como se publicó: sus elementos y relaciones con sus valores, la selección, las características y configuraciones de biblioteca que usó, los elementos vinculados de otros proyectos tal como se leyeron en la publicación, y los resultados de verificación. Se almacena en el proyecto como un archivo comprimido con un resumen SHA-256.
En Líneas base y versiones, la tarjeta Publicaciones enumera cada publicación con su configuración, fase, completitud, aprobador, fecha y estado. Su menú ⋯ ofrece:
- Abrir definición publicada: los elementos publicados con sus valores tal como se publicaron (por ejemplo, la Mass propia de una configuración), de solo lectura.
- Verificar: comprueba que el registro coincide con su resumen (íntegro) y reconstruye la configuración a partir de las propias entradas del registro (reproducida exactamente): su instantánea, las características y configuraciones de biblioteca que congeló y el esquema con el que se resolvió. Las ediciones posteriores, las nuevas publicaciones de bibliotecas, los elementos vinculados modificados y las clases, atributos o relaciones con nombre cambiado no alteran el resultado.
- Comparar con hoy: lo que muestra ahora la configuración en comparación con la publicación, incluidas las bibliotecas que pasaron a otra publicación (nombradas con sus etiquetas de publicación) y los elementos vinculados que cambiaron desde entonces.
- Exportar (JSON): el registro con su definición.
- Retirar…
Aplica a y aplicabilidad
Dos campos de cualquier elemento o relación indican a qué productos pertenece:
- Aplica a indica qué configuraciones incluyen el elemento. Es una expresión de características y configuraciones, como
F-4 and not F-5. Vacío significa todas las configuraciones. - Aplicabilidad indica a partir de qué unidad o fecha está vigente el elemento: números de serie como
1-20, 25, 40-, un intervalo de fechas, o ambos. Vacío significa siempre.
Ambos son independientes y se combinan: un elemento está en una vista cuando se aplica a la configuración y está vigente en el número de serie o la fecha de la vista.
Identidad compartida y valores de configuración
Un elemento es un único elemento en todas las configuraciones. Su Nombre, Número, Clase, Etiquetas y Responsable son los mismos en todas partes, y también su lugar en las jerarquías, el orden en los documentos y la disposición en los diagramas.
Su Descripción y sus valores de atributos pueden diferir. Un valor de configuración es el valor propio de un elemento para una configuración, como un Daily Data Volume de 1 GB en EO-1 Lite mientras las demás configuraciones mantienen 3 GB. Una configuración sin valor propio usa el valor base del elemento.
La vista del 150 %
Todas las configuraciones (ninguna configuración elegida) muestra toda la línea de productos: todos los elementos de todos los productos, con los valores base. Los campos que difieren según la configuración se marcan como Varía. Es la vista en la que se renumera, se restauran líneas base y se eliminan elementos en todas partes.
Cómo usarlo
Cuándo y por qué
Use una línea de productos cuando varios productos compartan la mayor parte de sus requisitos, funciones y arquitectura: una unidad de vuelo y una variante más ligera, versiones de exportación, opciones del cliente, mejoras por bloques. Un solo modelo mantiene sincronizadas las partes compartidas. Cada configuración sigue teniendo su propia especificación, su RVTM y sus líneas base.
Un buen orden de trabajo:
- Modele el diseño compartido como de costumbre.
- Enumere como características los puntos en los que difieren los productos, con sus reglas.
- Añada una configuración por producto y compruebe que cada una es válida.
- Marque con Aplica a los elementos que solo tienen algunos productos, y con valores de configuración los valores que difieren.
- Genere los documentos y verifique cada configuración.
Si sus productos solo difieren en las fechas de fabricación o los números de serie, cree una sola configuración (por ejemplo «Production») y use únicamente la aplicabilidad.
Iniciar una línea de productos
- Pulse ⌘K / Ctrl+K y elija Iniciar una línea de productos…: abre la página y el diálogo Nueva característica. O cree un elemento Característica o Configuración con + Nuevo elemento en la base de datos. Verá Control y revisiones → Línea de productos en la barra de navegación, y un grupo Línea de productos en el inspector de cada elemento.
- En la página Línea de productos, haga clic en + Nueva característica y escriba el nombre de la característica, como «Downlink». Pulse Enter. El nombre se guarda y empieza una nueva fila hermana.
- Escriba el nombre de la característica siguiente. Para convertirla en hija de la fila de arriba, pulse ⌥⇧→ / Alt+Shift+→. ⌥⇧← / Alt+Shift+← la vuelve a sacar.
- Defina el Tipo y los Hijos de cada característica en el inspector (pulse Enter en su fila).
- Añada reglas desde el menú ⋯ de la fila: Reglas… para requires y excludes, Restricción… para una restricción.
La página Línea de productos, el grupo del inspector y la columna Aplica a permanecen ocultos hasta que un proyecto tiene su primera Feature o Configuration. Vuelven a ocultarse cuando se elimina la última, excepto en los elementos que aún tienen un valor de Aplica a o de aplicabilidad.
Crear una configuración
- En la página Línea de productos, haga clic en + Nueva configuración. Escriba un nombre, como «EO-1 Lite». Aparece una columna nueva en Configuraciones.
- Marque las características que tiene este producto. En un grupo Choose one, las celdas son botones de opción: elegir uno sustituye al otro. Las celdas marcadas como implícitas se incluyen por otra característica (un padre o una hija Mandatory); no se pueden cambiar.
- Lea la fila Veredicto bajo la columna. Corrija la selección hasta que indique Válida.
- Lea la fila Completitud. Señale un recuento de brechas para ver las brechas.
- Haga clic en Comprobar configuraciones para comprobar todas las configuraciones a la vez.
Para empezar a partir de un producto existente, abra el menú ⋯ del encabezado de la columna de la configuración y elija Duplicar. La copia tiene la misma selección y los mismos valores de configuración.
Indicar qué elementos pertenecen a qué productos
- Seleccione un elemento, como un requisito, y abra el grupo Línea de productos del inspector.
- En Aplica a, escriba un número de característica o de configuración, como
F-4. Elija de la lista de sugerencias con ↓ y Enter. La línea bajo el campo indica, por ejemplo, «Se aplica a 1 de 2 configuraciones: CFG-1». - Combine términos con
and,or,noty paréntesis:F-3 and not F-5. - O haga clic en Elegir… y elija configuraciones o características de una lista.
Deje Aplica a vacío para los elementos que tienen todos los productos. La mayoría de los elementos se quedan vacíos.
Ver y editar una configuración
- Haga clic en Ver como ▾ en la barra superior y elija una configuración. Verá un banner: «Viendo la configuración CFG-2 EO-1 Lite. Los elementos nuevos se aplican solo a CFG-2; los valores modificados pasan a ser de CFG-2.» Ahora cada página muestra solo los elementos de CFG-2, con los valores de CFG-2.
- Trabaje como de costumbre. Los elementos nuevos se aplican a CFG-2. Una descripción o un atributo modificados pasan a ser el valor propio de CFG-2 cuando otras configuraciones también tienen el elemento.
- Haga clic en Salir en el banner para volver a ver todas las configuraciones.
La elección pertenece a la pestaña del navegador. Las demás personas y las demás pestañas conservan su propia vista. Consulte Editar en una vista de configuración para conocer todas las reglas.
Dar a una configuración su propio valor
- Elija la configuración en Ver como ▾.
- Seleccione el elemento y cambie el atributo en el inspector. Mientras edita, la indicación bajo el campo dice, por ejemplo, «Guardado solo para CFG-2. Las demás configuraciones mantienen 3 GB.» Después del cambio, el campo muestra un chip Valor de CFG-2.
- Para deshacer la diferencia, abra el menú del chip y elija Usar valor base.
Generar una especificación para una configuración
- Abra el documento, haga clic en Entregar ▾ y elija una plantilla de Word, como Especificación (Word). Verá el diálogo Exportar a Word.
- Defina Configuración como el producto, y Aplicabilidad como Cualquier unidad, un Número de serie o una Fecha.
- Exporte el documento. El documento omite las secciones que no se aplican, numera el resto tal como se muestra y nombra la configuración en la portada, en el pie de página y en el nombre del archivo.
Ejemplo práctico: la demostración CubeSat EO-1
El proyecto de demostración CubeSat EO-1 tiene dos productos: EO-1 Flight, con un enlace descendente en banda X y cifrado, y EO-1 Lite, con el enlace descendente en banda S. Cree la demo con Archivos de proyecto ▾ → Nuevo proyecto de demostración en Gestionar proyectos.
- Abra Control y revisiones → Línea de productos. Verá las características Downlink (Mandatory, Choose one) con S-band Downlink y X-band Downlink, Encrypted Downlink (Opcional, requiere X-band Downlink) y Propulsion (Opcional, requiere X-band Downlink).
- Observe las configuraciones CFG-1 EO-1 Flight (banda X y Encrypted Downlink, números de serie 1–2) y CFG-2 EO-1 Lite (banda S, números de serie 3 y posteriores). Ambos veredictos indican Válida.
- En la columna CFG-2, marque Encrypted Downlink. El veredicto cambia a «Breaks: Encrypted Downlink requires X-band Downlink.» (Encrypted Downlink requiere X-band Downlink). Pulse ⌘Z / Ctrl+Z.
- Abra el requisito 4.4 Downlink Encryption. Su Aplica a es la característica Encrypted Downlink (F-4), por lo que solo está en EO-1 Flight. 1.5.2 S-band Transmitter, sus interfaces IF-08 e IF-12, y 5.1 S-band Downlink Rate se aplican a F-2; 1.5.3 X-band Payload Radio, sus interfaces IF-08.1 e IF-12.1, 5.5 X-band Downlink Rate y su caso de prueba TC-21 X-band Link Test se aplican a F-3.
- Elija Ver como ▾ → CFG-2 EO-1 Lite y abra el requisito 5.4 Daily Data Volume. Su descripción indica «at least 1 GB» con un chip Valor de CFG-2. En EO-1 Flight conserva el texto base, «at least 3 GB».
- Abra el caso de prueba TC-11 UHF Command Test. Contiene un resultado por configuración: Passed en EO-1 Flight, In Progress en EO-1 Lite.
- Abra 1.3.2 Battery Pack y observe sus características Thermostat Heater Power (2 W, aplicabilidad SN 1) y Software-Controlled Heater Power (3 W, SN 2 y posteriores): el calentador cambió a partir del segundo vehículo espacial.
- Abra Control y revisiones → Líneas base y versiones. EO-1 Flight PDR es una línea base de CFG-1 (plan Team).
- Abra Verificación → Comprobaciones del modelo en Todas las configuraciones. Las reglas de Línea de productos advierten de que ninguna configuración selecciona Propulsion (ProductLine.4). La demo la deja sin seleccionar a propósito, como ejemplo de esa comprobación.
Consejos y buenas prácticas
- Defina características sobre el producto, no sobre los documentos: «X-band Downlink», no «Section 5 option».
- Prefiera los términos de características en Aplica a.
F-3sigue siendo correcto cuando añade un tercer producto con enlace descendente en banda X;CFG-1no. - Agrupe muchas opciones relacionadas bajo una característica padre en lugar de escribir expresiones largas.
- Dé valores de configuración solo a los valores que realmente difieren. Todo lo demás sigue compartido.
- Use Publicada para las configuraciones bajo control y Retirada para los productos que ya no se fabrican.
- Modele un cambio de pieza a partir de un número de serie como dos elementos, el antiguo y el nuevo, cada uno con su propia aplicabilidad.
Errores habituales
- Un elemento desaparece de una vista tras una edición. Su Aplica a o su aplicabilidad ya no incluyen la configuración. El aviso lo nombra; haga clic en Deshacer o búsquelo en Todas las configuraciones.
- Una configuración sigue en Incomplete. Un grupo Choose one o Choose at least one no tiene ninguna elección. Marque una hija de ese grupo.
- Un elemento no está en ninguna configuración. Su Aplica a nombra características que ninguna configuración selecciona. Comprobaciones del modelo lo notifica (ProductLine.2).
- Un movimiento cambia todos los productos. La estructura es compartida: mover o reordenar un elemento en una vista de configuración lo mueve en todas las configuraciones.
Cómo se relaciona con otras funciones
- Documentos: genere por configuración y número de serie o fecha.
- RVTM y Centro de pruebas: registre los resultados por configuración; «verificado» significa verificado para ese producto.
- Comprobaciones del modelo: el conjunto de reglas Línea de productos comprueba expresiones, veredictos, aplicabilidad y revisiones (supersedes).
- Líneas base y versiones (Team): cree una línea base de una configuración y compare configuraciones.
- Solicitudes de cambio (Team): vea qué configuraciones cambia una solicitud; los propietarios aprueban.
- Buscar:
appliesto:CFG-2yvaries:yesencuentran elementos por configuración. - API REST y MCP: lea el modelo como una configuración.
La página Línea de productos
Control y revisiones → Línea de productos muestra las características a la izquierda y las configuraciones a la derecha. Con menos de 1.100 px de ancho, las dos regiones se apilan.
Encabezado de página
| Control | Qué hace |
|---|---|
| + Nueva característica | Añade una característica con el número siguiente (F-1, F-2, …) al final del árbol. |
| Comprobar configuraciones | Enumera cada configuración con Válida o su primer problema, y Completo o sus brechas. |
| + Nueva configuración | Añade una columna de configuración con el número siguiente (CFG-1, CFG-2, …). |
| ⋯ | Exportar CSV (características por configuraciones, con Selected o Implied y los veredictos) y Ayuda. |
Funciones
Una cuadrícula de árbol con las columnas Característica (número y nombre), Tipo, Hijos y Usado por (cuántos elementos nombran la característica en Aplica a). Las reglas se muestran como pequeñas etiquetas en la fila, como «requires F-3».
Defina el Tipo y los Hijos de una característica en el inspector: pulse Enter en la fila para abrirla allí.
Menú ⋯ de la fila:
- Añadir característica hija…
- Cambiar nombre (F2)
- Reglas…: listas de verificación Requiere y Excluye
- Restricción…: una expresión de Aplica a que debe cumplirse cuando la característica está seleccionada
- Mostrar elementos que la usan
- Eliminar…
Configuraciones
Una cuadrícula con una fila por característica (en el orden del árbol) y una columna por configuración. Cada encabezado de columna muestra el número, el nombre y el Estado, y el propietario en el plan Team.
Celdas:
- Una casilla para las características que se eligen libremente.
- Un botón de opción para las hijas de una característica Choose one.
- Una marca de implícita para las características incluidas por otra. La información sobre herramientas la nombra, por ejemplo «Incluida porque F-1 está seleccionada.»
La fila Veredicto de la parte inferior muestra Válida o el primer problema (las reglas de características). La fila Completitud bajo ella muestra Completo o el número de brechas; su información sobre herramientas las enumera (consulte Completitud).
Menú ⋯ del encabezado de columna:
- Ver como esta configuración
- Cambiar nombre…
- Aplicabilidad…
- Propietario… (Team): abre la configuración en el inspector.
- Línea base CFG-2… (Team): guarda una línea base de esta configuración (consulte Líneas base por configuración).
- Duplicar: copia la selección y todos los valores de configuración, y un solo Deshacer lo revierte todo. La copia es un Borrador llamado «<name> (copy)».
- Retirar, o Devolver a Borrador en una configuración retirada. La vista de una configuración retirada es de solo lectura.
- Eliminar…: mueve la configuración a la papelera. Los elementos conservan sus valores, de modo que Restaurar la recupera intacta.
Estados vacíos
- Sin características: «Aún no hay características. Añada la primera característica: una opción que difiere entre productos.»
- Sin configuraciones: «Aún no hay configuraciones. Una configuración es un producto: una selección de características.»
Teclado
| Teclas | Dónde | Qué hacen |
|---|---|---|
| Tab | Página | Se desplaza entre las acciones del encabezado y las dos cuadrículas. Nunca aplica sangría. |
| Home / End | Funciones | Primera o última fila. |
| ↑ / ↓ | Funciones | Fila anterior o siguiente. |
| ← / → | Funciones | Contraer o expandir. |
| Enter | Funciones | Durante la asignación de nombre: guarda el nombre y empieza una nueva hermana debajo. En una fila seleccionada: abre la característica en el inspector. |
| F2 | Funciones | Cambia el nombre de la característica en el sitio. Esc, o dejar el nombre vacío, no añade nada. |
| ⌥ / Alt+↑ / ⌥ / Alt+↓ | Funciones | Sube o baja la característica entre sus hermanas (las dos características intercambian sus números). |
| ⌥⇧→ / Alt+Shift+→ / ⌥⇧← / Alt+Shift+← | Funciones | Aplica o quita sangría a la característica, como en el esquema del documento. |
| Delete | Funciones | Elimina la característica, tras una confirmación. |
| Teclas de flecha | Configuraciones | Pasar de una celda a otra. |
| Space | Configuraciones | Marca o desmarca la celda. |
| Enter | Configuraciones | En un encabezado de columna: abre su menú. |
| Home / End | Configuraciones | Primera o última columna. |
Lectores de pantalla
Las características son una cuadrícula de árbol llamada «Características». Las configuraciones son una cuadrícula llamada «Configuraciones por característica»; cada celda se lee, por ejemplo, como «F-3 X-band Downlink en CFG-1 EO-1 Flight: seleccionada». Los cambios se anuncian: «X-band Downlink seleccionada para CFG-1.», «CFG-2 incumple una regla: Encrypted Downlink requiere X-band Downlink.», «CFG-2 es válida.»
Se aplica a
Aplica a indica qué configuraciones incluyen un elemento. Está en el grupo Línea de productos del inspector (después de los grupos de atributos), en la vista del elemento y como columna de la base de datos. Todavía no: editar el Aplica a de una relación en el panel de relaciones.
El campo
- Aplica a: la expresión. Vacía muestra «Todas las configuraciones».
- Elegir…: elija configuraciones o características de una lista en lugar de escribir.
- La línea de vista previa bajo él: «Se aplica a 2 de 4 configuraciones: CFG-1, CFG-3» o «Se aplica a todas las configuraciones».
- Cuando una vista de configuración ha añadido o quitado el elemento, chips como Quitado de CFG-2 y Añadido a CFG-4. Haga clic en ✕ en uno para borrarlo: el elemento vuelve a seguir Aplica a para esa configuración.
- Una advertencia cuando la expresión nombra una característica o una configuración eliminada (se muestra con su número antiguo).
Los elementos Feature y Configuration no tienen Aplica a.
En la base de datos, la columna Aplica a aparece en cuanto algún elemento usa Aplica a (ocúltela desde su ▾ y vuelva a añadirla desde Columnas). Haga doble clic en una celda, o pulse Enter o F2, para editarla con el mismo campo.
Al escribir se abre una lista de características y configuraciones coincidentes, y después de los operadores. ↓/↑ se desplazan, Enter o Tab inserta, Esc cierra la lista, un segundo Esc revierte el campo. Enter guarda; salir del campo guarda cuando la expresión es válida.
El diálogo Elegir…
Aplica a — <item> ofrece tres opciones:
- Todas las configuraciones: borra la expresión.
- Estas configuraciones: marque configuraciones; escribe
CFG-1 or CFG-3. - Características: marque características y elija Todas (escribe
F-2 and F-5) o Cualquiera (escribeF-2 or F-5).
La expresión resultante se muestra debajo. Editar como expresión la coloca en el campo de texto sin guardarla. Aplicar la guarda, y un solo Deshacer lo revierte todo.
La expresión de Aplica a
| Lo que escribe | Significa |
|---|---|
F-3 o "X-band Downlink" | Una característica, por número o por nombre entre comillas. Verdadero cuando la selección efectiva de la configuración la contiene. |
CFG-2 o config "EO-1 Lite" | Una configuración. Verdadero solo para esa configuración. |
and, or, not, ( ) | Combinar términos. &, | y ! también funcionan y se muestran como palabras. not se evalúa primero, después and y después or. |
all, none | Todas las configuraciones, o ninguna. |
No se distinguen mayúsculas y minúsculas. Holarch almacena la expresión con los id de los elementos, de modo que cambiar el nombre o el número de una característica nunca la rompe. Muestra números, o el nombre entre comillas para un elemento sin número.
Una característica eliminada o desconocida es falsa, y Comprobaciones del modelo lo notifica como error.
Mensajes de las expresiones
Una expresión no válida nunca se guarda. El campo conserva su texto, marca el error y sigue vigente el último valor válido. Las posiciones cuentan caracteres desde 1.
| Mensaje | Qué hacer |
|---|---|
| Ninguna característica ni configuración se llama “F-9”. Elija una de la lista o cree primero la característica. | Compruebe el número o cree la característica. |
| Se esperaba una característica o una configuración después de “and” (carácter 12). | Añada un término después del operador. |
| Se esperaba una característica o una configuración en el carácter 1. | Empiece con un término, not o (. |
| Se esperaba “and” u “or” antes de “F-5” (carácter 9). | Una los dos términos con un operador. |
| Falta “)” para el “(” del carácter 5. | Cierre el paréntesis. |
| “)” en el carácter 9 no tiene un “(” correspondiente. | Quite el paréntesis sobrante. |
| Falta la comilla de cierre del nombre en el carácter 4. | Cierre el nombre entre comillas. |
| “Wallbox” coincide con 2 características (F-3, F-11). Use el número. | Dos características comparten el nombre; escriba el número. |
| Aplica a es demasiado largo. Use como máximo 200 características y configuraciones; agrúpelas en su lugar con una característica padre. | Acorte la expresión. |
Ver como configuración
Ver como ▾ muestra todo el modelo como una configuración. Está en la barra superior, a la izquierda del estado de guardado, en cuanto el proyecto tiene una configuración.
El menú
- Todas las configuraciones: toda la línea de productos.
- Una entrada por configuración, con su Estado y una marca cuando incumple una regla o está incompleta.
- Aplicabilidad ▸: Cualquier unidad, Número de serie…, Fecha… o Número de serie y fecha…. Consulte Ver en un número de serie o una fecha.
- Gestionar línea de productos: abre la página Línea de productos.
El menú se abre con Enter, Space o ↓; las teclas de flecha se desplazan, Enter elige y Esc cierra. ⌘K / Ctrl+K tiene Ver como configuración…, Ver todas las configuraciones, Definir aplicabilidad…, Ir a Línea de productos, Nueva característica…, Nueva configuración… y, en una vista, Añadir existente a CFG-2….
El banner
Mientras hay una configuración elegida, un banner bajo la barra superior indica, por ejemplo, «Viendo la configuración CFG-2 EO-1 Lite en SN 23. Los elementos nuevos se aplican solo a CFG-2; los valores modificados pasan a ser de CFG-2.» Muestra cuántos elementos hay en la vista («1.204 de 1.350 elementos») y tiene:
- Cambiar ▾: el mismo menú que Ver como ▾.
- Salir: vuelve a Todas las configuraciones.
Cuando también trabaja en una solicitud de cambio, el banner de la solicitud de cambio aparece primero y el de la configuración en segundo lugar.
Qué muestra cada página
- Se omiten los elementos y las relaciones que no se aplican a la configuración o que no están vigentes en el punto de la vista.
- Los elementos con valores de configuración muestran esos valores.
- Los recuentos, los totales acumulados, los presupuestos, la simulación, las puntuaciones de calidad y las comprobaciones del modelo se calculan para la configuración.
- Los esquemas de documentos, los documentos generados y la RVTM numeran los elementos tal como se muestran. Los números almacenados no cambian; las exportaciones indican «Numeración como se muestra en CFG-2.»
- La búsqueda y las consultas se ejecutan sobre la vista.
La elección pertenece a la pestaña del navegador y se mantiene al recargarla. Cambiar de vista no es una edición, por lo que Deshacer lo omite.
Lectores de pantalla
El botón indica «Ver como: CFG-2 EO-1 Lite». El banner es una región llamada «Vista de configuración». Entrar, salir y cambiar el punto se anuncian, por ejemplo «Viendo la configuración CFG-2 EO-1 Lite. Se aplican 1.204 de 1.350 elementos.» y «Viendo todas las configuraciones.»
Editar en una vista de configuración
En una vista de configuración se edita como en cualquier otro lugar. Holarch convierte cada edición en un cambio de toda la línea de productos, de modo que las demás configuraciones conservan lo que tenían. Cada acción se puede deshacer con un solo Deshacer.
Crear y cambiar elementos
| Lo que hace | Qué ocurre |
|---|---|
| Crear un elemento (de cualquier forma: + Nuevo, un diagrama, un documento, una fila de la base de datos, pegar, duplicar, una plantilla, una importación, una propuesta de IA o de MCP aplicada) | El elemento se aplica solo a esta configuración. Con una sola configuración, Aplica a se queda vacío. |
| Duplicar, o Copiar con hijos | Cada copia se aplica a esta configuración y toma los valores mostrados como sus valores base. |
| Cambiar Nombre, Número, Clase o Etiquetas | Los cambia para todas las configuraciones. El campo muestra un icono Compartido; el cambio se anuncia, por ejemplo, como «Nombre cambiado para todas las configuraciones.» |
| Cambiar la Descripción o un atributo de un elemento que tienen otras configuraciones | Se guarda como valor propio de esta configuración. Un valor igual al valor base quita el valor propio. Las configuraciones retiradas cuentan como otras configuraciones, por lo que conservan sus valores. |
| Cambiar la Descripción o un atributo de un elemento que solo tiene esta configuración | Se guarda como valor base. |
| Cambiar Aplica a o la aplicabilidad | Los cambia para todas las configuraciones. Los campos muestran un icono Compartido y, mientras edita, la indicación dice «Cambia Aplica a para todas las configuraciones, no solo para CFG-2.» Cuando el elemento ya no pertenece a la vista, sale de ella: «R-4.2 ya no se aplica a CFG-2.» con Deshacer. |
| Añadir una relación | Se añade a la línea de productos. Se limita a esta configuración cuando sus dos extremos también están juntos en otra configuración. |
| Cambiar un atributo de una relación | Como para un atributo de un elemento. |
| Mover, reordenar, aplicar o quitar sangría, o cambiar de padre | Cambia la estructura compartida para todas las configuraciones: «Movido para todas las configuraciones.» |
| Cambiar la disposición del diagrama | Compartida por todas las configuraciones. |
| Registrar un resultado de prueba | Se guarda como resultado de esta configuración, también cuando ninguna otra configuración tiene el caso de prueba. Ejecutar suite indica «Registrando resultados para CFG-2.» |
| Editar el esquema, los ajustes del proyecto, el uso compartido o las suscripciones a bibliotecas | Compartido, como en Todas las configuraciones. |
Quitar y eliminar
| Lo que hace | Qué ocurre |
|---|---|
| Eliminar un elemento que tienen otras configuraciones | Una confirmación pregunta, por ejemplo, «¿Quitar R-4.2 de CFG-2? Permanece en CFG-1 y CFG-3.» Quitar de CFG-2 lo saca solo de esta configuración; Eliminar en todas partes… lo envía a la papelera. |
| Quitar un elemento así que tiene hijos | Quitar también sus 3 hijos de CFG-2 (activado de forma predeterminada). Desactivado: los hijos se quedan en la configuración y se muestran en el nivel inmediatamente superior. |
| Eliminar un elemento que solo tiene esta configuración | Se envía a la papelera, como de costumbre. |
| Quitar una relación que tienen otras configuraciones | Se quita solo de esta configuración: «Se quitó el vínculo de CFG-2. Permanece en otras 2 configuraciones.» |
| Quitar una relación que solo tiene esta configuración | Se elimina, como de costumbre. |
| Quitar del diagrama | Quita la relación del elemento con el diagrama para esta configuración. En los diagramas que solo enumeran sus formas, el diálogo indica «Quita la forma de este diagrama en todas las configuraciones.» |
| Restaurar desde la papelera | Restaura el elemento en la línea de productos. Si no se aplica a la configuración: «Se restauró R-4.2. No se aplica a CFG-2.» |
Cuando una edición saca de la vista el elemento seleccionado, el foco pasa al elemento siguiente de la misma lista y el aviso indica adónde fue el elemento.
Añadir un elemento existente
Los selectores para añadir un elemento existente a un diagrama, un documento o una relación enumeran los elementos de la vista. Para incorporar un elemento que no se aplica a la configuración, use Añadir existente a CFG-2… en ⌘K / Ctrl+K o el menú Cambiar ▾ del banner: «Battery añadido a CFG-2.»
Qué no está disponible en una vista
- Renumerar…, Renumerar desde aquí… y Renumerar hijos…: los números son comunes a todas las configuraciones. Renumere en Todas las configuraciones.
- Restaurar línea base y Restaurar versión anterior: «Salga de la vista de configuración para restaurar una línea base.»
- Cualquier edición en una configuración Retirada: «CFG-1 está retirada. Cópiela para hacer cambios.» Una configuración Publicada sigue siendo editable salvo que el control de configuración la bloquee.
Las configuraciones publicadas y retiradas conservan sus valores
Una edición en otro lugar nunca cambia lo que muestra una configuración Retirada, y solo cambia una configuración Publicada mediante una solicitud de cambio. Cuando cambia el valor base de un elemento (en Todas las configuraciones, con Convertir en valor base, o mediante una importación o una propuesta de IA o de MCP aplicada), cada configuración Retirada, y cada Publicada fuera de una solicitud de cambio, que tiene el elemento y ningún valor propio recibe el valor anterior como valor propio como parte del mismo cambio. Un valor base que estaba vacío no se conserva.
Los elementos bloqueados, montados desde bibliotecas y controlados mantienen también sus reglas habituales para los valores de configuración.
Deshacer e historial
- Deshacer funciona entre cambios de vista. Cuando el paso se hizo en otra vista, el aviso la nombra: «Se deshizo un cambio hecho en CFG-2: Mass de Battery.»
- Historial muestra «En CFG-2» junto a cada cambio hecho en esa vista.
Trabajar con otras personas
Dos personas en configuraciones distintas nunca sobrescriben los valores ni las eliminaciones de la otra. Una edición de base y un valor de configuración nunca entran en conflicto. Si dos personas cambian el mismo campo para la misma configuración, prevalece el cambio posterior, como en cualquier campo.
Cuando alguien elimina la configuración que está viendo, su pestaña vuelve a Todas las configuraciones: «Se eliminó CFG-2. Se muestran todas las configuraciones.»
Valores de configuración
Un valor de configuración es la Descripción o el valor de atributo propio de un elemento para una configuración.
Qué campos pueden diferir
| Campo | Puede diferir según la configuración |
|---|---|
| Descripción, todos los atributos, atributos de relaciones | Sí |
| Nombre, Número, Clase, Etiquetas, Responsable | No: identifican el elemento |
| Aplica a, aplicabilidad, atributos de Feature y Configuration, selects, requires, excludes | No: definen las configuraciones |
| Atributos con un flujo de aprobación (como el Status de Requirement con aprobaciones) | No: un registro de aprobación por elemento |
| Resultados de calidad, datos de revisión y valores calculados | No: se calculan para cada vista |
| Disposición de diagramas y ajustes de documentos | No |
En una vista de configuración
- Un campo con valor propio de esta configuración muestra el chip Valor de CFG-2. Su menú:
- Usar valor base (3 GB): quita el valor propio.
- Convertir en valor base: convierte este valor en la base; los valores propios de las demás configuraciones se mantienen.
- Valores en todas las configuraciones…
- Un campo que nunca difiere muestra un icono Compartido («Compartido por todas las configuraciones.»).
- Mientras edita un campo de un elemento que tienen otras configuraciones, la indicación dice «Guardado solo para CFG-2. Las demás configuraciones mantienen 3 GB.»
En Todas las configuraciones
Un campo con valores propios muestra Varía (2). Su menú tiene Valores en todas las configuraciones… y Borrar valores de configuración.
Mientras edita un campo que puede diferir, la indicación dice a qué configuraciones llega el cambio, por ejemplo «Cambia CFG-2 y CFG-3. CFG-1 (Publicada) mantiene 1.400. CFG-4 mantiene su propio valor.»
Valores en todas las configuraciones… enumera primero el Valor base y después cada configuración con su Valor y su Origen («valor propio» o «base»). Edite una fila en el sitio y pulse Enter para guardarla.
En la base de datos, una celda con valor propio tiene una marca en la esquina. El historial, las listas de cambios y las comparaciones nombran un valor de configuración como, por ejemplo, «Mass (CFG-2)», y un cambio de pertenencia como «En CFG-2».
Aplicabilidad
La aplicabilidad indica a partir de qué unidad o fecha de fabricación está vigente un elemento, una relación o una configuración. Los campos de aplicabilidad aparecen en cuanto el proyecto tiene una configuración.
Campos
En el grupo Línea de productos del inspector, bajo Aplica a, y en el diálogo Aplicabilidad… de una configuración:
- Números de serie: una lista como
1-20, 25, 40-.40-significa 40 y posteriores. Déjelo vacío para todas las unidades. - Aplicable desde: la primera fecha de fabricación a la que se aplica (AAAA-MM-DD).
- Hasta (sin incluir): la primera fecha de fabricación a la que ya no se aplica.
Un resumen bajo los campos indica, por ejemplo, «Vigente para SN 1–20 y 25, y SN 40 en adelante.» Las etiquetas de otros lugares indican «SN 1–20, 25, 40– · From 2027-03-01». Con números de serie y fechas definidos a la vez, deben cumplirse ambos.
Los números de serie se almacenan ordenados y fusionados. Hasta 200 intervalos, números de hasta 1.000.000.000.000. Todavía no: un prefijo de serie del proyecto, para escribir números como SN-0021.
La aplicabilidad de una configuración nombra las unidades construidas según ella. No filtra los elementos de esa configuración.
Ver en un número de serie o una fecha
- Elija Ver como ▾ → Aplicabilidad ▸ → Número de serie… (o Fecha…, o Número de serie y fecha…), o ⌘K / Ctrl+K Definir aplicabilidad….
- Introduzca el número de serie, la fecha de fabricación o ambos. El banner añade el punto: «Viendo la configuración CFG-3 Block 2 en SN 23.»
Un número de serie y una fecha de fabricación juntos describen una unidad: «SN 75 fabricada el 2027-06-15». Un elemento se muestra entonces cuando se cumplen ambos, cada uno donde el elemento lo define. Número de serie… conserva una fecha ya elegida y Fecha… conserva un número de serie; Cualquier unidad borra ambos. Los documentos (Número de serie y fecha en el diálogo Exportar), la RVTM y la API (effectivity=sn:75,date:2027-06-15) admiten el mismo punto.
| El elemento tiene | Vista en un número de serie | Vista en una fecha |
|---|---|---|
| Solo números de serie | Se muestra cuando el número está en su lista | Se muestra, con su etiqueta |
| Solo fechas | Se muestra, con su etiqueta | Se muestra cuando la fecha está en su intervalo |
| Ambos | Se muestra cuando el número está en su lista | Se muestra cuando la fecha está en su intervalo |
| Ninguno | Se muestra | Se muestra |
Elegir un número de serie con Todas las configuraciones selecciona la configuración cuyos números de serie lo contienen. Cuando hay varias, el menú las enumera («SN 23 está en CFG-2 y CFG-3. Elija una.»). Cuando el punto está fuera de la aplicabilidad propia de la configuración elegida, el banner advierte: «SN 23 está fuera de la aplicabilidad de CFG-2 (SN 1–20).»
Mensajes de aplicabilidad
| Mensaje | Qué hacer |
|---|---|
| “x” no es un número de serie ni un intervalo. Use números e intervalos como 1-20, 25, 40-. | Corrija la parte indicada. |
| El intervalo “20-1” va hacia atrás. Escriba primero el número menor. | Intercambie los números. |
| Use como máximo 200 intervalos de serie. | Fusione intervalos. |
| Los números de serie llegan hasta 1000000000000. | Use un número menor. |
| “x” no es una fecha. Use AAAA-MM-DD. | Corrija la fecha. |
| Aplicable hasta debe ser posterior a Aplicable desde. | Cambie una de las fechas. |
| Escriba los números de serie como intervalos, por ejemplo 1-20, 25, 40-. | Se muestra bajo el campo; corrija los intervalos. |
| Hasta debe ser posterior a Desde. | Se muestra bajo el campo; cambie una de las fechas. |
| SN 12–30 se superpone a CFG-3 (SN 21–40). | Una advertencia en las configuraciones, no bloqueante: dos productos comparten números de serie. |
Revisiones de un elemento
Cuando una pieza cambia a partir de un número de serie o una fecha, modele la pieza antigua y la nueva como dos elementos, cada uno con su propia aplicabilidad, y relacione la nueva con la antigua mediante supersedes (la inversa es superseded by). Una cadena como rev C supersedes rev B supersedes rev A las convierte en revisiones de una misma posición. Holarch nunca elige entre revisiones: notifica dónde se superpone su aplicabilidad o deja unidades sin revisión.
- Banner: cuando dos revisiones están vigentes a la vez en el punto de la vista, el banner advierte: «Revisiones superpuestas: A-20 Cooling unit tiene 2 vigentes en SN 75 (A-20A, A-20B).»
- Comprobaciones del modelo: Revisiones vigentes a la vez (ProductLine.13) en cada una de las dos revisiones, con los números de serie y las fechas que comparten; Unidades sin revisión vigente (ProductLine.14) en el elemento que descomponen las revisiones (o la revisión más antigua), con las unidades entre la primera y la última revisión que no tienen ninguna, por ejemplo «SN 1–49 from 2027-07-01».
- Publicación y líneas base: una configuración no se puede definir como Publicada ni incluir en una línea base mientras dos de sus revisiones se superponen: CFG-1 no se puede publicar: A-20A y A-20B están vigentes a la vez para SN 50–99 desde 2027-06-01 hasta 2027-07-01. Cambie la aplicabilidad de una revisión y publique.
Las superposiciones y los huecos se comprueban dentro de cada configuración a la que se aplican ambas revisiones, dentro de la aplicabilidad propia de esa configuración.
Documentos, RVTM y verificación
Exportar un documento para una configuración
En un proyecto con al menos una configuración, una plantilla de Word en Entregar ▾ (como Especificación (Word)) y ⌘K / Ctrl+K Exportar documento a Word abren primero un breve diálogo Exportar a Word. Los proyectos sin configuraciones se exportan con un clic, como antes.
- Configuración: Todas las configuraciones, o una configuración («CFG-2 EO-1 Lite»). Las configuraciones retiradas se enumeran al final, marcadas con «(Retirada)». La elección empieza con la configuración que ve su pestaña.
- Aplicabilidad: Cualquier unidad, Número de serie (como 23; «SN 23» también funciona) o Fecha. Empieza con el punto de la vista.
- Mostrar ámbito de aplicación (solo en Todas las configuraciones, activado de forma predeterminada): añade «Se aplica a: CFG-1, CFG-3» bajo cada sección que solo tienen algunas configuraciones. Las configuraciones retiradas no se cuentan.
Todas las exportaciones… → Documento (Word) tiene las mismas opciones en su grupo Línea de productos (no para una exportación de línea base).
El documento de una configuración contiene:
- Solo las secciones que se aplican a la configuración y están vigentes en la unidad o la fecha elegidas, con los valores propios de la configuración.
- Una sección bajo una sección omitida sube a la sección conservada más cercana.
- Números de vista: un elemento después de un hermano omitido se renumera con el mismo estilo (4 pasa a ser 3, y 4.1 pasa a ser 3.1). Los números almacenados no cambian. El archivo indica «Numeración como se muestra en CFG-2.» bajo el título.
- En la portada y en el pie de página: «Configuración CFG-2 EO-1 Lite · Número de serie 23» (o «· Aplicable desde 2027-03-01»). Una plantilla de Word de empresa puede colocarlo con el campo
{{Configuration}}. - El nombre del archivo nombra la configuración: «SRS – CFG-2 EO-1 Lite.docx».
- Sin una unidad ni una fecha, una sección con aplicabilidad muestra su etiqueta bajo el título, como «Vigente desde SN 21».
Imprimir o guardar un PDF en una vista de configuración también coloca la configuración y el punto en el pie de página impreso.
El esquema del documento
- En una vista de configuración, el esquema muestra números de vista. Renumerar… y Renumerar desde aquí… están desactivados: «Los números son comunes a todas las configuraciones. Renumere en Todas las configuraciones.» La renumeración automática tras añadir y mover está desactivada en una vista.
- Ver ▾ → Columnas ofrece las columnas Aplica a y Aplicabilidad en cuanto el proyecto las usa.
- La exportación ReqIF de un documento escribe Aplica a y la aplicabilidad como atributos de cadena. El diálogo indica «Aplica a y la aplicabilidad se exportan como atributos de cadena. Los valores de configuración no se exportan.»
RVTM
- En una vista de configuración: los requisitos y resultados de la configuración, de modo que «verificado» significa verificado para ese producto. La columna # muestra números de vista. Exportar ▾ nombra la configuración en el nombre del archivo («RVTM – CFG-2 EO-1 Lite.csv») y en el título de Word.
- En Todas las configuraciones: un grupo de columnas Configuración con un estado acumulado por cada configuración no retirada. «—» significa que el requisito no forma parte de esa configuración (información sobre herramientas «No se aplica a CFG-1»). Las exportaciones CSV y Excel añaden una columna «Status in CFG-1» por configuración («Does not apply» cuando no forma parte de ella).
- Columna de aplicabilidad: un interruptor, oculto de forma predeterminada, que se conserva por pestaña.
- Solo cuentan los resultados propios de una configuración. Un resultado registrado sin configuración (antes de que existiera la configuración, o en Todas las configuraciones) no verifica ninguna configuración. En una configuración, el caso de prueba se muestra como no ejecutado, y el estado del requisito indica «Un resultado sin configuración (TC-1) no cuenta para CFG-2.» La misma nota aparece en la información sobre herramientas de la columna de la configuración, en las exportaciones y en los documentos generados para una configuración. Para verificar la configuración, vuelva a ejecutar la prueba mientras la ve.
- En un número de serie: el estado procede de la última ejecución registrada para ese número de serie (Test Article «23», «SN 23» o «SN-0023») en la configuración vista, con la nota «Primero los resultados registrados para SN 23». Los casos de prueba sin esa ejecución conservan su estado. Las exportaciones usan los mismos estados.
Centro de pruebas
- Ejecutar suite en una vista de configuración indica «Registrando resultados para CFG-2.» y rellena Configuración / compilación con «CFG-2 EO-1 Lite». En un número de serie también rellena Artículo de prueba. Los resultados se guardan como valores de esa configuración, de modo que un caso de prueba contiene un resultado por configuración.
- Importar resultados… en una vista muestra la misma nota y rellena los mismos campos.
- En Todas las configuraciones, Ejecutar suite e Importar resultados… preguntan Registrar resultados para: elija la configuración en la que se ejecutó la prueba, o Sin configuración (no verifica ninguna). Al principio no hay nada elegido, y no se registra ningún resultado hasta que elija. Los resultados para una configuración se guardan como sus valores, como en una vista de ella; un caso de prueba que no está en la configuración elegida no se registra e indica el motivo. Los resultados sin configuración se guardan como valores del caso de prueba para Todas las configuraciones; una vista de configuración los muestra como una nota bajo el estado del caso de prueba, no como su resultado.
- Un archivo de resultados puede tener una columna Configuration. El valor de una fila (el número, el nombre de una configuración o ambos) registra esa fila para esa configuración; un valor que no nombra ninguna configuración omite la fila y la enumera en el diálogo.
- Reutilizar resultado… (bajo el estado de un caso de prueba): cuenta un resultado de otra configuración para una configuración en la que no se ejecutó la prueba, cuando puede justificarlo, por ejemplo porque se probó el mismo diseño de unidad. Elija el resultado que reutilizar (el resultado de una configuración o un resultado sin configuración), la configuración para la que es (en una vista de configuración, la vista; en Todas las configuraciones, cualquier configuración en la que esté el caso de prueba y que no tenga resultado propio) e introduzca una Justificación (obligatoria). El resultado se copia en esa configuración con su nombre, la fecha y la justificación, y un solo Deshacer lo revierte todo (aviso «Se reutilizó el resultado de CFG-1 para CFG-2.», con Deshacer).
- Un resultado reutilizado nunca pasa inadvertido. En la configuración muestra Reutilizado con «de CFG-1 por Ann Lee el 2026-10-28: same motor and cooler» bajo el estado del caso de prueba; la RVTM de la configuración indica «Resultado reutilizado de CFG-1 (TC-1): …» bajo el estado del requisito; en Todas las configuraciones, la columna de la configuración indica «reutilizado» (la justificación es su información sobre herramientas); las exportaciones y los documentos generados para la configuración añaden la misma nota; Comprobaciones del modelo lo enumera como ProductLine.17. Dejar de reutilizar lo revierte (la prueba vuelve a mostrar Not Run), y ejecutar la prueba en la configuración lo sustituye por el resultado propio de la configuración.
- El atributo Configuration de un caso de prueba sugiere las configuraciones del proyecto mientras se edita (inspector, vista del elemento, Ejecutar suite, Importar resultados). Sigue siendo texto libre: una compilación como «Build 2.4.1» sigue funcionando.
Diagramas y estudios de alternativas
- Mostrar ámbito de aplicación (barra de herramientas del diagrama, proyectos LML, en Todas las configuraciones): tiñe las formas de los elementos con Aplica a o aplicabilidad y escribe su ámbito de aplicación debajo, como «Se aplica a F-4 · Vigente desde SN 30». El ajuste se conserva por pestaña y no se ofrece dentro de una vista de configuración.
- Estudios de alternativas → + Desde configuraciones… (en Alternativas) añade las configuraciones de la línea de productos como alternativas, y un solo Deshacer lo revierte todo. Las configuraciones retiradas empiezan sin marcar. Aviso: «Se añadieron 2 alternativas.»
Líneas base y solicitudes de cambio
Forman parte del plan Team. Sin él, los comandos están desactivados con «Las líneas base por configuración forman parte del plan Team. Decide el plan del propietario del proyecto.»
Líneas base por configuración
- Abra Control y revisiones → Líneas base y versiones.
- Haga clic en Crear línea base de una configuración…. Mientras ve una configuración, el botón indica Línea base CFG-2… y omite la elección.
- Elija la Configuración e introduzca un Nombre (empieza como «CFG-2 baseline 1»). Haga clic en Guardar línea base. El aviso indica «Línea base de CFG-2 guardada.» La columna Documento de la tabla indica, por ejemplo, «Configuración CFG-2 EO-1 Lite».
La línea base registra toda la línea de productos, etiquetada con la configuración, y el punto de aplicabilidad cuando ve en uno. Puede compararla y restaurarla como cualquier línea base. Todavía no: un registro de definición publicada del veredicto, las elecciones y las aprobaciones de la configuración.
Cada línea base registra también lo que el proyecto usaba de otros proyectos: la publicación de cada biblioteca en uso, y cada vínculo a un elemento de otro proyecto con el último cambio de ese elemento en ese momento. Cuando las Features proceden de una biblioteca mostrada, Comparar → Configuración ▾ resuelve una línea base con la publicación de la biblioteca que registró, no con la publicación en uso ahora, de modo que un elemento que salió de la configuración con una publicación más reciente se muestra como cambio. Una línea base guardada antes de que las líneas base registraran publicaciones de bibliotecas se resuelve con las publicaciones en uso ahora, y la página lo indica. Restaurar una línea base no cambia qué publicaciones de bibliotecas usa el proyecto.
Comparar tiene dos opciones para las líneas de productos:
- Configuración ▾: compara lo que muestra una configuración. Elige las dos líneas base más recientes de la configuración, o su línea base más reciente y el modelo actual.
- Comparar con ▾: compara dos configuraciones dentro de la versión From, como «Qué difiere entre CFG-2 y CFG-1 en EO-1 Flight PDR».
Una línea base de proyecto creada en una vista de configuración sigue registrando toda la línea de productos.
Solicitudes de cambio
- La página de una solicitud de cambio tiene una tarjeta Configuraciones: «Cambia elementos en 2 de 4 configuraciones: CFG-2, CFG-3», con Mostrar por configuración (los elementos modificados por configuración). Un cambio en un valor base no cuenta para las configuraciones que tienen su propio valor.
- Las diferencias nombran los valores de configuración «Mass (CFG-2)», «Description (CFG-2)» e «In CFG-2», y enumeran los cambios de «Applies To» y «Effectivity».
- Propietarios como aprobadores: cuando el Owner de una configuración modificada nombra a un miembro del proyecto, la solicitud también necesita la aprobación de esa persona. La línea de la regla indica «El propietario de CFG-2 (Lee) debe aprobar: esta solicitud cambia CFG-2.», y los lectores de pantalla anuncian «Se necesita la aprobación de Lee para CFG-2». Un propietario que no nombra a ningún miembro del proyecto no añade ninguna regla.
- Control de configuración: con el control de cambios activado, una configuración Publicada que está en la línea base más reciente queda controlada. Sus valores propios en los elementos solo cambian mediante una solicitud de cambio («… publicada, en la línea base más reciente»).
- Ámbito de aplicación de los elementos controlados: el Aplica a y la Aplicabilidad de un elemento aprobado o incluido en una línea base, así como incluirlo en una configuración o sacarlo de ella en una vista de configuración, solo cambian mediante una solicitud de cambio, como sus demás campos. Lo mismo ocurre con una relación cuyo origen está controlado. En el servicio alojado, el servidor también comprueba los cambios hechos sin conexión.
- Bibliotecas: las características y configuraciones de una publicación de biblioteca montada cuentan en Aplica a, en las configuraciones y en las vistas. Son de solo lectura.
Comprobaciones del modelo
Verificación → Comprobaciones del modelo ejecuta el conjunto de reglas integrado Línea de productos en cuanto un proyecto tiene una Feature o una Configuration.
| Regla | Heading | Gravedad |
|---|---|---|
| ProductLine.1 | Aplica a nombra una característica o una configuración que no existe | Error |
| ProductLine.2 | Elementos que no están en ninguna configuración | Advertencia |
| ProductLine.3 | Configuraciones que incumplen una regla o están incompletas | Error |
| ProductLine.4 | Características que ninguna configuración selecciona | Advertencia |
| ProductLine.5 | Elementos en una configuración en la que no está su padre | Advertencia |
| ProductLine.6 | Relaciones cuyos extremos nunca están en una misma configuración | Advertencia |
| ProductLine.7 | Configuraciones con números de serie superpuestos | Advertencia |
| ProductLine.8 | Aplicabilidad fuera de las configuraciones del elemento | Advertencia |
| ProductLine.9 | Valores para configuraciones en las que no está el elemento | Advertencia |
| ProductLine.10 | Requisitos no verificados en una configuración | Advertencia |
| ProductLine.11 | Conexiones con un extremo ausente en una configuración | Advertencia |
| ProductLine.13 | Revisiones vigentes a la vez | Advertencia |
| ProductLine.14 | Unidades sin revisión vigente | Advertencia |
| ProductLine.15 | Resultados de prueba sin configuración | Advertencia |
| ProductLine.16 | Configuraciones publicadas con requisitos no verificados en ellas | Error |
| ProductLine.17 | Resultados de prueba reutilizados de otra configuración | Advertencia |
Las reglas de completitud comprueban cada configuración desde Todas las configuraciones, sin cambiar de vista. ProductLine.10 nombra las configuraciones en las que un requisito no está verificado, como «Not verified in CFG-2, CFG-3 (Released)». ProductLine.11 nombra las configuraciones y el extremo ausente, como «In CFG-2: A-11 Coolant pump is not in the configuration». ProductLine.3 indica «Released configuration.» para una configuración publicada, y «It cannot be Released until this is fixed.» para un borrador. ProductLine.16 enumera los requisitos que una configuración Publicada no verifica.
ProductLine.13 y 14 comprueban las revisiones vinculadas mediante supersedes (consulte Revisiones de un elemento): «Overlaps A-20B for SN 50–99 from 2027-06-01 until 2027-07-01» en cada una de dos revisiones superpuestas, y «No revision in effect for SN 1–49 from 2027-07-01» en el elemento que descomponen.
ProductLine.15 enumera los casos de prueba cuyo Status se registró sin configuración, con las configuraciones para las que no cuenta, como «Passed without a configuration; does not count for CFG-2». Vuelva a ejecutar la prueba mientras ve cada configuración.
ProductLine.17 enumera los casos de prueba cuyo resultado cuenta para una configuración mediante Reutilizar resultado…, con la justificación, como «CFG-2: Reused from CFG-1 by Ann Lee on 2026-10-28: same motor and cooler». Revise la justificación, o ejecute la prueba mientras ve la configuración para sustituir el resultado reutilizado.
Para ProductLine.9, Corregir → Quitar valores enumera los valores, como «Mass (CFG-2): 1,520», y los quita, y un solo Deshacer lo revierte todo.
En la demo CubeSat EO-1, la característica Propulsion se deja sin seleccionar a propósito: es el ejemplo de ProductLine.4.
Búsqueda, importación y exportación
- Búsqueda y consultas:
appliesto:CFG-2encuentra los elementos que se aplican a CFG-2;varies:yesencuentra los elementos con valores de configuración. - JSON: conserva todos los campos.
- CSV: la exportación de la base de datos añade cuatro columnas después de las demás, Applies To (tal como se escribiría), Aplicabilidad por número de serie, Aplicable desde y Aplicable hasta, en cuanto el proyecto usa líneas de productos. La importación lee los mismos títulos de columna (paso de asignación: el grupo Línea de productos). Una característica o configuración desconocida, un intervalo de serie incorrecto o una fecha incorrecta se notifican para esa fila, y ese campo se omite.
- ReqIF: Aplica a y la aplicabilidad como atributos de cadena; los valores de configuración no se exportan.
- Los valores de Aplica a o de aplicabilidad no válidos de un archivo importado se omiten.
API REST y MCP
list_configurations(MCP) yGET …/configurations(REST) enumeran las características, las reglas y las configuraciones con sus veredictos.- Las rutas de lectura y las herramientas de lectura de MCP admiten
configuration(número, nombre o id) yeffectivity(sn:23odate:2027-03-01). La respuesta es la vista de esa configuración. Sin ellos, los elementos llevanappliesTo,effectivityy susvaluesde configuración. - Todavía no: las reglas de Línea de productos (ProductLine.1–9) en Comprobaciones del modelo a través de la API (
run_model_checks,GET …/model-checks). Ejecútelas en Verificación → Comprobaciones del modelo. - Las escrituras admiten
appliesToyeffectivity. Conconfiguration, una escritura se realiza como en la vista de esa configuración; la propuesta de un cliente de IA hecha de este modo indica «Aplicar en CFG-2: los elementos nuevos se aplican a CFG-2; los valores modificados pasan a ser de CFG-2.»
Consulte API REST: líneas de productos para conocer todos los campos y mensajes.
Planes
| Función | Free | Individual | Team |
|---|---|---|---|
| Leer un proyecto como una configuración a través de la API | ✓ | ✓ | ✓ |
| Página Línea de productos, Ver como ▾, Aplica a, valores de configuración y aplicabilidad, de solo lectura | ✓ | ✓ | ✓ |
| Edición de la línea de productos: características, configuraciones, selecciones, Aplica a, valores de configuración, aplicabilidad, documentos y RVTM por configuración, escrituras a través de la API | — | ✓ | ✓ |
| Líneas base por configuración, Comparar por configuración, las configuraciones que cambia una solicitud de cambio, propietarios de configuraciones | — | — | ✓ |
Decide el plan del propietario del proyecto. Una dirección de correo electrónico académica o una organización de clase conserva todas las filas.
Sin el plan, la línea de productos es de solo lectura y no se elimina nada:
- La página Línea de productos muestra las características, las configuraciones, la matriz y los veredictos. Comprobar configuraciones, Exportar CSV y Ver como esta configuración de una columna funcionan. + Nueva característica, + Nueva configuración, la matriz y los comandos de fila y columna que modifican algo están desactivados. La página indica «Solo lectura: la edición de líneas de productos forma parte de los planes Individual y Team. Decide el plan del propietario del proyecto.» con Elegir plan….
- Ver como ▾ muestra una configuración en modo de solo lectura. El banner muestra la misma línea.
- El inspector muestra Aplica a, la aplicabilidad y los valores de configuración en modo de solo lectura. Los elementos Feature y Configuration son de solo lectura.
- ⌘K / Ctrl+K Nueva característica…, Nueva configuración… e Iniciar una línea de productos… siguen en la lista e indican por qué no se ejecutan.
- Las exportaciones conservan todos los campos. Un nuevo uso se rechaza con «Las líneas de productos forman parte de los planes Individual y Team. Decide el plan del propietario del proyecto.» Un propietario de configuración sin el plan Team: «Los propietarios de configuraciones forman parte del plan Team. Decide el plan del propietario del proyecto.»
Proyectos SysML v2
SysML v2 tiene la variabilidad integrada en el lenguaje: puntos de variación, variantes y configuraciones (usos de @HolarchConfiguration). Un proyecto SysML v2 usa la misma página Línea de productos y el mismo control Ver como ▾:
- Página Línea de productos: el árbol de puntos de variación, la matriz de configuraciones con una fila Veredicto, las Reglas (las restricciones assert de la línea de productos, de solo lectura, con Abrir en el Editor), Insertar punto de variación… (abre el Editor), Comprobar configuraciones y + Nueva configuración. Elegir una variante escribe, por ejemplo,
part :>> charger = charger::wallbox;en la configuración. - Ver como ▾: enumera las configuraciones de cada línea de productos con sus veredictos. Todas las vistas, la base de datos, el inspector y la página Línea de productos lo siguen.
- En Free, la página Línea de productos es de solo lectura como en un proyecto LML: Insertar punto de variación…, + Nueva configuración y las opciones de la matriz están desactivados, y Nueva configuración… en el Explorador, el inspector y ⌘K / Ctrl+K indican el motivo. El texto del modelo sigue siendo editable en el Editor.
- Editar en una vista de configuración (Individual y Team; de solo lectura en Free): cada edición es una edición de texto SysML v2 comprobada por el verificador, y un solo Deshacer lo revierte todo. Un atributo modificado pasa a ser el valor propio de la configuración; las partes nuevas pertenecen a la configuración; eliminar un elemento opcional heredado escribe
part :>> roofBox[0];. - Los datos de Holarch junto al modelo, como riesgos y tareas, se aplican a todas las configuraciones, excepto los elementos creados mientras se muestra una configuración: se aplican a esa configuración. La edición de Aplica a en ellos todavía no está disponible en proyectos SysML v2. La aplicabilidad se define en los elementos del modelo y en las configuraciones (la sección Aplicabilidad del inspector).
- Todavía no: Crear una copia SysML v2… de un proyecto LML omite sus características y configuraciones (el informe las enumera en No convertido). Vuelva a modelar las variantes en la copia.
Consulte Variantes y configuraciones en SysML v2.
Límites
- Aplica a: como máximo 2.000 caracteres, 200 términos y 32 niveles de paréntesis.
- Números de serie: como máximo 200 intervalos, números de hasta 1.000.000.000.000.
- Nombre, Número, Clase, Etiquetas, Responsable y la estructura no pueden diferir según la configuración.
- Cada estructura (padres y orden) es común a todas las configuraciones. Todavía no: una estructura por configuración.
- Las exportaciones ReqIF omiten los valores de configuración.
- Todavía no: un prefijo de serie del proyecto, y Aplica a en las relaciones desde el panel de relaciones.
- Todavía no: una aplicabilidad que distinga fechas de aprobación, de entrada en vigor, de fabricación real y de modernización. La aplicabilidad es una lista de intervalos de números de serie y un intervalo de fechas de fabricación.
- Todavía no: una línea base de configuración como definición publicada. Registra la línea de productos etiquetada con la configuración, no el veredicto, las elecciones y las aprobaciones de la configuración como un registro aparte.
- Todavía no: convertir características y configuraciones al crear una copia SysML v2 de un proyecto LML.
- Las expresiones no contienen números de serie ni fechas; use la aplicabilidad para ello.