Holarch

Guía · SysML v2

Llevar un modelo SysML v1 a SysML v2: una migración paso a paso

Un modelo SysML v1 puede convertirse a SysML v2 automáticamente, pero una migración es más que la conversión de un archivo: alguien tiene que decidir cómo debe ser el modelo convertido y comprobar que sigue diciendo lo que decía el modelo v1. Esta guía recorre una migración en ocho pasos, desde el inventario del modelo v1 hasta el cambio definitivo, con un modelo pequeño convertido y leído línea a línea.

En esta página
  1. Antes de empezar: una traducción, no una actualización
  2. 1. Hacer inventario del modelo v1
  3. 2. Exportar el modelo desde la herramienta SysML v1
  4. 3. Convertir un paquete piloto
  5. 4. Leer el informe de conversión
  6. Un ejemplo resuelto: un modelo pequeño de rover
  7. 5. Rehacer lo que se aproximó u omitió
  8. 6. Reconstruir las vistas que importan
  9. 7. Comprobar y revisar el modelo v2
  10. 8. Convertir el resto y hacer el cambio
  11. Lista de comprobación de la migración
  12. Siguientes pasos

Antes de empezar: una traducción, no una actualización

SysML v2 es un lenguaje nuevo, no una versión nueva del formato de archivo de SysML v1. Los bloques se convierten en definiciones de parte, los puertos se tipan con definiciones de puerto, los requisitos llevan condiciones y los diagramas pasan a ser vistas que define el modelo. SysML v1 frente a v2 explica las diferencias una a una.

Un conversor hace la parte mecánica: cada elemento que tiene equivalente en SysML v2 se escribe en SysML v2, y el resto se notifica. Lo que un conversor no puede hacer es decidir cómo quiere usar su equipo el nuevo lenguaje. Planifique la migración como una tarea de modelado con un responsable, una revisión y un momento en que el modelo v2 pasa a ser la referencia.

Esta guía usa el conversor de Holarch, que importa un modelo SysML 1.x en un proyecto SysML v2 y notifica cada elemento como convertido, aproximado u omitido. Los pasos de planificación se aplican sea cual sea el conversor que use.

1. Hacer inventario del modelo v1

Antes de exportar nada, averigüe qué contiene el modelo y quién depende de él. Un inventario breve ahorra trabajo después.

  • Paquetes y responsables. Enumere los paquetes de nivel superior, quién mantiene cada uno y a cuáles hacen referencia otros modelos o documentos. Los paquetes son la unidad que convertirá y revisará.
  • Diagramas que importan. Anote los diagramas que la gente usa de verdad en revisiones y documentos. La disposición de los diagramas no pasa a SysML v2, así que se convierten en vistas que hay que reconstruir.
  • Perfiles y estereotipos. Enumere sus propios estereotipos y sus valores etiquetados. Se convierten en definiciones de metadatos, y hay que volver a acordar su significado en el nuevo modelo.
  • Comportamiento escrito como código. Los comportamientos opacos, las guardas y las restricciones en OCL, en un lenguaje de acciones o en el lenguaje de scripts de una herramienta se conservan como texto en su lenguaje original; no se traducen.
  • Elementos sin nombre. Las relaciones que apuntan a elementos sin nombre no se pueden escribir en texto SysML v2, que hace referencia a los elementos por su nombre. Ponga nombre ahora, en la herramienta v1, a los elementos a los que traza.
  • Tamaño. Holarch convierte de una vez un archivo de hasta 64 MB y 250.000 elementos. Los modelos más grandes se exportan paquete a paquete.

2. Exportar el modelo desde la herramienta SysML v1

El conversor lee el modelo desde XMI, el formato de intercambio que escriben las herramientas SysML v1. Cada herramienta lo exporta de forma algo distinta:

HerramientaQué importar
Cameo Systems Modeler, MagicDrawEl archivo de proyecto .mdzip, o File → Export To → Eclipse UML2 (v5.x) XMI File y el archivo .xmi
Enterprise ArchitectSeleccione el paquete, Publish → Export XML, elija XMI 2.1 e importe el archivo .xml. Los archivos de proyecto (.eap, .qea) no se leen directamente.
IBM RhapsodyUna exportación XMI 2.x desde el kit de herramientas XMI
Eclipse PapyrusEl archivo .uml del modelo

Guarde el archivo exportado con los registros de la migración: es la entrada v1 exacta a la que se refiere su revisión.

3. Convertir un paquete piloto

Empiece con un paquete representativo pero que no sea el más grande: un subsistema con estructura, interfaces, algo de comportamiento y sus requisitos. El piloto muestra cómo queda la conversión de su modelo antes de comprometer a todo el equipo.

  1. Cree un proyecto SysML v2, o abra aquel en el que debe ir el modelo convertido, y haga clic en Modelo → Importar y exportar.
  2. En Importar, elija En un proyecto SysML v2 nuevo para un piloto, de modo que no se toque nada más.
  3. Suelte el archivo exportado en el recuadro. Una tarjeta de progreso muestra las fases: lectura del archivo XMI, conversión a SysML v2, comprobación del resultado.

Todavía no se importa nada. La pantalla siguiente es la vista previa con el informe de conversión.

4. Leer el informe de conversión

Conversión desde SysML v1, en la parte superior de la vista previa, indica el número de elementos convertidos, aproximados y omitidos, y si el texto SysML v2 se comprueba sin problemas. Cada elemento del modelo v1 tiene un resultado:

  • Convertido: el elemento tiene un equivalente directo en SysML v2, como un bloque que pasa a ser una part def.
  • Aproximado: el elemento se conserva de forma modificada, por ejemplo una transición a través de una elección que pasa a ser una transición por camino. Son los puntos en los que el significado puede diferir del modelo v1.
  • Omitido: SysML v2 no tiene equivalente, o el elemento apunta a algo que no está en el archivo.

Use Mostrar para enumerar los elementos aproximados y omitidos. Cada fila da el elemento, su tipo SysML v1, en qué se convirtió con su nombre SysML v2, y el motivo. Abra Mostrar el texto SysML v2 para leer el resultado y haga clic en Descargar informe para guardar el informe como archivo CSV. El CSV es la lista de trabajo del paso 5: ordénelo por motivo y asigne un responsable a cada grupo.

Un ejemplo resuelto: un modelo pequeño de rover

Un modelo SysML v1 pequeño de la cadena de potencia de un rover planetario, en tres paquetes:

PaqueteElementos SysML v1
TiposUn tipo de valor Power con la unidad W; un bloque Charge; un bloque de interfaz Power Interface con dos propiedades de flujo de salida, charge (un Charge) y voltage (un Real)
EstructuraUn bloque encapsulado Rover con propiedades de parte battery y computer, una propiedad de valor power budget de 120 W, un conector power bus entre sus puertos y un flujo de ítems power flow de Charge sobre él. Un bloque Battery con un puerto proxy out; un bloque Computer con un puerto proxy conjugado in y un puerto completo raw. Ambos llevan un estereotipo de usuario «Hardware» con valores etiquetados. Una asociación cuyo extremo pertenece a la asociación.
RequisitosRequisitos R-1 Mission y R-2 Power Margin; R-2 derivado de R-1; R-2 satisfecho por la parte battery; una traza de Computer a Battery

Convertido, queda así. El listado es la salida del conversor, sin cambios:

package 'Rover Model' {
  package Types {
    attribute def Power :> ISQ::PowerValue;
    part def Charge;
    port def 'Power Interface' {
      out item charge : Charge;
      out attribute voltage : ScalarValues::Real;
    }
  }
  package Structure {
    part def Rover {
      doc /* Six-wheeled science rover. */
      @SysMLv1Library::BlockData { isEncapsulated = true; }
      part battery : Battery;
      part computer : Computer;
      attribute 'power budget' : Types::Power = 120 [SI::W];
      connection 'power bus' connect battery.'out' to computer.'in';
      satisfy Requirements::'Power Margin' by battery;
      flow 'power flow' of Types::Charge from battery.'out' to computer.'in';
    }
    part def Battery {
      @'SysML v1 Profiles'::rov::Hardware { qualified = "true"; vendor = "Acme Cells"; }
      port 'out' : Types::'Power Interface';
      attribute capacity : Types::Power;
    }
    part def Computer {
      @'SysML v1 Profiles'::rov::Hardware { vendor = "Orbital Logic"; }
      port 'in' : ~Types::'Power Interface';
      part raw : Types::Charge {
        @SysMLv1Library::PortData { isFullPort = true; }
      }
    }
  }
  package Requirements {
    requirement <'R-1'> Mission {
      doc /* The rover shall explore the landing site. */
    }
    requirement <'R-2'> 'Power Margin' {
      doc /* Keep a 50 % power margin. */
    }
    connection : DerivationConnections::Derivation connect 'Power Margin' to Mission;
    dependency from Structure::Computer to Structure::Battery {
      @SysMLv1Library::TraceData { isTrace = true; }
    }
  }
}

package 'SysML v1 Profiles' {
  package rov {
    metadata def Hardware {
      attribute qualified : ScalarValues::String;
      attribute vendor : ScalarValues::String;
    }
  }
}

Qué pasó con cada parte del modelo v1:

  • Tipo de valor con unidad. Power en vatios especializa ISQ::PowerValue de la biblioteca estándar, y el valor por defecto se escribe con su unidad: 120 [SI::W]. Un tipo de valor cuya unidad no es una unidad SI asignada sigue siendo un número real, con la unidad en su documentación, y se notifica como aproximado.
  • Bloques y propiedades. Los bloques se convierten en part def y las propiedades de parte en part. El isEncapsulated del bloque no tiene palabra clave en SysML v2, así que se conserva como metadatos SysMLv1Library::BlockData.
  • Bloque de interfaz y puertos. El bloque de interfaz se convierte en una port def cuyas propiedades de flujo son características con dirección: out item para la tipada por un bloque y out attribute para el valor. El puerto proxy conjugado se tipa como ~Types::'Power Interface'. El puerto completo se convierte en una parte con metadatos SysMLv1Library::PortData, porque un puerto SysML v2 se tipa mediante una definición de puerto.
  • Conector y flujo de ítems. El conector se convierte en una connection entre los dos puertos, y el flujo de ítems sobre él en un flow de Charge entre los mismos puertos.
  • Requisitos. Cada requisito conserva su id. como nombre corto, <'R-1'>, y su texto como doc. La relación satisfy se sitúa en el bloque que posee la parte que satisface; la relación derive pasa a ser una conexión de derivación; la traza pasa a ser una dependencia con SysMLv1Library::TraceData.
  • El estereotipo de usuario. «Hardware» se convierte en una metadata def en un paquete 'SysML v1 Profiles', aplicada a cada bloque con sus valores etiquetados. Sus dos aplicaciones se notifican como aproximadas: los valores etiquetados pasaron a ser atributos de texto, fuera cual fuera su tipo en el perfil.
  • La asociación. Una asociación sin clase no tiene equivalente en SysML v2 en este caso, y su extremo perteneciente a la asociación tampoco se convierte. Ambos se notifican como omitidos; las propiedades de los bloques llevan la estructura.

El informe de este modelo: 31 elementos, 27 convertidos, 2 aproximados, 2 omitidos, y el texto se comprueba sin errores ni advertencias. Los nombres que no son identificadores simples, como 'power budget' o 'out' (una palabra clave de SysML v2), van entre comillas para conservar su escritura de v1.

5. Rehacer lo que se aproximó u omitió

Recorra las filas aproximadas y omitidas del informe por motivo. La mayoría de los motivos exigen una de unas pocas decisiones:

Qué dice el informeQué decidir
Un puerto está tipado por un bloque que no es un bloque de interfaz; se convirtió en un puerto sin tipoDefina una definición de puerto con las características que cruzan el límite y tipe el puerto con ella.
Transiciones a través de una elección, una unión, una bifurcación o una reunión; cada camino pasó a ser una transiciónCompruebe que las guardas unidas siguen diciendo lo que quería decir el diagrama v1; simplifique donde los caminos sean ahora más fáciles de leer.
Un disparador se conserva como documentaciónReescriba los disparadores de cambio y de tiempo como disparadores SysML v2 donde el significado esté claro, como accept after una duración.
Una unidad no es una unidad SI que Holarch asigne; el tipo de valor es un número realDecida si encaja una magnitud estándar, o conserve el número real y la unidad documentada.
Un tipo de acción distinto de una acción de llamada, opaca o de aceptación pasó a ser una acción simpleReescriba los envíos y otras acciones específicas con la acción SysML v2 que hace lo mismo.
Las particiones de actividad no se conviertenIndique qué parte hace qué con perform en la parte, en lugar de una calle.
Apunta a un elemento sin nombrePonga nombre al destino en la herramienta v1 y vuelva a convertir, o añada la relación en el modelo v2.
Su nombre se usa dos veces en el mismo lugar; se renombró con un sufijoDé a cada elemento un nombre que diga qué es.
Los valores etiquetados pasaron a ser atributos de texto de los metadatosDé a los atributos de metadatos los tipos que necesitan, y acuerde qué significa ahora cada estereotipo.

Dos tipos de texto merecen una revisión aunque se hayan convertido sin problemas. Los cuerpos opacos se conservan como representaciones textuales en su lenguaje original, como language "OCL" /* … */; Holarch solo comprueba los cuerpos escritos en SysML o KerML, así que reescriba una guarda o una restricción como expresión SysML donde el modelo deba evaluarla. Y las traducciones literales conservan soluciones provisionales de v1, como los tipos específicos de propiedad creados solo para fijar un valor: en SysML v2 son simples redefiniciones en los usos. Lo que hay que replantear enumera los casos habituales.

6. Reconstruir las vistas que importan

Los diagramas y su disposición no se convierten. Tome la lista de diagramas del paso 1 y cree una vista para cada uno que siga haciendo falta: una vista general para la estructura y los requisitos, una vista de interconexión para las partes y las conexiones, una vista de flujo de acciones para las actividades, una vista de transición de estados para las máquinas de estados. Reconstruya solo lo que la gente usa; el modelo contiene todo lo demás de todos modos. Consulte la referencia de vistas.

7. Comprobar y revisar el modelo v2

  • El texto se comprueba sin problemas. La importación muestra la comprobación del texto convertido antes de que cambie nada; después de su revisión, el Editor marca los problemas nuevos mientras escribe.
  • Los recuentos coinciden. Compare algunas cifras entre el modelo v1 y el modelo v2: requisitos, partes, puertos, conexiones, relaciones de verificación. Una diferencia que no se pueda explicar con el informe merece una revisión.
  • Quienes usan el modelo lo revisan. Recorra el paquete piloto con sus responsables, empezando por los elementos aproximados y las vistas reconstruidas.
  • Registre las decisiones. Anote los patrones de modelado que hayan decidido para puertos, disparadores, unidades y estereotipos, para que el resto de la migración los siga.

8. Convertir el resto y hacer el cambio

Convierta los paquetes restantes de uno en uno, en el mismo proyecto SysML v2. Cada importación muestra la misma vista previa: un paquete que ya está en el proyecto aparece como Cambiado o Sin cambios, uno nuevo como Nuevo, y usted elige qué paquetes importar. Cada importación es un solo paso de deshacer.

Conserve el modelo v1 como referencia hasta que se haya revisado el modelo v2; después, congélelo y convierta el proyecto SysML v2 en el modelo de referencia oficial. A partir de ese momento, los cambios solo se hacen en el modelo v2.

Lista de comprobación de la migración

  • Los paquetes, los responsables y los diagramas que importan están enumerados.
  • Los elementos a los que apuntan las relaciones tienen nombre.
  • El archivo XMI exportado se guarda con los registros de la migración.
  • Se ha convertido un paquete piloto, se ha descargado su informe y cada fila aproximada u omitida tiene una decisión.
  • Los patrones de modelado para puertos, disparadores, unidades y estereotipos están por escrito.
  • Las vistas necesarias están reconstruidas; el texto se comprueba sin problemas.
  • Los usuarios del modelo han revisado el piloto.
  • Los paquetes restantes se han convertido de la misma forma, y el modelo v1 está congelado.

Siguientes pasos

Cameo Systems Modeler, MagicDraw, Enterprise Architect, Rhapsody y Eclipse Papyrus son marcas comerciales de sus respectivos propietarios. Holarch no está afiliado a ellos ni cuenta con su respaldo.