Holarch

SysML v2

Conversão entre LML e SysML v2

Faça uma cópia SysML v2 de um projeto LML, ou uma cópia LML de um projeto SysML v2, com um relatório do que é convertido e do que não é.

Como usá-lo →

Nesta página
  1. Visão geral
  2. Conceitos
    1. Uma cópia, não uma mudança de tipo
    2. Como as duas linguagens se correspondem
    3. Os dados do Holarch vêm junto
    4. O que não é convertido
  3. Como usá-lo
    1. Quando e por quê
    2. Criar uma cópia convertida
    3. Conferir a cópia
    4. Exemplo prático: a demonstração Hybrid Car como cópia LML
    5. Dicas e boas práticas
    6. Erros comuns
  4. Referência do relatório
    1. LML para SysML v2
    2. SysML v2 para LML
    3. CSV do relatório
  5. Mensagens
  6. Limites
  7. Páginas relacionadas

Visão geral

O tipo de um projeto, LML ou SysML v2, é definido quando você o cria. Para trabalhar em um modelo LML em SysML v2, ou em um modelo SysML v2 com páginas LML, crie uma cópia convertida:

  • Criar uma cópia SysML v2… em um projeto LML grava seu modelo como texto SysML v2 em um novo projeto SysML v2.
  • Criar uma cópia LML… em um projeto SysML v2 transforma seu modelo em entidades e relacionamentos LML em um novo projeto LML.

O projeto original nunca é alterado. Antes de a cópia ser criada, um relatório lista o que é convertido, com contagens, e o que não é, com o motivo. O mesmo relatório é salvo no novo projeto.

Conceitos

Uma cópia, não uma mudança de tipo

A conversão sempre cria um projeto novo. Você pode continuar trabalhando no original e converter de novo depois; cada conversão cria outro projeto novo. Nada liga a cópia de volta ao original.

Como as duas linguagens se correspondem

LML e SysML v2 descrevem muitas das mesmas coisas de formas diferentes. A conversão usa esta correspondência nas duas direções:

LMLSysML v2
AssetDefinição de part, com um uso de part onde quer que seja usada
Decomposição de um Asset (decomposed by)Uso de part na definição do pai
PortUso de port
Characteristic de um AssetUso de attribute
ConduitUso de connection, ou uso de interface quando as duas extremidades são ports
Input/OutputDefinição de item, com parâmetros de item in e out e fluxos
Requirement (Number, Name, Description)Uso de requirement (nome curto, nome, doc)
satisfied bysatisfy
Test CaseUso de verification com um objetivo verify
Test SuitePacote de casos de verificação
Action, com seu fluxoUso de action com sucessões
Blocos SYNC e paralelosFork e join
ORDecide e merge
LOOPAção de laço
performed byperform
Characteristics de estado e transiçõesDefinição de state com transições, que a part exibe
Equation e suas variáveisDefinição de constraint com seus parâmetros

Os dados do Holarch vêm junto

Alguns dados não têm lugar em nenhuma das linguagens. São dados do Holarch, e são copiados com seus vínculos:

  • Riscos, decisões, tarefas, custos, cronogramas, problemas, documentos e quadros brancos são copiados e permanecem vinculados aos elementos convertidos.
  • O status dos requisitos e os métodos de verificação ficam com cada requisito; os resultados de teste ficam com cada caso de teste. Estados personalizados dos workflows de classe também são mantidos.
  • As mudanças no esquema passam nas duas direções, incluindo workflows de classe com seus estados, estados desativados, transições e aprovadores.
  • Os comentários de discussão acompanham seu elemento.
  • As probabilidades de ramo das decisões ficam com seus ramos, para o Simulador.
  • Uma cópia LML feita a partir de uma cópia SysML v2 recebe de volta os atributos e rótulos LML que a primeira conversão manteve.

O que não é convertido

  • Layouts de diagramas. Vistas e diagramas são desenhados do zero na cópia.
  • Histórico, linhas de base e solicitações de mudança. A cópia começa sem eles.
  • Elementos para os quais uma das linguagens não tem lugar, como Measures e Resources do LML, ou enumerações, cálculos e casos de análise do SysML v2.

O relatório nomeia cada um desses itens e dá o motivo. Consulte Referência do relatório.

Como usá-lo

Quando e por quê

Converta quando a linguagem do projeto não servir mais para o trabalho:

  • LML para SysML v2: sua equipe ou um cliente agora trabalha em SysML v2, ou o modelo precisa ser trocado com ferramentas SysML v2. Converta e depois exporte .sysml ou JSON (consulte Troca de modelos SysML v2).
  • SysML v2 para LML: você precisa de uma página ou um diagrama LML que os projetos SysML v2 não têm, ou quer o modelo na forma de ciclo de vida do Holarch para uma revisão.

Converta quando o modelo estiver estável e leia o relatório antes de confiar na cópia.

Criar uma cópia convertida

  1. Em Gerenciar projetos, clique em ⋯ na linha do projeto.
  2. Escolha Criar uma cópia SysML v2… (para um projeto LML) ou Criar uma cópia LML… (para um projeto SysML v2).

    O Holarch checa a conversão; em um projeto grande, uma barra de progresso na parte inferior da janela diz "Checando a conversão…". Depois a caixa de diálogo abre com o relatório.

  3. Leia o relatório:
    • Convertido lista cada tipo de item, quantos há e no que ele se torna, por exemplo "Requisitos 24 usos de requirement".
    • Não convertido lista cada tipo de item que não é convertido, quantos são e por quê.
  4. Clique em Baixar relatório (CSV) para salvar o relatório com uma linha por item, se você precisar dele fora do Holarch.
  5. Digite o Nome do novo projeto. Por padrão, é o nome do original seguido de "(SysML v2)" ou "(LML)".
  6. Clique em Criar cópia.

    A notificação diz "Criado "<nome>"". A cópia abre na sua página Início.

  7. Abra o documento Conversion report na cópia. Ele lista cada item que não foi convertido, por número e nome.

Conferir a cópia

  1. Em uma cópia SysML v2, abra Modelo → Editor.

    O modelo é um pacote de nível superior com o nome do projeto. Ele contém os pacotes Architecture, System, Items, Requirements, Verification, Behavior, Constraints e Views (apenas os que têm conteúdo).

  2. Procure marcas de problema na margem. Se o texto convertido tiver problemas, a caixa de diálogo já avisou antes de você criar a cópia: "O texto convertido tem N problemas. A cópia os mostra no Editor."
  3. Abra as vistas em Vistas (Architecture Overview, System Connections) para ver a estrutura desenhada do zero.
  4. Em uma cópia LML, abra o Banco de dados e os diagramas para conferir os Assets, Requirements e fluxos de ações.

Exemplo prático: a demonstração Hybrid Car como cópia LML

Crie primeiro a demonstração: em Gerenciar projetos, clique em Arquivos de projeto ▾ → Novo projeto de demonstração → Hybrid Car (SysML v2).

  1. Em Gerenciar projetos, clique em ⋯ em Hybrid Car (SysML v2 demo) e escolha Criar uma cópia LML…. A cópia se chamará "Hybrid Car (SysML v2 demo) (LML)".
  2. Leia o relatório.

    Em Convertido: usos de part se tornam Assets, usos de port se tornam Ports, atributos se tornam Characteristics, usos de connection e de interface se tornam Conduits, usos e definições de requirement se tornam Requirements, usos de verification se tornam Test Cases, ações se tornam Actions, e estados e transições se tornam seus equivalentes LML.

    Em Não convertido, entre outros:

    • Especializações: o LML não tem especialização; as parts recebem uma cópia das features das suas definições gerais. SportCar :> Car é uma delas.
    • Redefinições: a feature que redefine substitui a herdada em cada part copiada. A bateria do sedã é copiada com 48 kg.
    • Enumerações (DriveMode, FuelKind): os valores de atributos são mantidos como texto.
    • Cálculos (PowerToWeight, ElectricRange) e casos de análise (PowerToWeightAnalysis).
    • Conectores de binding (bind output = transmission.output;): o LML não tem binding entre features.
    • Valores de atributos: mantidos como texto no Value de cada Characteristic; unidades e expressões não são avaliadas.
    • Vistas: os diagramas são desenhados do zero na cópia LML.
  3. Clique em Criar cópia.

    A cópia LML abre. fleet.sedan e suas parts são Assets; o requisito Sedan Mass (VR-1.1) é um Requirement satisfeito pelo Asset do sedã. Os riscos, decisões e tarefas da demonstração também são copiados, vinculados aos elementos convertidos.

Para testar a outra direção, crie a demonstração CubeSat EO-1 (um projeto LML) e escolha Criar uma cópia SysML v2… nela.

Dicas e boas práticas

  • Organize um projeto LML antes de converter: conecte cada Conduit a exatamente dois Assets ou Ports, ligue cada Characteristic a um Asset ou a uma Equation e remova Test Suites vazias. Caso contrário, eles são relatados como não convertidos.
  • No LML, escreva os rótulos dos ramos de OR como expressões booleanas sobre valores do modelo (como speed > 3) se quiser que eles se tornem guards. Outros rótulos se tornam comentários doc nas sucessões.
  • No SysML v2, dê aos atores um tipo de definição de part e aos parâmetros de item um tipo de definição de item. Os que não têm tipo não são convertidos.
  • Guarde o original. Converta de novo a partir dele após mudanças maiores, em vez de editar os dois projetos em paralelo.

Erros comuns

  • Esperar que o original mude. Ele não muda. A cópia é um projeto separado.
  • Esperar que os diagramas mantenham o layout. Os layouts não são convertidos; organize de novo as novas vistas ou diagramas.
  • Parts ausentes em uma cópia LML. Uma definição de part que nenhuma part usa não tem Asset no LML, porque o LML só tem instâncias. Use a definição em uma part e converta de novo.
  • Um item "does not resolve" no relatório. Um nome no texto SysML v2 não aponta para nada. Corrija o nome no Editor e converta de novo.

Referência do relatório

LML para SysML v2

Os itens convertidos incluem Assets (definições de part com seus usos de part), Characteristics (atributos), Ports, Conduits (connections ou interfaces), Input/Outputs (definições de item), Requirements, Actions e casos de uso, fluxos de itens entre ações, States, Transitions, Equations (definições de constraint), Performs, suítes de testes, Test Cases, Verifies, Satisfies e itens do Holarch (copiados com seus vínculos): artefatos, declarações, tarefas, riscos, itens de cronograma, custos, problemas, decisões, perigos e modos de falha. Os workflows de classe (as mudanças no esquema do projeto) passam com seus estados personalizados, transições e aprovadores, de modo que requisitos e casos de teste mantêm seus valores de Status personalizados. A cópia mantém as chaves Programa formal e Segurança e confiabilidade do projeto.

Não convertidoMotivo
Assets em um laço de decomposiçãoUm asset que contém a si mesmo não tem lugar em uma árvore de parts. Sua definição de part é convertida; ela não é usada como part.
Conduits sem exatamente duas extremidadesUma connection SysML une duas extremidades. Conecte o conduit a dois assets ou ports e converta de novo.
Itens que um conduit transfereAs connections nesta conversão não transportam itens. Os itens são convertidos como definições de item e fluxos entre ações.
Conduits decompostos em outros conduitsAs connections SysML não são aninhadas aqui; cada conduit se torna sua própria connection.
Contagens e scripts de laçoUm laço SysML aqui se repete até uma condição; a contagem é mantida como dados do Holarch e restaurada por Criar uma cópia LML.
Rótulos e probabilidades dos ramos de decisãoQuando todo rótulo de uma decisão é uma expressão booleana sobre valores do modelo, os rótulos se tornam seus guards; caso contrário, se tornam comentários doc nas sucessões. As probabilidades são mantidas como dados do Holarch para o Simulador, e ambos são restaurados por Criar uma cópia LML.
Itens OR, SYNC e LOOPAs construções são convertidas como nós decide/merge, fork/join e loop; os itens que as nomeavam não são mantidos.
Ações entry, do e exit dos estadosAs ações são convertidas como ações; os corpos dos estados SysML não são preenchidos por esta conversão.
Transições sem dois estados de uma mesma máquinaUma transição SysML une dois estados da mesma definição de state.
Guards e gatilhos de transiçõesEles são escritos no LML como texto livre; são mantidos como dados do Holarch, não como expressões SysML, e restaurados por Criar uma cópia LML.
Estados não especificados por um assetUm estado precisa do asset cujo comportamento ele descreve.
Expressões de equaçõesAs expressões usam nomes que não são features SysML; cada uma é mantida como comentário na sua definição de constraint.
Suítes de testes sem casos de testeUma suíte se torna o pacote dos seus casos de verificação; uma suíte vazia não tem nada a conter.
Casos de teste que verificam algo que não é um requisitoUm caso de verificação SysML verifica apenas requisitos.
Ciclos de testeAs execuções de teste registradas em uma suíte não fazem parte do modelo; o resultado mais recente de cada caso é mantido.
Requisitos satisfeitos por outros tipos de itensPor exemplo, um requisito não satisfaz outro requisito no SysML; use derivação no texto.
Outros relacionamentosEsta conversão não tem relacionamento SysML para eles; o relatório nomeia cada um.
MeasuresMedidas de efetividade não têm elemento SysML nesta conversão.
ResourcesAs quantidades de recursos (consumes, produces) pertencem ao simulador LML e não têm elemento SysML aqui.
Characteristics não ligadas a um asset ou a uma equationUm atributo precisa de um dono: especifique-o por um asset ou faça dele uma variável de equação.
Itens de outras classesEsta classe não tem elemento SysML nem lugar do Holarch em um projeto SysML v2.
Características e configuraçõesAinda não: as características e configurações de uma linha de produtos não se tornam pontos de variação, variantes e configurações SysML v2. O relatório as lista como itens Feature e itens Configuration; modele as variantes de novo na cópia (consulte Variantes e configurações SysML v2).
Linhas de baseAs linhas de base do projeto LML não se aplicam ao novo modelo; a cópia começa sem linhas de base.
HistóricoO histórico de mudanças começa do zero na cópia.
Solicitações de mudançaAs solicitações de mudança LML propõem mudanças em itens LML, que a cópia não tem.
Layouts de diagramasOs diagramas são desenhados do zero como vistas SysML v2; as posições não são transferidas.
Itens convertidos em estruturas de documentosOs documentos são copiados; os requisitos e outros itens do modelo nas suas estruturas agora são elementos SysML e aparecem no modelo, não na estrutura.

SysML v2 para LML

Cada uso de part se torna um Asset, com uma cópia das parts, ports e atributos da sua definição (e das definições que ela especializa). As redefinições substituem o que redefinem. Connections e interfaces se tornam Conduits entre esses Assets. Requisitos, casos de verificação, satisfy, verify, perform, parâmetros de item, estados e transições voltam a se corresponder como na tabela acima. As sucessões se tornam fluxos de ações; os guards de uma decisão (ou os comentários doc das suas sucessões) se tornam os rótulos dos ramos de OR, com suas probabilidades. As mudanças no esquema do projeto passam, incluindo workflows de classe com seus estados personalizados, transições e aprovadores, de modo que requisitos e casos de teste mantêm seus valores de Status personalizados.

Não convertidoMotivo
Connections com extremidades que não se resolvemCorrija os nomes das extremidades no texto e converta de novo.
Connections dentro de definições que nenhuma part usaCada connection se torna um conduit entre as parts de cada part que a tem; nada usa esta definição.
Conectores de bindingO LML não tem binding (igualdade) entre features.
Relacionamentos verify que não se resolvemCorrija o nome do requisito no objetivo de verificação e converta de novo.
Parâmetros de item sem definição de itemTipe o parâmetro com um item def para convertê-lo.
Atores sem definição de part no modeloTipe o ator com um part def para convertê-lo.
Usos de perform que não se resolvem em uma action e uma partExecute uma action a partir de uma definição de part ou de um uso de part e converta de novo.
Relacionamentos satisfy que não se resolvemCorrija os nomes na declaração satisfy e converta de novo.
Sucessões que não são um fluxo estruturadoOs fluxos de ações LML são sequências com blocos paralelos, de decisão e de laço; outros grafos de sucessões são linearizados.
Definições de state que nenhuma part exibeOs estados são convertidos sem o asset cujo comportamento eles descrevem.
Transições que não se resolvem em dois estadosCorrija os nomes dos estados e converta de novo.
Gatilhos de transição (accept)As transições LML mantêm o gatilho apenas como texto livre; o sinal aceito não é vinculado.
Definições de port, interface e connectionElas são convertidas como Ports e Conduits onde as parts as usam; o LML não tem tipos de port, interface ou connection.
Definições de attribute (value types)As characteristics LML não têm tipos.
Enumerações e valores de enumeraçãoO LML não tem enumerações; os valores de atributos são mantidos como texto.
Cálculos, casos de análise, concernsO LML não tem cálculos, casos de análise nem concerns de stakeholders.
Vistas e viewpointsOs diagramas são desenhados do zero na cópia LML.
Ações assignment, if, send e acceptAs actions LML não têm declarações.
DependênciasO LML não tem dependência genérica.
AlocaçõesUse perform no texto para ações executadas por parts.
MetadadosO LML não tem metadados.
OccurrencesO LML não tem occurrences.
Casos de uso incluídosRelacionamentos include entre casos de uso não são convertidos.
AliasesAs entidades LML têm um nome cada.
Usos de reference (parâmetros de cálculos e casos)O LML não tem parâmetros, exceto variáveis de equações.
EspecializaçõesO LML não tem especialização; as parts recebem uma cópia das features das suas definições gerais.
RedefiniçõesA feature que redefine substitui a herdada em cada part copiada.
SubsettingsO LML não tem subsetting.
ImportaçõesO LML não tem namespaces; toda entidade é visível no projeto.
Definições distintas de usosO LML só tem instâncias: uma definição de part se torna os Assets das parts que a usam, e seu texto vai para as descrições deles.
Multiplicidades que não sejam de partsSó as multiplicidades de parts têm lugar no LML (a Multiplicity de decomposed by).
Valores de atributosOs valores são mantidos como texto no Value de cada characteristic; unidades e expressões não são avaliadas.
Linhas de baseAs linhas de base do projeto SysML v2 não se aplicam à cópia LML; ela começa sem linhas de base.
HistóricoO histórico de mudanças começa do zero na cópia.
Solicitações de mudançaAs solicitações de mudança SysML propõem mudanças de texto que não se aplicam a entidades LML.

CSV do relatório

Baixar relatório (CSV) grava uma linha por tipo de item convertido e uma linha por item que não foi convertido. Suas colunas são Resultado (Convertido ou Não convertido), O quê, Contagem, Torna-se ou motivo, Número e Nome.

Mensagens

MensagemSignificado e correção
Checando a conversão… (barra de progresso)O relatório está sendo preparado.
Este já é um projeto SysML v2. Escolha Criar uma cópia LML….Foi escolhida a direção errada.
Este já é um projeto LML. Escolha Criar uma cópia SysML v2….Foi escolhida a direção errada.
O texto convertido tem N problemas. A cópia os mostra no Editor.A cópia pode ser criada; corrija os problemas no Editor dela.
O texto convertido não é analisável (…). O projeto não foi copiado; relate isso com o arquivo do projeto.A conversão falhou. Entre em contato com o suporte e envie o arquivo do projeto.
O checador SysML não iniciou. Recarregue a página e tente de novo.Recarregue e tente de novo.
Não foi possível ler o projeto. Recarregue a página e tente de novo.Recarregue e tente de novo.
A cópia não foi criada: … Recarregue a página e tente de novo.Recarregue e tente de novo.
Criado "<nome>"A cópia foi criada e aberta.

Limites

  • Layouts de diagramas, histórico, linhas de base e solicitações de mudança não são convertidos.
  • Ainda não: converter uma linha de produtos LML (características e configurações) em variantes SysML v2.
  • O documento do relatório lista até 500 itens por tipo.

SysML® e OMG® são marcas registradas da Object Management Group, Inc. nos Estados Unidos e em outros países.