SysML v2
Conversión entre LML y SysML v2
Cree una copia SysML v2 de un proyecto LML, o una copia LML de un proyecto SysML v2, con un informe de lo que se convierte y lo que no.
Resumen
El tipo de un proyecto, LML o SysML v2, se fija al crearlo. Para trabajar en un modelo LML en SysML v2, o en un modelo SysML v2 con páginas LML, cree una copia convertida:
- Crear una copia SysML v2… en un proyecto LML escribe su modelo como texto SysML v2 en un nuevo proyecto SysML v2.
- Crear una copia LML… en un proyecto SysML v2 convierte su modelo en entidades y relaciones LML en un nuevo proyecto LML.
El proyecto original nunca se cambia. Antes de crear la copia, un informe enumera lo que se convierte, con recuentos, y lo que no, con el motivo. El mismo informe se guarda en el nuevo proyecto.
Conceptos
Una copia, no un cambio de tipo
La conversión siempre crea un proyecto nuevo. Puede seguir trabajando en el original y convertir de nuevo más tarde; cada conversión crea otro proyecto nuevo. Nada vincula la copia con el original.
Cómo se corresponden los dos lenguajes
LML y SysML v2 describen muchas de las mismas cosas de formas distintas. La conversión usa esta correspondencia en ambas direcciones:
| LML | SysML v2 |
|---|---|
| Asset | Definición de parte, con un uso de parte allí donde se usa |
| Descomposición de un Asset (decomposed by) | Uso de parte en la definición del padre |
| Port | Uso de puerto |
| Characteristic de un Asset | Uso de atributo |
| Conduit | Uso de conexión, o uso de interfaz cuando ambos extremos son puertos |
| Input/Output | Definición de ítem, con parámetros de ítem in y out y flujos |
| Requirement (Number, Name, Description) | Uso de requisito (nombre corto, nombre, doc) |
| satisfied by | satisfy |
| Test Case | Uso de verificación con un objetivo verify |
| Test Suite | Paquete de casos de verificación |
| Action, con su flujo | Uso de acción con sucesiones |
| SYNC y bloques paralelos | Fork y join |
| OR | Decide y merge |
| LOOP | Acción loop |
| performed by | perform |
| Characteristics de estado y transiciones | Definición de estado con transiciones, que la parte exhibe |
| Equation y sus variables | Definición de restricción con sus parámetros |
Los datos de Holarch se copian también
Algunos datos no tienen lugar en ninguno de los dos lenguajes. Son datos de Holarch, y se copian con sus vínculos:
- Los riesgos, decisiones, tareas, costes, cronogramas, incidencias, documentos y pizarras se copian y siguen vinculados a los elementos convertidos.
- El estado de los requisitos y los métodos de verificación se quedan con cada requisito; los resultados de prueba se quedan con cada caso de prueba. También se conservan los estados personalizados de los flujos de trabajo de clase.
- Los cambios de esquema se trasladan en ambas direcciones, incluidos los flujos de trabajo de clase con sus estados, estados retirados, transiciones y aprobadores.
- Los comentarios de discusión siguen a su elemento.
- Las probabilidades de las ramas de las decisiones se quedan con sus ramas, para el Simulador.
- Una copia LML hecha a partir de una copia SysML v2 recupera los atributos y etiquetas LML que conservó la primera conversión.
Qué no se convierte
- Los diseños de los diagramas. Las vistas y los diagramas se dibujan de nuevo en la copia.
- El historial, las líneas base y las solicitudes de cambio. La copia empieza sin ellos.
- Los elementos para los que un lenguaje no tiene lugar, como los Measures y Resources de LML, o las enumeraciones, cálculos y casos de análisis de SysML v2.
El informe nombra cada uno de estos elementos y da el motivo. Consulte Referencia del informe.
Cómo usarlo
Cuándo y por qué
Convierta cuando el lenguaje del proyecto ya no se ajuste al trabajo:
- De LML a SysML v2: su equipo o un cliente trabaja ahora en SysML v2, o el modelo debe intercambiarse con herramientas SysML v2. Convierta y luego exporte
.sysmlo JSON (consulte Intercambio de modelos SysML v2). - De SysML v2 a LML: necesita una página o un diagrama LML que los proyectos SysML v2 no tienen, o quiere el modelo en la forma de ciclo de vida de Holarch para una revisión.
Convierta cuando el modelo sea estable, y lea el informe antes de confiar en la copia.
Crear una copia convertida
- En Gestionar proyectos, haga clic en ⋯ en la fila del proyecto.
- Elija Crear una copia SysML v2… (para un proyecto LML) o Crear una copia LML… (para un proyecto SysML v2).
Holarch comprueba la conversión; en un proyecto grande, una barra de progreso en la parte inferior de la ventana dice «Comprobando la conversión…». Después se abre el diálogo con el informe.
- Lea el informe:
- Convertido enumera cada tipo de elemento, cuántos hay y en qué se convierte, por ejemplo «Requisitos 24 usos de requisito».
- No convertido enumera cada tipo de elemento que no se convierte, cuántos hay y por qué.
- Haga clic en Descargar informe (CSV) para guardar el informe con una fila por elemento, si lo necesita fuera de Holarch.
- Introduzca el Nombre del nuevo proyecto. De forma predeterminada es el nombre del original seguido de «(SysML v2)» o «(LML)».
- Haga clic en Crear copia.
El aviso dice «Se creó «<name>»». La copia se abre en su página Inicio.
- Abra el documento Informe de conversión en la copia. Enumera cada elemento que no se convirtió, por número y nombre.
Comprobar la copia
- En una copia SysML v2, abra Modelo → Editor.
El modelo es un paquete de nivel superior con el nombre del proyecto. Contiene los paquetes Architecture, System, Items, Requirements, Verification, Behavior, Constraints y Views (solo los que tienen contenido).
- Busque marcas de problemas en el margen. Si el texto convertido tiene problemas, el diálogo lo indicó antes de crear la copia: «El texto convertido tiene N problemas. La copia los muestra en su Editor.»
- Abra las vistas en Vistas (Architecture Overview, System Connections) para ver la estructura dibujada de nuevo.
- En una copia LML, abra la Base de datos y los diagramas para comprobar los Assets, los Requirements y los flujos de acciones.
Ejemplo práctico: la demostración Hybrid Car como copia LML
Cree primero la demostración: en Gestionar proyectos, haga clic en Archivos de proyecto ▾ → Nuevo proyecto de demostración → Hybrid Car (SysML v2).
- En Gestionar proyectos, haga clic en ⋯ en Hybrid Car (SysML v2 demo) y elija Crear una copia LML…. La copia se llamará «Hybrid Car (SysML v2 demo) (LML)».
- Lea el informe.
En Convertido: los usos de parte se convierten en Assets, los usos de puerto en Ports, los atributos en Characteristics, los usos de conexión y de interfaz en Conduits, los usos y definiciones de requisito en Requirements, los usos de verificación en Test Cases, las acciones en Actions, y los estados y transiciones en sus equivalentes LML.
En No convertido, entre otros:
- Especializaciones: LML no tiene especialización; las partes reciben copiadas las características de sus definiciones generales.
SportCar :> Cares una. - Redefiniciones: la característica que redefine sustituye a la heredada en cada parte copiada. La batería del sedán se copia con 48 kg.
- Enumeraciones (
DriveMode,FuelKind): los valores de atributo se conservan como texto. - Cálculos (
PowerToWeight,ElectricRange) y casos de análisis (PowerToWeightAnalysis). - Conectores de enlace (
bind output = transmission.output;): LML no tiene enlace entre características. - Valores de atributo: se conservan como texto en el Value de cada Characteristic; las unidades y expresiones no se evalúan.
- Vistas: los diagramas se dibujan de nuevo en la copia LML.
- Especializaciones: LML no tiene especialización; las partes reciben copiadas las características de sus definiciones generales.
- Haga clic en Crear copia.
Se abre la copia LML.
fleet.sedany sus partes son Assets; el requisito Sedan Mass (VR-1.1) es un Requirement que satisface el Asset del sedán. Los riesgos, decisiones y tareas de la demostración también se copian, vinculados a los elementos convertidos.
Para probar la otra dirección, cree la demostración CubeSat EO-1 (un proyecto LML) y elija Crear una copia SysML v2… en ella.
Consejos y buenas prácticas
- Ordene un proyecto LML antes de convertirlo: conecte cada Conduit a exactamente dos Assets o Ports, asocie cada Characteristic a un Asset o a una Equation y quite los Test Suites vacíos. De lo contrario, se informan como no convertidos.
- En LML, escriba las etiquetas de rama OR como expresiones booleanas sobre valores del modelo (como
speed > 3) si desea que se conviertan en guardas. Las demás etiquetas se convierten en comentarios doc en las sucesiones. - En SysML v2, dé a los actores un tipo de definición de parte y a los parámetros de ítem un tipo de definición de ítem. Los que no tienen tipo no se convierten.
- Conserve el original. Después de cambios mayores, convierta de nuevo a partir de él en lugar de editar ambos proyectos en paralelo.
Errores habituales
- Esperar que cambie el original. No cambia. La copia es un proyecto independiente.
- Esperar que los diagramas conserven su diseño. Los diseños no se convierten; organice de nuevo las vistas o los diagramas nuevos.
- Faltan partes en una copia LML. Una definición de parte que ninguna parte usa no tiene Asset en LML, porque LML solo tiene instancias. Use la definición en una parte y convierta de nuevo.
- Un elemento «no se resuelve» en el informe. Un nombre del texto SysML v2 no apunta a nada. Corrija el nombre en el Editor y convierta de nuevo.
Referencia del informe
De LML a SysML v2
Los elementos convertidos incluyen Assets (definiciones de parte con sus usos de parte), Characteristics (atributos), Ports, Conduits (conexiones o interfaces), Input/Outputs (definiciones de ítem), Requirements, Actions y casos de uso, flujos de ítems entre acciones, States, Transitions, Equations (definiciones de restricción), Performs, Test suites, Test Cases, Verifies, Satisfies, y elementos de Holarch (copiados con sus vínculos): artefactos, declaraciones, tareas, riesgos, elementos de cronograma, costes, incidencias, decisiones, peligros y modos de fallo. Los flujos de trabajo de clase (los cambios de esquema del proyecto) se trasladan con sus estados personalizados, transiciones y aprobadores, de modo que los requisitos y los casos de prueba conservan sus valores de Status personalizados. La copia conserva los interruptores del programa formal y de Seguridad y fiabilidad del proyecto.
| No convertido | Motivo |
|---|---|
| Assets en un bucle de descomposición | Un asset que se contiene a sí mismo no tiene lugar en un árbol de partes. Su definición de parte se convierte; no se usa como parte. |
| Conduits sin exactamente dos extremos | Una conexión SysML une dos extremos. Conecte el conduit a dos assets o puertos y convierta de nuevo. |
| Ítems que transfiere un conduit | Las conexiones de esta conversión no transportan ítems. Los ítems se convierten como definiciones de ítem y flujos entre acciones. |
| Conduits descompuestos en otros conduits | Aquí las conexiones SysML no se anidan; cada conduit se convierte en su propia conexión. |
| Recuentos de bucle y scripts de bucle | Aquí un bucle SysML se repite hasta que se cumple una condición; el recuento se conserva como datos de Holarch y Crear una copia LML lo restaura. |
| Etiquetas y probabilidades de las ramas de decisión | Cuando todas las etiquetas de una decisión son expresiones booleanas sobre valores del modelo, las etiquetas se convierten en sus guardas; de lo contrario, se convierten en comentarios doc en las sucesiones. Las probabilidades se conservan como datos de Holarch para el Simulador, y Crear una copia LML restaura ambas. |
| Elementos OR, SYNC y LOOP | Las construcciones se convierten como nodos decide/merge, fork/join y loop; los elementos que les daban nombre no se conservan. |
| Acciones entry, do y exit de los estados | Las acciones se convierten como acciones; esta conversión no rellena los cuerpos de los estados SysML. |
| Transiciones sin dos estados de una misma máquina | Una transición SysML une dos estados de la misma definición de estado. |
| Guardas y disparadores de transiciones | En LML se escriben como texto libre; se conservan como datos de Holarch, no como expresiones SysML, y Crear una copia LML los restaura. |
| Estados no especificados por un asset | Un estado necesita el asset cuyo comportamiento describe. |
| Expresiones de las Equations | Las expresiones usan nombres que no son características SysML; cada una se conserva como comentario en su definición de restricción. |
| Test suites sin casos de prueba | Una suite se convierte en el paquete de sus casos de verificación; una suite vacía no tiene nada que contener. |
| Casos de prueba que verifican algo distinto de un requisito | Un caso de verificación SysML solo verifica requisitos. |
| Ciclos de prueba | Las ejecuciones de prueba registradas en una suite no forman parte del modelo; se conserva el último resultado de cada caso. |
| Requisitos satisfechos por otros tipos de elementos | Por ejemplo, en SysML un requisito no satisface otro requisito; use una derivación en el texto. |
| Otras relaciones | Esta conversión no tiene relación SysML para ellas; el informe nombra cada una. |
| Measures | Las medidas de efectividad no tienen elemento SysML en esta conversión. |
| Resources | Las cantidades de recursos (consumes, produces) pertenecen al simulador LML y aquí no tienen elemento SysML. |
| Characteristics no asociadas a un asset ni a una equation | Un atributo necesita un propietario: especifíquelo mediante un asset o conviértalo en una variable de una equation. |
| Elementos de otras clases | Esta clase no tiene elemento SysML ni lugar de Holarch en un proyecto SysML v2. |
| Características y configuraciones | Todavía no: las características y configuraciones de una línea de productos no se convierten en puntos de variación, variantes y configuraciones de SysML v2. El informe las enumera como elementos Feature y elementos Configuration; modele de nuevo las variantes en la copia (consulte Variantes y configuraciones de SysML v2). |
| Líneas base | Las líneas base del proyecto LML no se aplican al nuevo modelo; la copia empieza sin líneas base. |
| Historial | El historial de cambios empieza de cero en la copia. |
| Solicitudes de cambio | Las solicitudes de cambio LML proponen cambios en elementos LML, que la copia no tiene. |
| Diseños de diagramas | Los diagramas se dibujan de nuevo como vistas SysML v2; las posiciones no se trasladan. |
| Elementos convertidos en esquemas de documentos | Los documentos se copian; los requisitos y otros elementos del modelo de sus esquemas son ahora elementos SysML y aparecen en el modelo, no en el esquema. |
De SysML v2 a LML
Cada uso de parte se convierte en un Asset, con las partes, puertos y atributos de su definición (y de las definiciones que especializa) copiados en él. Las redefiniciones sustituyen lo que redefinen. Las conexiones e interfaces se convierten en Conduits entre esos Assets. Los requisitos, casos de verificación, satisfy, verify, perform, parámetros de ítem, estados y transiciones se corresponden de vuelta como en la tabla anterior. Las sucesiones se convierten en flujos de acciones; las guardas de una decisión (o los comentarios doc de sus sucesiones) se convierten en las etiquetas de rama OR, con sus probabilidades. Los cambios de esquema del proyecto se trasladan, incluidos los flujos de trabajo de clase con sus estados personalizados, transiciones y aprobadores, de modo que los requisitos y los casos de prueba conservan sus valores de Status personalizados.
| No convertido | Motivo |
|---|---|
| Conexiones con extremos que no se resuelven | Corrija los nombres de los extremos en el texto y convierta de nuevo. |
| Conexiones dentro de definiciones que ninguna parte usa | Cada conexión se convierte en un conduit entre las partes de cada parte que la tiene; nada usa esta definición. |
| Conectores de enlace | LML no tiene enlace (igualdad) entre características. |
| Relaciones verify que no se resuelven | Corrija el nombre del requisito en el objetivo de verificación y convierta de nuevo. |
| Parámetros de ítem sin definición de ítem | Tipifique el parámetro con un item def para convertirlo. |
| Actores sin definición de parte en el modelo | Tipifique el actor con un part def para convertirlo. |
| Usos perform que no se resuelven a una acción y una parte | Realice (perform) una acción desde una definición de parte o un uso de parte y convierta de nuevo. |
| Relaciones satisfy que no se resuelven | Corrija los nombres en la sentencia satisfy y convierta de nuevo. |
| Sucesiones que no son un flujo estructurado | Los flujos de acciones LML son secuencias con bloques paralelos, de decisión y de bucle; los demás grafos de sucesiones se linealizan. |
| Definiciones de estado que ninguna parte exhibe | Los estados se convierten sin el asset cuyo comportamiento describen. |
| Transiciones que no se resuelven a dos estados | Corrija los nombres de los estados y convierta de nuevo. |
| Disparadores de transiciones (accept) | Las transiciones LML conservan el disparador solo como texto libre; la señal aceptada no se vincula. |
| Definiciones de puerto, interfaz y conexión | Se convierten como Ports y Conduits donde las partes los usan; LML no tiene tipos de puerto, interfaz ni conexión. |
| Definiciones de atributo (tipos de valor) | Las characteristics LML no tienen tipos. |
| Enumeraciones y valores de enumeración | LML no tiene enumeraciones; los valores de atributo se conservan como texto. |
| Cálculos, casos de análisis, preocupaciones | LML no tiene cálculos, casos de análisis ni preocupaciones de las partes interesadas. |
| Vistas y puntos de vista | Los diagramas se dibujan de nuevo en la copia LML. |
| Acciones de asignación, if, send y accept | Las acciones LML no tienen sentencias. |
| Dependencias | LML no tiene dependencia genérica. |
| Asignaciones (allocations) | Use perform en el texto para las acciones que realizan las partes. |
| Metadatos | LML no tiene metadatos. |
| Ocurrencias | LML no tiene ocurrencias. |
| Casos de uso incluidos | Las relaciones include entre casos de uso no se convierten. |
| Alias | Las entidades LML tienen un solo nombre cada una. |
| Usos de referencia (parámetros de cálculos y casos) | LML no tiene parámetros, salvo las variables de las equations. |
| Especializaciones | LML no tiene especialización; las partes reciben copiadas las características de sus definiciones generales. |
| Redefiniciones | La característica que redefine sustituye a la heredada en cada parte copiada. |
| Subconjuntos (subsettings) | LML no tiene subsetting. |
| Importaciones | LML no tiene espacios de nombres; cada entidad es visible en el proyecto. |
| Definiciones como algo distinto de los usos | LML solo tiene instancias: una definición de parte se convierte en los Assets de las partes que la usan, y su texto pasa a sus descripciones. |
| Multiplicidades que no son de partes | Solo las multiplicidades de partes tienen lugar en LML (la Multiplicity de decomposed by). |
| Valores de atributos | Los valores se conservan como texto en el Value de cada characteristic; las unidades y expresiones no se evalúan. |
| Líneas base | Las líneas base del proyecto SysML v2 no se aplican a la copia LML; empieza sin líneas base. |
| Historial | El historial de cambios empieza de cero en la copia. |
| Solicitudes de cambio | Las solicitudes de cambio SysML proponen cambios de texto que no se aplican a las entidades LML. |
CSV del informe
Descargar informe (CSV) escribe una fila por tipo de elemento convertido y una fila por cada elemento que no se convirtió. Sus columnas son Resultado (Convertido o No convertido), Qué, Recuento, Se convierte en o motivo, Número y Nombre.
Mensajes
| Mensaje | Significado y solución |
|---|---|
| Comprobando la conversión… (barra de progreso) | Se está preparando el informe. |
| Este ya es un proyecto SysML v2. Elija Crear una copia LML… en su lugar. | Se eligió la dirección equivocada. |
| Este ya es un proyecto LML. Elija Crear una copia SysML v2… en su lugar. | Se eligió la dirección equivocada. |
| El texto convertido tiene N problemas. La copia los muestra en su Editor. | La copia se puede crear; corrija los problemas en su Editor. |
| El texto convertido no se analiza (…). El proyecto no se copió; notifíquelo con el archivo del proyecto. | La conversión falló. Póngase en contacto con soporte con el archivo del proyecto. |
| El comprobador SysML no se inició. Recargue la página e inténtelo de nuevo. | Recargue e inténtelo de nuevo. |
| No se pudo leer el proyecto. Recargue la página e inténtelo de nuevo. | Recargue e inténtelo de nuevo. |
| La copia no se creó: … Recargue la página e inténtelo de nuevo. | Recargue e inténtelo de nuevo. |
| Se creó «<name>» | La copia se creó y se abrió. |
Límites
- Los diseños de diagramas, el historial, las líneas base y las solicitudes de cambio no se convierten.
- Todavía no: convertir una línea de productos LML (características y configuraciones) en variantes de SysML v2.
- El documento del informe enumera hasta 500 elementos por tipo.
Páginas relacionadas
- Primeros pasos con proyectos SysML v2
- Intercambio de modelos SysML v2
- Funciones de Holarch en proyectos SysML v2
- Notación textual de SysML v2
SysML® y OMG® son marcas registradas de Object Management Group, Inc. en los Estados Unidos y otros países.