Guía · SysML v2
SysML v1 frente a v2: en qué se diferencian los dos lenguajes
Escuchar esta guía (audio en inglés) 20 min
SysML v1 y SysML v2 comparten un propósito y muchos nombres, pero SysML v2 es un lenguaje nuevo y no una revisión. Esta guía compara ambos uno junto al otro: la base, las definiciones y los usos, la notación textual, las unidades, los puertos, el comportamiento, los requisitos, las vistas, la API y lo que implica una migración de v1 a v2.
En esta página
- De un vistazo
- Base: un perfil de UML frente a KerML
- Definiciones y usos en lugar de bloques y propiedades
- Una notación textual estándar
- Biblioteca estándar, magnitudes y unidades
- Puertos, interfaces y conexiones
- Comportamiento: acciones y estados
- Requisitos y casos de verificación
- Vistas en lugar de diagramas dibujados
- La Systems Modeling API y el intercambio en JSON
- Migrar un modelo de SysML v1 a v2
- Cómo se comprobaron los listados
- Pruébelo en Holarch
- Siguientes pasos
De un vistazo
Quien conozca SysML v1 reconocerá la mayoría de los conceptos en SysML v2. Lo que cambió es cómo se construyen y con qué precisión se definen. La tabla resume la comparación; cada fila tiene su propia sección más abajo.
| Aspecto | SysML v1 | SysML v2 |
|---|---|---|
| Base | Un perfil de UML 2: estereotipos sobre un subconjunto de metaclases de UML | Su propio metamodelo sobre el Kernel Modeling Language (KerML), con una semántica definida en una biblioteca formal |
| Estructura | Bloques con propiedades de parte, de referencia y de valor | Definiciones y usos para cada tipo de elemento: part def y part, port def y port, etc. |
| Notación | Gráfica (nueve tipos de diagrama); sin texto estándar para el modelo completo | Una notación textual estándar y una notación gráfica estándar para el mismo modelo |
| Magnitudes y unidades | Tipos de valor con unidades, mediante un modelo de unidades y bibliotecas de modelos | Magnitudes ISQ y unidades SI en la biblioteca estándar, usadas directamente en valores como 6.5 [kg] |
| Interfaces | Puertos completos y proxy, bloques de interfaz, propiedades de flujo, flujos de ítems en los conectores | Definiciones de puerto con características con dirección, conjugación ~, definiciones de interfaz con extremos tipados, flujos y enlaces (binding) |
| Comportamiento | Actividades, máquinas de estados e interacciones de UML, vinculadas a la estructura mediante asignación | Acciones, estados y mensajes como ocurrencias, vinculados a la estructura mediante perform y exhibit |
| Requisitos | Una clase estereotipada con un id. y un texto; las restricciones residen aparte, en bloques de restricción | Un requisito es una restricción con un sujeto; texto y condición comprobable en un solo elemento |
| Verificación | Casos de prueba vinculados mediante verify | Casos de verificación con un objetivo y un veredicto |
| Diagramas | Dibujos que guarda la herramienta; las disposiciones rara vez pasan de una herramienta a otra | Las vistas son elementos del modelo que indican lo que muestran; la herramienta las representa |
| Intercambio | Archivos XMI, con diferencias entre herramientas | Archivos de texto, JSON y la Systems Modeling API estándar |
Base: un perfil de UML frente a KerML
SysML v1 se define como un perfil de UML 2. Toma un subconjunto de UML y añade estereotipos: un bloque es una clase UML con el estereotipo «block», un requisito es una clase con «requirement», una propiedad de flujo es una propiedad con «flowProperty». Esto hizo que SysML v1 se adoptara rápido, porque las herramientas UML podían alojarlo, pero también significó que los conceptos de sistemas se forzaban para encajar en conceptos de software, y que el significado de muchas construcciones venía de la semántica de UML, que se escribió para el software.
SysML v2 abandona la base de UML. Se construye sobre el Kernel Modeling Language (KerML), un lenguaje más pequeño cuyo núcleo recibe un significado preciso en una biblioteca de modelos KerML. SysML v2 añade encima los conceptos de ingeniería de sistemas: partes, puertos, acciones, estados, requisitos, casos y vistas. Cada construcción de SysML v2 se define como especialización de algo de esa biblioteca. En la práctica, esto significa:
- La estructura y el comportamiento comparten una base. Las partes y las acciones son ambas ocurrencias que existen en el tiempo, así que una parte puede realizar una acción o exhibir un estado sin una capa de asignación aparte.
- Las herramientas coinciden más en lo que significa un modelo, porque el significado está en la especificación y sus bibliotecas y no en la interpretación de cada herramienta.
- Los estereotipos dejan de ser el mecanismo de extensión. SysML v2 usa definiciones de metadatos para las anotaciones propias de una herramienta o de un dominio.
Definiciones y usos en lugar de bloques y propiedades
En SysML v1 el bloque es el elemento central: un diagrama de definición de bloques define bloques, y un diagrama de bloques internos muestra las partes de un bloque. Una propiedad de parte se tipa con un bloque; una propiedad de valor se tipa con un tipo de valor. Dar a una parte un valor distinto del valor por defecto de su bloque, por ejemplo una bomba más pesada en una variante del producto, requiere una solución provisional: un bloque especializado que redefine la propiedad, un tipo específico de propiedad o una especificación de instancia.
SysML v2 generaliza esto en un único patrón para todos los elementos: una definición dice qué es un tipo de cosa, un uso es una de esas cosas en un contexto. Los usos se anidan, y un uso anidado puede redefinir lo que hereda con su propio valor. El mismo patrón vale para atributos, puertos, acciones, estados, requisitos y vistas.
package CoolingLoop {
doc /* The engine cooling loop of a small generator set. */
private import ScalarValues::*;
private import ISQ::*;
private import SI::*;
part def Pump {
attribute mass : MassValue;
attribute shaftPower : PowerValue;
}
part def ElectricPump :> Pump {
attribute supplyVoltage : ElectricPotentialValue;
}
part def Radiator {
attribute mass : MassValue;
attribute heatRejection : PowerValue;
}
part def CoolingSystem {
part pump : ElectricPump {
attribute redefines mass = 2.4 [kg];
attribute redefines shaftPower = 150 [W];
attribute redefines supplyVoltage = 24 [V];
}
part radiator : Radiator {
:>> mass = 6.5 [kg];
:>> heatRejection = 18 [kW];
}
attribute totalMass : MassValue = pump.mass + radiator.mass;
}
}
| SysML v1 | SysML v2 en este listado |
|---|---|
Bloque Pump con propiedades de valor | part def Pump con atributos |
Generalización de ElectricPump a Pump | Especialización part def ElectricPump :> Pump |
Propiedad de parte pump de CoolingSystem, tipada por el bloque | Uso de parte part pump : ElectricPump |
| Un valor específico del contexto mediante un bloque especializado o una instancia | attribute redefines mass = 2.4 [kg] directamente en el uso |
| Un valor derivado con un bloque de restricción y un diagrama paramétrico | totalMass como expresión en el atributo |
:>> es la forma abreviada de redefines. Las propiedades de referencia de v1, que apuntan a una parte que pertenece a otro elemento, pasan a ser usos ref en v2.
Una notación textual estándar
SysML v1 no tiene una forma de texto estándar para un modelo completo. El modelo reside en el repositorio de la herramienta, la gente trabaja en diagramas y los archivos pasan de una herramienta a otra como XMI, que está pensado para máquinas, no para leerse. El texto solo aparece en algunos puntos: expresiones de restricción, comportamientos opacos y lenguajes de acciones en algunas herramientas.
SysML v2 tiene una notación textual que cubre todo el lenguaje, junto a una notación gráfica. Ambas muestran el mismo modelo. Todos los listados de esta página están en esa notación textual; el tutorial de SysML v2 construye en ella un modelo completo paso a paso. El texto cambia la forma en que puede trabajar un equipo:
- Un modelo puede revisarse línea a línea, compararse con un diff y mantenerse bajo control de versiones junto con el resto de los datos de ingeniería.
- Los ingenieros pueden escribir un modelo rápidamente, copiar patrones entre modelos y generar partes de él con scripts.
- Un modelo puede comprobarse como el código fuente: los nombres no resueltos, las unidades incorrectas y los puertos que no encajan se notifican donde aparecen.
La notación textual no sustituye a los diagramas. Convierte el modelo en el artefacto principal, y los diagramas pasan a ser vistas de él, como se describe más abajo.
Biblioteca estándar, magnitudes y unidades
SysML v1 tipa una propiedad de valor con un tipo de valor, que puede llevar una unidad y un tipo de magnitud. La especificación incluye un modelo de magnitudes y unidades, y bibliotecas de modelos para las unidades habituales, pero las herramientas difieren en qué bibliotecas incluyen y hasta qué punto comprueban las unidades en las expresiones.
SysML v2 incluye una biblioteca estándar como parte del lenguaje. Contiene el Sistema Internacional de Magnitudes (ISQ), las unidades SI (SI), las unidades consuetudinarias de EE. UU., tipos escalares, colecciones y las definiciones de vista estándar. En el listado anterior:
attribute mass : MassValuedice que el atributo es una masa, no un número.6.5 [kg]es un valor de magnitud: un número con una unidad, escrito en línea.pump.mass + radiator.masssuma dos masas. Una herramienta que evalúa unidades puede rechazar una expresión que suma una masa a una potencia, o una masa expresada en voltios.
Puertos, interfaces y conexiones
Los puertos de SysML v1 pasaron por varios diseños. Las primeras versiones tenían puertos estándar y puertos de flujo; las versiones posteriores los sustituyeron por puertos completos, puertos proxy y bloques de interfaz con propiedades de flujo. Una propiedad de flujo tiene una dirección (in, out o inout), un puerto puede conjugarse para invertir las direcciones, y los flujos de ítems en los conectores dicen qué se mueve. Muchos modelos v1 existentes aún mezclan los tipos de puerto antiguos y nuevos.
SysML v2 conserva las ideas y las unifica. Una definición de puerto enumera características con dirección, el lado receptor usa el conjugado ~ de la misma definición, y una definición de interfaz describe un tipo de conexión con extremos tipados.
package CoolantInterfaces {
private import ISQ::*;
item def Coolant {
attribute temperature : ThermodynamicTemperatureValue;
}
port def CoolantPort {
out item coolant : Coolant;
}
interface def Hose {
end supply : CoolantPort;
end ret : ~CoolantPort;
}
part def Pump {
port outlet : CoolantPort;
}
part def Radiator {
port inlet : ~CoolantPort;
}
part def Loop {
part pump : Pump;
part radiator : Radiator;
interface hose : Hose connect pump.outlet to radiator.inlet;
}
}
| SysML v1 | SysML v2 |
|---|---|
| Bloque de interfaz con propiedades de flujo | port def con características in, out o inout |
| Puerto proxy o completo tipado por el bloque de interfaz | Uso de port tipado por la definición de puerto |
| Tipo de puerto conjugado | ~CoolantPort |
| Conector, opcionalmente tipado por un bloque de asociación | connect … to …, o un uso de interface tipado por una interface def |
| Conector de enlace (binding) | bind a = b |
| Flujo de ítems en un conector | Uso de flow, o una característica de ítem del puerto |
Como las direcciones forman parte de las definiciones, un comprobador puede avisar cuando los dos extremos de una conexión envían la misma característica y ninguno la recibe.
Loop del listado en una vista de interconexión, el equivalente en SysML v2 de un diagrama de bloques internos.Comportamiento: acciones y estados
SysML v1 toma su comportamiento de UML: actividades con semántica de flujo de tokens, máquinas de estados e interacciones para los diagramas de secuencia. Un comportamiento se vincula a la estructura que lo lleva a cabo mediante asignación, a menudo con particiones de actividad (calles) o relaciones «allocate».
En SysML v2, las acciones y los estados son ocurrencias, como las partes. Una definición de acción tiene parámetros de entrada y de salida; las sucesiones (first … then …) dan el orden y los flujos dicen qué pasa entre pasos. Una definición de estado tiene estados y transiciones con disparadores, guardas y efectos. Una parte realiza (perform) una acción y exhibe (exhibit) un estado, así que el vínculo con la estructura forma parte del lenguaje en lugar de ser una relación añadida.
package PumpBehavior {
private import ISQ::*;
item def StartCommand;
item def StopCommand;
item def Coolant;
action def Circulate {
in item cold : Coolant;
out item warm : Coolant;
}
action def CoolEngine {
action pumpCoolant : Circulate;
action rejectHeat : Circulate;
flow pumpCoolant.warm to rejectHeat.cold;
first start then pumpCoolant;
first pumpCoolant then rejectHeat;
first rejectHeat then done;
}
state def PumpModes {
entry; then off;
state off;
state running;
transition first off accept StartCommand then running;
transition first running accept StopCommand then off;
}
part def Pump {
exhibit state modes : PumpModes;
}
}
| SysML v1 | SysML v2 |
|---|---|
| Actividad con acciones, flujos de control y flujos de objetos | action def con usos de acción, sucesiones y flow |
| Nodos de bifurcación, reunión, decisión y fusión | fork, join, decide y merge |
| Acción de llamada a comportamiento | Un uso de acción tipado por otra definición de acción |
| Partición o «allocate» de la actividad al bloque | perform en la parte |
| Máquina de estados perteneciente a un bloque | state def, con exhibit state en la parte |
| Transición con disparador, guarda y efecto | transition … accept … if … do … then … |
| Interacción (diagrama de secuencia) | Ocurrencias con message, mostradas en una vista de secuencia |
PumpModes en una vista de transición de estados, dibujada a partir del texto anterior.Requisitos y casos de verificación
Un requisito de SysML v1 es una clase estereotipada con dos cadenas: un id. y un texto. Las relaciones lo conectan con el resto del modelo: satisfy, verify, derive, refine, trace y copy. Un caso de prueba es un comportamiento marcado con «testCase». Comprobar un requisito con números requiere un bloque de restricción aparte en un diagrama paramétrico, y nada en el lenguaje une esa restricción con el texto del requisito.
En SysML v2, una definición de requisito es un tipo de definición de restricción. Tiene un sujeto (aquello de lo que trata el requisito), puede tener atributos como un límite y contiene la condición que debe cumplirse. El texto doc y la condición están en un solo elemento. Un caso de verificación indica en su objetivo el requisito que verifica y devuelve un veredicto.
package CoolingRequirements {
private import ScalarValues::*;
private import ISQ::*;
private import SI::*;
part def CoolingSystem {
attribute heatRejection : PowerValue;
}
part cooling : CoolingSystem {
attribute redefines heatRejection = 18 [kW];
}
requirement def <'CR-1'> HeatRejection {
doc /* The cooling system shall reject at least the engine's waste heat at full load. */
subject system : CoolingSystem;
attribute wasteHeat : PowerValue;
require constraint { system.heatRejection >= wasteHeat }
}
requirement coolingSpec : HeatRejection {
subject system : CoolingSystem;
attribute redefines wasteHeat = 15 [kW];
}
satisfy coolingSpec by cooling;
verification def <'VC-1'> HeatRunTest {
doc /* Run the engine at full load on a test stand and measure the heat the radiator rejects. */
subject system : CoolingSystem;
objective {
verify coolingSpec;
}
return verdict : Boolean = system.heatRejection >= coolingSpec.wasteHeat;
}
verification heatRun : HeatRunTest {
subject system = cooling;
}
}
<'CR-1'>es un nombre corto, el lugar que ocupa en v2 el id. del requisito de v1.require constraintes la forma comprobable del texto. Con 18 kW frente a 15 kW, una herramienta que evalúa restricciones notifica que el requisito se cumple.satisfyyverifyconservan su significado de v1. Derive, refine y trace corresponden a dependencias o a usos de requisito anidados en otros requisitos; cada equipo decide cómo modelarlos.- SysML v2 añade a los requisitos suposiciones (
assume constraint), partes interesadas y preocupaciones (concerns), y casos de uso y casos de análisis junto a los casos de verificación.
Vistas en lugar de diagramas dibujados
Un diagrama de SysML v1 es un dibujo que pertenece a la herramienta: alguien elige qué elementos aparecen y dónde. Dos diagramas del mismo bloque pueden discrepar sobre lo que contiene, y la disposición de los diagramas rara vez sobrevive a un intercambio entre herramientas. Las versiones posteriores de v1 añadieron vistas y puntos de vista, pero se usan sobre todo para documentos, no para los diagramas que los ingenieros dibujan a diario.
En SysML v2 una vista es un elemento del modelo. Nombra qué mostrar con expose, qué tipos de elemento incluir con filter y con qué definición de vista estándar representarla. La disposición queda en manos de la herramienta; lo que contiene la vista está en el modelo y puede leerse en el texto.
package CoolingViews {
private import StandardViewDefinitions::*;
part def Pump;
part def Radiator;
part def Loop {
part pump : Pump;
part radiator : Radiator;
connect pump to radiator;
}
view loopConnections : InterconnectionView {
expose Loop;
}
view structure : GeneralView {
filter @SysML::PartDefinition;
expose CoolingViews::*;
}
}
| Diagrama de SysML v1 | Vista de SysML v2 |
|---|---|
| Diagrama de definición de bloques, de paquetes, de requisitos | Vista general, con filtros |
| Diagrama de bloques interno | Vista de interconexión |
| Diagrama de actividad | Vista de flujo de acciones |
| Diagrama de máquina de estados | Vista de transición de estados |
| Diagrama de secuencia | Vista de secuencia |
| Diagrama paramétrico | Vista general o de interconexión de las restricciones y sus enlaces |
| Diagrama de casos de uso | Vista general de casos de uso y actores |
| Tablas y matrices (propias de cada herramienta en v1) | Vista de cuadrícula (Grid View) |
La Systems Modeling API y el intercambio en JSON
Los modelos SysML v1 pasan de una herramienta a otra como XMI. XMI es un estándar, pero cada herramienta escribe su propia variante, sus estereotipos y sus datos de diagrama, así que un intercambio suele requerir pruebas para cada par de herramientas, y no hay una forma estándar de que un programa consulte un modelo guardado en otra herramienta.
SysML v2 viene con la especificación Systems Modeling API and Services. Define servicios para proyectos, ramas, confirmaciones, elementos y consultas, y un enlace REST/HTTP en el que cada elemento es un objeto JSON con un @id y un @type. Las consecuencias:
- Un script, un panel o cualquier otra herramienta pueden leer y consultar un modelo a través de una interfaz documentada en lugar de una propia de un proveedor.
- Los id. de los elementos viajan con el modelo, así que los vínculos entre herramientas pueden sobrevivir a un intercambio.
- Los modelos se versionan como confirmaciones en ramas, de forma muy parecida al código fuente.
Los archivos de texto y JSON se complementan: el texto sirve para que las personas lo lean, lo revisen y lo comparen; JSON conserva los id. de los que dependen las herramientas.
Migrar un modelo de SysML v1 a v2
Llevar un modelo v1 a v2 es una traducción entre lenguajes, no una actualización de archivo, y la herramienta de destino decide cuánto se automatiza: qué comprobar en una herramienta SysML v2 trata la importación de v1 entre las demás comprobaciones. Gran parte de un modelo típico se traslada directamente, y una parte conviene reconstruirla al estilo de v2 en lugar de traducirla literalmente.
Lo que se traslada sin problemas
- Los paquetes y su anidamiento.
- Bloques a definiciones de parte, propiedades de parte a usos de parte, propiedades de referencia a usos
ref, generalizaciones a especializaciones. - Propiedades de valor a atributos, con magnitudes y unidades cuando los tipos de valor de v1 tenían unidades.
- Bloques de interfaz con propiedades de flujo a definiciones de puerto; puertos proxy y completos a usos de puerto; conectores a conexiones o interfaces.
- Id. y texto de los requisitos a nombres cortos y
doc; relaciones satisfy y verify. - Máquinas de estados a definiciones de estado; actividades bien estructuradas a definiciones de acción con sucesiones y flujos.
Lo que hay que replantear
- Valores específicos del contexto. Los tipos específicos de propiedad, las especificaciones de instancia y las redefiniciones creadas solo para fijar un valor pasan a ser simples redefiniciones en los usos. Una traducción literal conserva la solución provisional.
- Requisitos solo de texto. v2 los permite, pero el beneficio llega al añadir la condición. Decida qué requisitos reciben un
require constraint. - Bloques de restricción y diagramas paramétricos. Pasan a ser definiciones de restricción y de cálculo, a menudo escritas como expresiones directamente en los atributos, como
totalMassmás arriba. - Asignación. Las particiones de actividad y las relaciones «allocate» del comportamiento a la estructura pasan a ser
performyexhibitdonde el significado es «esta parte hace esto». - Tipos de puerto antiguos. Los puertos estándar y de flujo de los primeros modelos v1 son los que más trabajo requieren, ya que v2 tiene un único concepto de puerto.
- Perfiles y estereotipos. Los estereotipos personalizados y los valores etiquetados pasan a ser definiciones de metadatos; hay que volver a diseñar su significado.
- Diagramas. Las disposiciones no se trasladan. Cada diagrama que importa pasa a ser una vista, y su contenido se vuelve a expresar con
exposeyfilter. - Comportamientos opacos y scripts de herramientas. El código en un lenguaje de acciones o en el lenguaje de scripts de una herramienta no se traduce; hay que reescribirlo o mantenerlo fuera del modelo.
Planifique una migración como cualquier cambio del modelo: convierta primero un paquete representativo, revíselo con quienes usan el modelo, fije los patrones de modelado para los puntos anteriores y después convierta el resto. Conserve el modelo v1 como referencia hasta que se haya revisado el modelo v2. Llevar un modelo SysML v1 a SysML v2 recorre estos pasos.
Cómo se comprobaron los listados
Cada listado de esta página se analizó y comprobó con el Holarch Language Engine, el motor del Editor SysML v2 de Holarch, con la biblioteca estándar de SysML v2 cargada, y no da errores ni advertencias. Para saber qué construcciones de SysML v2 admite el motor y cuáles son sus carencias conocidas, consulte cobertura del lenguaje SysML v2. Para un modelo resuelto más largo, consulte el tutorial de SysML v2.
Pruébelo en Holarch
Holarch tiene proyectos SysML v2, en los que la notación textual y las vistas editan un mismo modelo, y proyectos LML. Para leer los listados anteriores como modelo:
- Cree un proyecto SysML v2. Consulte primeros pasos con proyectos SysML v2.
- En Modelo → Editor, haga clic en + Nuevo package y pegue un listado. El texto que se analiza correctamente se aplica tras una breve pausa, y los problemas se marcan en su lugar. Consulte el Editor.
- Abra la lista Diagramas para ver las vistas. Consulte la referencia de vistas.
Modelos SysML v1. Un proyecto SysML v2 importa directamente un modelo SysML 1.x: en Modelo → Importar y exportar, suelte un archivo XMI (de Cameo Systems Modeler o MagicDraw, Enterprise Architect, Rhapsody o Papyrus) o un proyecto .mdzip de Cameo o MagicDraw. Holarch lo convierte en texto SysML v2, comprueba el texto y muestra un informe de conversión que marca cada elemento como convertido, aproximado u omitido, con el motivo, antes de que cambie nada. La disposición de los diagramas no se convierte, así que trate el resultado como punto de partida para el replanteamiento descrito arriba, no como una migración terminada. Consulte importar modelos SysML v1.
Los proyectos LML también importan XMI de SysML 1.x y vuelven a exportar el modelo como XMI de SysML 1.6 o como archivo .uml de Papyrus; un archivo editado en Papyrus se vuelve a importar en el mismo proyecto y actualiza los elementos en su lugar según el id. XMI. Consulte importar un modelo UML/SysML y ida y vuelta con Papyrus.
Siguientes pasos
- Tutorial de SysML v2: construya un sistema pequeño paso a paso en la notación textual.
- Herramientas SysML v2: qué comprobar antes de elegir una: una lista de comprobación y un modelo de prueba para cualquier herramienta candidata.
- Proyectos SysML v2 en Holarch: texto, vistas y páginas de ingeniería sobre un mismo modelo.
- Cobertura del lenguaje SysML v2: qué admite el motor y sus carencias conocidas.
- Intercambiar modelos SysML v2: texto, JSON y repositorios de la Systems Modeling API.