SysML v2
Importación de modelos SysML v1
Convierta un modelo SysML 1.x de Cameo, MagicDraw, Enterprise Architect, Rhapsody o Papyrus en texto SysML v2, revise lo que cambió de forma e impórtelo en un proyecto SysML v2.
En esta página
Resumen
Puede llevar un modelo SysML 1.x a un proyecto SysML v2. Holarch lee el archivo XMI del modelo, lo convierte en texto SysML v2, comprueba el texto y muestra un informe de conversión antes de cambiar nada.
- Entrada: un modelo SysML 1.x como XMI (
.xmi,.uml,.xml) o un proyecto de Cameo o MagicDraw (.mdzip). - Salida: texto SysML v2 en su proyecto (un solo Deshacer lo revierte todo), o un proyecto SysML v2 nuevo.
- Informe: cada elemento v1 con su resultado: Convertido, Aproximado o Excluido, y por qué.
La conversión sigue la transformación de SysML v1 a SysML v2 de la especificación OMG SysML 2.0, cuando un modelo intercambiado como XMI contiene suficiente detalle para ello.
Conceptos
Convertido, aproximado y excluido
Cada elemento del modelo v1 obtiene 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, un full port tipificado por un interface block se convierte en un port, y una transición a través de un pseudoestado choice se convierte en una transición por cada camino.
- Excluido: SysML v2 no tiene equivalente, o el elemento apunta a algo que no está en el archivo. Son ejemplos los nodos flow final, las particiones de actividad, las extensiones de casos de uso y las instance specifications.
El informe da con palabras el motivo de cada elemento aproximado y excluido.
El paquete SysMLv1Library
Algunas propiedades de SysML v1 no tienen palabra clave de SysML v2, como isEncapsulated de un block o una relación refine. El convertidor las conserva como metadatos del paquete SysMLv1Library, por ejemplo @SysMLv1Library::RefineData { isRefine = true; }. El paquete forma parte de la biblioteca de Holarch, por lo que estos nombres se resuelven en todos los proyectos SysML v2.
Los cuerpos opacos se convierten en representaciones textuales
Los opaque behaviors, opaque actions, guardas y constraint specifications contienen texto en un lenguaje como OCL o inglés. El convertidor conserva cada cuerpo como representación textual: language "OCL" /* … */. Los cuerpos en SysML o KerML se comprueban como el resto del texto. Consulte Representaciones textuales.
Cómo usarlo
Cuándo y por qué
Use la importación cuando un equipo traslada un modelo SysML 1.x existente a SysML v2, o quiere reutilizar partes de uno. El texto convertido es un punto de partida: el informe le indica qué revisar a mano.
Importar un modelo SysML v1 en un proyecto
- Abra un proyecto SysML v2 y haga clic en Modelo → Importación y exportación.
- En Importar, elija En este proyecto o En un proyecto SysML v2 nuevo.
- Suelte el archivo
.xmi,.uml,.xmlo.mdzipen el recuadro, o haga clic en el recuadro para elegirlo. Verá una tarjeta de progreso con las fases Leyendo el archivo XMI…, Convirtiendo a SysML v2… y Comprobando el resultado…. - Lea Conversión desde SysML v1 en la parte superior de la vista previa. Indica el número de elementos convertidos, aproximados y excluidos, y si el texto SysML v2 se comprueba sin problemas.
- Use Mostrar para listar los elementos aproximados y excluidos, solo uno de los dos grupos o todos los elementos. Cada fila da el elemento, su tipo en SysML v1, el resultado con la palabra clave y el nombre calificado de SysML v2, y Por qué.
- Abra Mostrar el texto SysML v2 para leer el resultado antes de importarlo.
- Desmarque en la tabla inferior los paquetes que no desee y haga clic en Importar N packages (o Crear proyecto). El modelo se importa, y un solo Deshacer lo revierte todo. Deshacer lo vuelve a quitar.
Importar una versión más reciente del mismo modelo
Cuando el modelo SysML v1 cambie, expórtelo de nuevo e importe el nuevo archivo en el mismo proyecto (En este proyecto). Cada elemento convertido toma su id del id del elemento en el archivo XMI (xmi:id), de modo que la importación actualiza los elementos en su sitio: un elemento renombrado o movido a otro paquete en la herramienta SysML v1 sigue siendo el mismo elemento, con sus diseños de diagrama, comentarios, vínculos e historial. El informe indica cuántos elementos toman sus ids del modelo SysML v1. Los elementos sin nombre (conectores, sucesiones) se emparejan por su lugar en el modelo.
Un proyecto importado de un modelo SysML v1 antes de que Holarch derivara los ids del archivo XMI conserva sus ids: una exportación más reciente actualiza sus elementos por nombre, y los elementos nuevos en el modelo SysML v1 toman de él sus ids.
Conservar el informe y el texto
- Haga clic en Descargar informe para obtener un archivo CSV con cada elemento, su resultado, su ruta en SysML v2 y el motivo.
- Haga clic en Descargar texto SysML v2 para obtener el archivo
.sysmlconvertido.
Exportar el modelo desde su herramienta SysML v1
- Cameo Systems Modeler y MagicDraw: importe directamente el proyecto
.mdzip, o use File → Export To → Eclipse UML2 (v5.x) XMI File e importe el archivo.xmi. - Enterprise Architect: seleccione el paquete, elija Publish → Export XML, seleccione XMI 2.1 e importe el archivo
.xml. Los archivos de proyecto de Enterprise Architect (.eap,.qea) no se pueden leer directamente. - IBM Rhapsody: exporte el modelo con el XMI toolkit (XMI 2.x) e importe el archivo.
- Eclipse Papyrus: importe el archivo
.umldel modelo.
Ejemplo práctico: el modelo CubeSat EO-1
La demostración CubeSat EO-1 es un proyecto LML. Su exportación SysML v1 constituye un modelo de prueba realista.
- Abra la demostración CubeSat EO-1 y expórtela como XMI de UML/SysML en el formato OMG XMI 2.5.1 (consulte Exportar un modelo UML/SysML (XMI)).
- Abra un proyecto SysML v2, haga clic en Modelo → Importación y exportación, elija En un proyecto SysML v2 nuevo y suelte el archivo
.xmi. El informe dice: 1,042 elementos, 1,007 convertidos, 32 aproximados, 3 excluidos. El texto SysML v2 se comprueba sin problemas. - Ponga Mostrar en Excluido. Las tres filas son una extensión de caso de uso, que SysML v2 no tiene, y dos relaciones trace a elementos sin nombre, a los que el texto SysML v2 no puede hacer referencia.
- Haga clic en Crear proyecto. El nuevo proyecto SysML v2 se abre en el Editor con la estructura, las funciones, los requisitos y las trazas del satélite.
Consejos y errores comunes
- Importe un archivo XMI cada vez, sin otros archivos. Importe un archivo XMI de SysML v1 cada vez, sin otros archivos.
- Dé nombre a los elementos a los que traza. Las relaciones con elementos sin nombre se excluyen, porque el texto SysML v2 hace referencia a los elementos por su nombre.
- Vuelva a importar, no vuelva a crear. Importe una exportación más reciente en el mismo proyecto en lugar de en uno nuevo: los elementos conservan sus ids solo dentro del proyecto que los tiene.
- Compruebe primero las aproximaciones. Son los lugares donde el significado puede diferir del modelo v1, como ports tipificados por blocks o extremos de conectores dentro de partes.
- Los elementos con el mismo nombre en un mismo lugar se renombran con un sufijo como
_2. El informe enumera cada cambio de nombre. - Los requisitos que se mantienen en una herramienta de requisitos (DOORS, Polarion, Jama, codebeamer) llegan como ReqIF, no como XMI. Importe el archivo
.reqifen la misma página: se convierte en requisitos SysML v2 con el mismo tipo de informe (Importar y exportar requisitos ReqIF).
Qué se convierte
| SysML v1 | SysML v2 |
|---|---|
| Model, package | package |
| Bloque, actor | part def |
| Value type, data type, enumeration | attribute def, enum def (los value types con una unidad SI conocida especializan la magnitud ISQ) |
| Signal | item def |
| Interface block | port def |
| Propiedades de parte, de referencia y de valor | part, ref part, attribute, con multiplicidades y valores predeterminados |
| Proxy port, flow property | port, item o attribute in/out |
| Full port | part con @SysMLv1Library::PortData |
| Conector, conector de enlace, flujo de elementos | connect, bind, flow |
| Generalization | :> |
| Activity, call behavior action, pins | action def, action, parámetros |
| Control flows y object flows, guardas | sucesiones con guardas if y else, flujos entre parámetros |
| Initial, final, decision, merge, fork, join | start, done, decide, merge, fork, join |
| State machine, states, regions | state def, state, estados paralelos |
| Transitions, triggers de señal y de tiempo | transition con accept, accept after, guardas y efectos |
| Interaction | occurrence def con líneas de vida y mensajes |
| Use case, subject, include | use case def, subject, include |
| Requirement (id y texto) | requirement <'id'> Name { doc /* text */ } |
| Satisfy, verify, derive requirement | satisfy, verify en un objetivo de verificación, conexión de derivación |
| Refine, trace | dependency con metadatos de SysMLv1Library |
| Allocate, dependency | allocate, dependency |
| Constraint block, constraint | constraint def, assert constraint |
| Estereotipos y valores etiquetados | Un metadata def por estereotipo, aplicado con sus etiquetas |
| Comment, documentation | doc, comment |
Límites
- Un archivo de 64 MB como máximo.
- Como máximo 250,000 elementos, anidados hasta 512 niveles de profundidad. Un modelo anidado a mayor profundidad, o con un ciclo de propiedad, no se importa.
- En el modelo convertido, los elementos anidados a más de 128 niveles de profundidad se excluyen con el motivo anidamiento.
- El texto convertido tiene como máximo 8 MB.
- Los diagramas y su diseño no se convierten. Cree vistas en el proyecto SysML v2.
Mensajes
| Mensaje | Qué hacer |
|---|---|
| Importe un archivo XMI de SysML v1 cada vez, sin otros archivos. | Importe el archivo XMI por sí solo. |
| <file> no contiene elementos UML ni SysML. Exporte el modelo como XMI 2.x e impórtelo de nuevo. | Exporte de nuevo el modelo como XMI 2.x. |
| No se encontró ningún modelo UML en <file>. En Cameo o MagicDraw, exporte el modelo como Eclipse UML2 XMI e importe el archivo .xmi. | Exporte el proyecto como XMI. |
| El modelo SysML v1 tiene más de 250,000 elementos. Exporte una parte más pequeña del modelo. | Exporte un paquete cada vez. |
| El texto SysML v2 convertido superaría los 8 MB. Exporte una parte más pequeña del modelo. | Exporte un paquete cada vez. |
Páginas relacionadas
- Intercambio de modelos SysML v2
- Importar y exportar requisitos ReqIF: requisitos de DOORS, Polarion y otras herramientas de requisitos.
- Notación textual de SysML v2
- Conversión entre LML y SysML v2
SysML® y OMG® son marcas registradas de Object Management Group, Inc. en los Estados Unidos y otros países.