SysML v2
Variantes y configuraciones de SysML v2
Modele una línea de productos en un proyecto SysML v2: puntos de variación, variantes, reglas y configuraciones en el Explorador y el inspector, Nueva configuración…, vistas mostradas como una sola configuración y estudios de alternativas de configuraciones.
En esta página
- Resumen
- Conceptos
- Cómo usarlo
- Cuándo y por qué
- Marcar un punto de variación
- Añadir una regla
- Crear una configuración
- Cambiar las elecciones de una configuración
- Mostrar el modelo como una configuración
- Comparar configuraciones en un estudio de alternativas
- Ejemplo práctico: la demostración Hybrid Car
- Consejos y buenas prácticas
- Errores habituales
- Cómo se relaciona con otras funciones
- Navegador
- Inspector
- Ver como configuración
- Mensajes
- Límites
- Páginas relacionadas
Resumen
Una línea de productos es un diseño con unos pocos puntos en los que sus productos difieren, como el tamaño de la batería o si se monta un cargador. La línea se modela una vez y después se puede examinar, comprobar y comparar cualquier producto sin copiar el modelo.
SysML v2 lo incorpora en el propio lenguaje. Holarch lo muestra en toda la aplicación:
- El Navegador marca las líneas de productos, los puntos de variación, las variantes y las configuraciones, y enumera las configuraciones de cada línea de productos.
- El inspector muestra los puntos, las reglas y las configuraciones de una línea de productos con un veredicto para cada uno, y permite cambiar las elecciones de una configuración.
- Nueva configuración… crea una configuración desde un cuadro de diálogo que comprueba las reglas a medida que elige.
- Ver como ▾ en la barra superior muestra las vistas, la base de datos, el inspector y la página Línea de productos como una configuración.
- Los Estudios de alternativas pueden comparar las configuraciones de una línea de productos o las variantes de un punto.
La variabilidad en el texto está disponible en todos los planes. En el plan Free, la página Línea de productos, Nueva configuración… y el cambio de las elecciones de una configuración en el inspector son de solo lectura; editarlos forma parte de los planes Individual y Team. Consulte Líneas de productos: planes.
Conceptos
Puntos de variación y variantes
Un punto de variación es un lugar del diseño donde los productos difieren. Sus variantes son las elecciones permitidas.
- Un uso de variación es un punto dentro de un diseño:
variation part charger : Component { variant part noCharger; variant part wallbox; }. - Una definición de variación es un conjunto reutilizable de elecciones:
variation part def BatteryPack { variant part standardPack; variant part largePack; }. Un uso tipado por ella, comopart pack : BatteryPack;, también es un punto.
Líneas de productos
Una línea de productos es una definición o un uso que posee o hereda puntos de variación. En la demostración Hybrid Car, CarLine es la línea de productos: especializa Car y añade los puntos pack y charger. Una definición que especializa una línea de productos también es una línea de productos.
Reglas
Una regla es un assert constraint de la línea de productos. Excluye combinaciones de variantes. En la demostración, wallboxNeedsLargePack indica que el cargador wallbox necesita el pack grande:
assert constraint wallboxNeedsLargePack { charger == charger::wallbox implies pack == BatteryPack::largePack }
Mientras un punto no tenga elección, una regla sobre él no se cumple ni se incumple: su veredicto es desconocido.
Configuraciones
Una configuración es un producto de la línea. Es un uso tipado por la línea de productos que vincula una variante a cada punto. Holarch la marca con @HolarchConfiguration (paquete HolarchVariability), de modo que el Editor señala cada punto que aún no ha elegido:
part plugInHybrid : CarLine {
@HolarchConfiguration;
part :>> pack = BatteryPack::largePack;
part :>> charger = charger::wallbox;
}
Cada configuración tiene un veredicto:
| Veredicto | Significado |
|---|---|
| Válida | Se ha elegido una variante para cada punto y se cumplen todas las reglas. |
| Incumple la regla … | Se incumple una regla; el veredicto la nombra. |
| Incompleta | Un punto aún no tiene ninguna variante elegida; el veredicto lo nombra. |
| Desconocido | No se pudo evaluar una regla, por ejemplo porque falta un valor que lee. |
Holarch también cuenta las combinaciones de variantes y cuántas de ellas permiten las reglas. Para una línea de productos muy grande, solo comprueba las primeras combinaciones e indica cuántas ha comprobado.
Cómo usarlo
Cuándo y por qué
Use la variabilidad cuando varios productos comparten la mayor parte de un mismo diseño: acabados de un vehículo, versiones de exportación, conjuntos de sensores, un producto con y sin una opción. Modele el diseño común una vez, marque los puntos donde difieren los productos y añada una configuración por producto. Así, cada producto se mantiene al día con cada cambio del diseño común.
Marcar un punto de variación
- Abra el Editor y el paquete que contiene el diseño.
- Dentro de la definición de la línea de productos, elija Insertar ▾ → Variación. Rellene el nombre y el tipo del punto.
- Dentro de la variación, elija Insertar ▾ → Variante una vez por cada elección.
- Para reutilizar un conjunto de elecciones, elija Insertar ▾ → Variación a nivel de paquete. Escribe una definición de variación; tipe una parte con ella.
El Navegador muestra ahora la línea de productos con el icono de cajas apiladas y el punto con un rombo.
Añadir una regla
- Dentro de la definición de la línea de productos, escriba un assert constraint sobre sus puntos, por ejemplo
assert constraint r { charger == charger::wallbox implies pack == BatteryPack::largePack }. - Seleccione la línea de productos en el Navegador.
Verá la regla en Reglas en la sección Línea de productos del inspector, y el número de combinaciones que excluye.
Crear una configuración
- En el Navegador, abra el menú de fila (⋯, clic derecho o Shift+F10) de la línea de productos o de su grupo Configuraciones.
- Elija Nueva configuración….
- Compruebe Configura: la línea de productos a la que pertenece la configuración.
- Introduzca un Nombre, como
longRangeHybrid. - En Elecciones de variante, elija una variante para cada punto de variación. El veredicto aparece de inmediato bajo las elecciones, por ejemplo Válida: cumple todas las reglas o Incumple la regla wallboxNeedsLargePack.
- Haga clic en Crear.
La configuración se escribe en el texto tras la última configuración de la línea de productos, marcada con @HolarchConfiguration, y un solo Deshacer lo revierte todo. El Navegador la selecciona en el grupo Configuraciones de la línea de productos.
También puede abrir el cuadro de diálogo con Nueva configuración… en la sección Línea de productos del inspector, o desde ⌘K / Ctrl+K.
Cambiar las elecciones de una configuración
- Seleccione la configuración en el Navegador (o en una vista).
- En la sección Configuración del inspector, elija otra variante en la lista de un punto.
La vinculación en el texto se reescribe (part :>> pack = BatteryPack::standardPack;) y el veredicto se actualiza; un solo Deshacer lo revierte todo. Elija No elegido para quitar la elección. Una elección que añadiría un error al modelo se rechaza con el motivo.
Mostrar el modelo como una configuración
- En la barra superior, haga clic en Ver como ▾ (muestra Todas las configuraciones ▾ hasta que elige una) y elija una configuración. Un aviso bajo la barra superior indica, por ejemplo, Viendo la configuración plugInHybrid. y cuántos elementos se aplican. En las vistas generales, de interconexión y de cuadrícula, se ocultan las variantes que no elige y las demás configuraciones, y cada punto de variación muestra su elección, como pack : BatteryPack = largePack. La base de datos, el inspector y la página Línea de productos siguen la misma elección.
- Para volver, elija Ver como ▾ → Todas las configuraciones o haga clic en Salir en el aviso.
En los planes Individual y Team puede editar mientras se muestra una configuración; cada edición es una edición de texto SysML v2, que se comprueba antes de aplicarse, y un solo Deshacer revierte cada una:
- Elegir una variante escribe la vinculación en la configuración (
part :>> pack = BatteryPack::largePack;). - Un valor de atributo cambiado pasa a ser el valor propio de la configuración; la definición conserva su valor.
- Las nuevas partes y acciones pertenecen a la configuración.
- Eliminar un elemento heredado que se puede omitir escribe
part :>> roofBox[0];en la configuración. Un elemento heredado obligatorio no se puede eliminar ahí; cámbielo en el Editor. - Un riesgo, una tarea u otro elemento de Holarch que cree se aplica a la configuración.
En el plan Free, la vista de configuración es de solo lectura. Desde el inspector de una configuración, Mostrar en vista ▾ abre una vista de su línea de productos mostrada como esa configuración.
Comparar configuraciones en un estudio de alternativas
- Abra Riesgos, incidencias y decisiones → Estudios de alternativas y un estudio (o haga clic en + Nuevo estudio de alternativas).
- En Alternativas, haga clic en + Desde línea de productos….
- En Desde, elija Configuraciones de … (una línea de productos) o Variantes de … (un punto de variación).
- Desmarque los elementos que no desee y haga clic en Añadir.
Cada configuración o variante se convierte en una alternativa, vinculada al elemento del modelo. Añada criterios y valores como en cualquier estudio de alternativas, o use Traer valores del modelo.
Ejemplo práctico: la demostración Hybrid Car
Cree la demostración con Archivos de proyecto ▾ → Nuevo proyecto de demostración → Hybrid Car (SysML v2) en Gestionar proyectos.
- Abra Modelo → Navegador y expanda Vehicles.
BatteryPackyCarLinellevan los iconos de línea de productos;CarLinetiene un grupo Configuraciones conlongRangeHybrid,plugInHybridyselfChargingHybrid. - Seleccione
CarLine. La sección Línea de productos enumera los puntospack(standardPack, largePack) ycharger(noCharger, wallbox), la reglawallboxNeedsLargePacky las tres configuraciones, todas Válida. Indica 4 combinaciones: 3 permitidas por las reglas y 1 excluida (el wallbox con el pack estándar). - Seleccione
selfChargingHybridy cambie charger a wallbox. El veredicto pasa a ser Incumple la regla wallboxNeedsLargePack. Pulse ⌘Z / Ctrl+Z para deshacer. - Abra la vista
carLineVariants(Diagramas). Elija Ver como ▾ → plugInHybrid. La cajaBatteryPackconserva sololargePack, y la cajaCarLinemuestra pack : BatteryPack = largePack y variation charger : Component = wallbox. - Abra Estudios de alternativas → Configuration Line-up (TR-2). Sus alternativas son las tres configuraciones, puntuadas por precio, autonomía eléctrica y comodidad de carga.
Consejos y buenas prácticas
- Mantenga el diseño común en la línea de productos y solo las diferencias en las variantes. Una variante redefine lo que cambia (
attribute :>> capacity = 12 [kW*h];). - Escriba las reglas en cuanto sepa que una combinación no está permitida. Así, los veredictos detectan de inmediato una configuración incorrecta.
- Ponga a las configuraciones el nombre del producto, no el de las elecciones (
plugInHybrid, nolargePackWallbox). - Use una vista por línea de productos y cámbiela entre configuraciones, en lugar de una vista por configuración.
Errores habituales
- Una configuración no aparece bajo su línea de productos. Debe estar tipada por la línea de productos (
part x : CarLine). Compruebe su Tipo en el inspector. - Un veredicto sigue siendo Desconocido. Una regla lee un valor que no tiene ninguno en esta configuración. Elija una variante para cada punto o dé un valor predeterminado al valor.
- Se rechaza una elección. La variante no es una de las variantes de ese punto. Elija de la lista del inspector o corrija el nombre en el texto.
Cómo se relaciona con otras funciones
- Editor: Insertar ▾ escribe Variación, Variante, Configuración y Elección de variante. Todo aquí es texto SysML v2 corriente, por lo que las importaciones, las exportaciones y otras herramientas de SysML v2 lo leen.
- Estudios de alternativas: configuraciones y variantes como alternativas.
- Diagramas de bloques de fiabilidad: las variantes de un punto de variación son alternativas, por lo que el diagrama solo cuenta la variante elegida por la configuración en Ver como ▾. Con todas las configuraciones mostradas, el punto es un bloque con sus propios valores, y el panel indica que se elija una configuración.
- Comprobaciones del modelo: Verificación → Comprobaciones del modelo informa de cada configuración que incumple una regla o deja un punto de variación sin variante (ProductLine.3, un error). La nota es el veredicto, como Incumple la regla wallboxNeedsLargePack, y las reglas incumplidas se enumeran como elementos relacionados. Corregir → Abrir elemento abre la configuración. La API y MCP informan del mismo hallazgo (
run_model_checks,GET …/model-checks). - Solicitudes de cambio e historial: cada cambio es un cambio corriente del modelo, y un solo Deshacer revierte cada uno.
Navegador
- Iconos: cajas apiladas para una línea de productos, un rombo para un punto de variación, un rombo relleno para una variante y controles deslizantes para una configuración. Cada icono tiene una información sobre herramientas.
- Grupo Configuraciones: el primer miembro de la fila de una línea de productos. Enumera las configuraciones de la línea de productos dondequiera que estén declaradas; cada fila representa la propia configuración. Su menú de fila tiene Nueva configuración….
- Menú de fila: Nueva configuración… en una línea de productos y en cada una de sus configuraciones.
- Lectores de pantalla: el nombre de una fila dice lo que es, por ejemplo CarLine, part def, línea de productos o plugInHybrid, part, configuración de CarLine.
Inspector
Línea de productos
- Puntos de variación: cada punto con las variantes entre las que elige.
- Reglas: los assert constraint de la línea de productos, o Sin reglas: se permite cualquier combinación de variantes.
- Configuraciones: una tabla de las configuraciones y sus veredictos.
- Combinaciones: cuántas combinaciones de variantes existen y cuántas permiten, excluyen o dejan como desconocidas las reglas.
- Nueva configuración…
Configuración
- Configura: la línea de productos.
- Estado: el veredicto, que se anuncia a los lectores de pantalla cuando cambia.
- Una lista por punto de variación: la variante elegida, o No elegido. Un solo Deshacer revierte un cambio.
- Reglas: cada regla como Cumplida, Incumplida o Desconocida.
- Mostrar en vista ▾: las vistas generales, de interconexión y de cuadrícula que muestran la línea de productos, abiertas como esta configuración.
Punto de variación y variante
- Un punto de variación enumera sus Variantes y, en Elegido por, lo que elige cada configuración.
- Una variante muestra de qué es Variante de y qué configuraciones la eligen.
Ver como configuración
- Dónde: la barra superior, en cuanto el modelo tiene una configuración. Una elección por pestaña del navegador: las vistas generales, de interconexión y de cuadrícula, la base de datos, el inspector y la página Línea de productos la siguen.
- Control: Ver como ▾ (muestra Todas las configuraciones ▾ hasta que elige una). El menú enumera Todas las configuraciones, las configuraciones de cada línea de productos con sus veredictos, Aplicabilidad ▸ (muestra el modelo en un número de serie, una fecha de fabricación o ambos: Número de serie y fecha… es una unidad con ese número de serie fabricada en esa fecha) y Gestionar línea de productos. El aviso bajo la barra superior tiene Cambiar ▾ y Salir.
- Qué cambia: se ocultan las variantes que la configuración no elige y las demás configuraciones de la misma línea de productos, con lo que poseen. Los puntos de variación muestran su elección. Las disposiciones no se reorganizan y son comunes a todas las configuraciones.
- Edición: planes Individual y Team. Las ediciones siguen las reglas de Mostrar el modelo como una configuración. En el plan Free, y para quienes tienen acceso de lectura, la vista es de solo lectura y el aviso indica por qué.
- Cuadrícula: la tabla omite los elementos ocultos y nombra las elecciones encima de la tabla. La matriz muestra toda la línea de productos.
- Por pestaña: la elección se conserva para la pestaña del navegador hasta que la cambia. Las imágenes de la vista en la lista Diagramas muestran toda la línea de productos.
- Lectores de pantalla: al cambiar se anuncia la configuración y cuántos elementos se aplican, por ejemplo Viendo la configuración plugInHybrid. Se aplican … elementos., con Solo lectura. añadido cuando no puede editar.
Mensajes
| Mensaje | Qué hacer |
|---|---|
| El modelo aún no tiene puntos de variación. Añada una variación en el Editor (Insertar ▾ → Variación) e inténtelo de nuevo. | Marque primero un punto de variación. |
| El modelo aún no tiene configuraciones ni variantes. … (+ Desde línea de productos…) | Añada primero un punto de variación o una configuración. |
| Introduzca un nombre para la configuración. | Escriba un nombre en Nombre. |
| … ya se usa en …. Elija otro nombre. | Otro elemento del mismo paquete tiene ese nombre. |
| Los nombres tienen de 1 a 1.000 caracteres y no contienen saltos de línea. Cambie el nombre. | Acorte el nombre o quite el salto de línea. |
| Una elección o una configuración rechazada | Añadiría un error al modelo; el mensaje nombra el error. Corrija el texto o elija otra variante. |
| El comprobador de SysML no está disponible, por lo que no se pueden leer los puntos de variación. | Recargue la página o cree la configuración en el Editor con Insertar ▾ → Configuración. |
Límites
- Para una línea de productos muy grande, el recuento de combinaciones solo comprueba las primeras combinaciones; las configuraciones siempre se comprueban por completo.
- En el plan Free, una vista mostrada como una configuración es de solo lectura.
- Aún no: publicar o retirar una configuración de SysML v2. Todas las configuraciones de SysML v2 están en Borrador, por lo que el control de configuración no bloquea ninguna.
- La variabilidad abarca el modelo SysML v2. Los elementos de Holarch que lo acompañan (riesgos, pruebas, tareas, secciones de documentos) se aplican a todas las configuraciones, salvo los creados mientras se muestra una configuración: se aplican a esa configuración. Su campo Se aplica a aún no se puede editar en un proyecto SysML v2.
Páginas relacionadas
- Notación textual de SysML v2: variaciones, variantes y configuraciones
- Vistas de SysML v2
- Análisis de SysML v2: estudios de alternativas
SysML® y OMG® son marcas registradas de Object Management Group, Inc. en los Estados Unidos y otros países.