Holarch

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.

Cómo usarlo →

En esta página
  1. Resumen
  2. Conceptos
    1. Una copia, no un cambio de tipo
    2. Cómo se corresponden los dos lenguajes
    3. Los datos de Holarch se copian también
    4. Qué no se convierte
  3. Cómo usarlo
    1. Cuándo y por qué
    2. Crear una copia convertida
    3. Comprobar la copia
    4. Ejemplo práctico: la demostración Hybrid Car como copia LML
    5. Consejos y buenas prácticas
    6. Errores habituales
  4. Referencia del informe
    1. De LML a SysML v2
    2. De SysML v2 a LML
    3. CSV del informe
  5. Mensajes
  6. Límites
  7. Páginas relacionadas

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:

LMLSysML v2
AssetDefinició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
PortUso de puerto
Characteristic de un AssetUso de atributo
ConduitUso de conexión, o uso de interfaz cuando ambos extremos son puertos
Input/OutputDefinició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 bysatisfy
Test CaseUso de verificación con un objetivo verify
Test SuitePaquete de casos de verificación
Action, con su flujoUso de acción con sucesiones
SYNC y bloques paralelosFork y join
ORDecide y merge
LOOPAcción loop
performed byperform
Characteristics de estado y transicionesDefinición de estado con transiciones, que la parte exhibe
Equation y sus variablesDefinició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 .sysml o 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

  1. En Gestionar proyectos, haga clic en ⋯ en la fila del proyecto.
  2. 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.

  3. 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é.
  4. Haga clic en Descargar informe (CSV) para guardar el informe con una fila por elemento, si lo necesita fuera de Holarch.
  5. Introduzca el Nombre del nuevo proyecto. De forma predeterminada es el nombre del original seguido de «(SysML v2)» o «(LML)».
  6. Haga clic en Crear copia.

    El aviso dice «Se creó «<name>»». La copia se abre en su página Inicio.

  7. 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

  1. 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).

  2. 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.»
  3. Abra las vistas en Vistas (Architecture Overview, System Connections) para ver la estructura dibujada de nuevo.
  4. 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).

  1. 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)».
  2. 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 :> Car es 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.
  3. Haga clic en Crear copia.

    Se abre la copia LML. fleet.sedan y 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 convertidoMotivo
Assets en un bucle de descomposiciónUn 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 extremosUna conexión SysML une dos extremos. Conecte el conduit a dos assets o puertos y convierta de nuevo.
Ítems que transfiere un conduitLas conexiones de esta conversión no transportan ítems. Los ítems se convierten como definiciones de ítem y flujos entre acciones.
Conduits descompuestos en otros conduitsAquí las conexiones SysML no se anidan; cada conduit se convierte en su propia conexión.
Recuentos de bucle y scripts de bucleAquí 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ónCuando 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 LOOPLas 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 estadosLas acciones se convierten como acciones; esta conversión no rellena los cuerpos de los estados SysML.
Transiciones sin dos estados de una misma máquinaUna transición SysML une dos estados de la misma definición de estado.
Guardas y disparadores de transicionesEn 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 assetUn estado necesita el asset cuyo comportamiento describe.
Expresiones de las EquationsLas 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 pruebaUna 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 requisitoUn caso de verificación SysML solo verifica requisitos.
Ciclos de pruebaLas 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 elementosPor ejemplo, en SysML un requisito no satisface otro requisito; use una derivación en el texto.
Otras relacionesEsta conversión no tiene relación SysML para ellas; el informe nombra cada una.
MeasuresLas medidas de efectividad no tienen elemento SysML en esta conversión.
ResourcesLas cantidades de recursos (consumes, produces) pertenecen al simulador LML y aquí no tienen elemento SysML.
Characteristics no asociadas a un asset ni a una equationUn atributo necesita un propietario: especifíquelo mediante un asset o conviértalo en una variable de una equation.
Elementos de otras clasesEsta clase no tiene elemento SysML ni lugar de Holarch en un proyecto SysML v2.
Características y configuracionesTodaví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 baseLas líneas base del proyecto LML no se aplican al nuevo modelo; la copia empieza sin líneas base.
HistorialEl historial de cambios empieza de cero en la copia.
Solicitudes de cambioLas solicitudes de cambio LML proponen cambios en elementos LML, que la copia no tiene.
Diseños de diagramasLos diagramas se dibujan de nuevo como vistas SysML v2; las posiciones no se trasladan.
Elementos convertidos en esquemas de documentosLos 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 convertidoMotivo
Conexiones con extremos que no se resuelvenCorrija los nombres de los extremos en el texto y convierta de nuevo.
Conexiones dentro de definiciones que ninguna parte usaCada conexión se convierte en un conduit entre las partes de cada parte que la tiene; nada usa esta definición.
Conectores de enlaceLML no tiene enlace (igualdad) entre características.
Relaciones verify que no se resuelvenCorrija el nombre del requisito en el objetivo de verificación y convierta de nuevo.
Parámetros de ítem sin definición de ítemTipifique el parámetro con un item def para convertirlo.
Actores sin definición de parte en el modeloTipifique el actor con un part def para convertirlo.
Usos perform que no se resuelven a una acción y una parteRealice (perform) una acción desde una definición de parte o un uso de parte y convierta de nuevo.
Relaciones satisfy que no se resuelvenCorrija los nombres en la sentencia satisfy y convierta de nuevo.
Sucesiones que no son un flujo estructuradoLos 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 exhibeLos estados se convierten sin el asset cuyo comportamiento describen.
Transiciones que no se resuelven a dos estadosCorrija 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ónSe 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ónLML no tiene enumeraciones; los valores de atributo se conservan como texto.
Cálculos, casos de análisis, preocupacionesLML no tiene cálculos, casos de análisis ni preocupaciones de las partes interesadas.
Vistas y puntos de vistaLos diagramas se dibujan de nuevo en la copia LML.
Acciones de asignación, if, send y acceptLas acciones LML no tienen sentencias.
DependenciasLML no tiene dependencia genérica.
Asignaciones (allocations)Use perform en el texto para las acciones que realizan las partes.
MetadatosLML no tiene metadatos.
OcurrenciasLML no tiene ocurrencias.
Casos de uso incluidosLas relaciones include entre casos de uso no se convierten.
AliasLas 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.
EspecializacionesLML no tiene especialización; las partes reciben copiadas las características de sus definiciones generales.
RedefinicionesLa característica que redefine sustituye a la heredada en cada parte copiada.
Subconjuntos (subsettings)LML no tiene subsetting.
ImportacionesLML no tiene espacios de nombres; cada entidad es visible en el proyecto.
Definiciones como algo distinto de los usosLML 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 partesSolo las multiplicidades de partes tienen lugar en LML (la Multiplicity de decomposed by).
Valores de atributosLos valores se conservan como texto en el Value de cada characteristic; las unidades y expresiones no se evalúan.
Líneas baseLas líneas base del proyecto SysML v2 no se aplican a la copia LML; empieza sin líneas base.
HistorialEl historial de cambios empieza de cero en la copia.
Solicitudes de cambioLas 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

MensajeSignificado 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.

SysML® y OMG® son marcas registradas de Object Management Group, Inc. en los Estados Unidos y otros países.