Holarch

SysML v2

Importação de modelos SysML v1

Converta um modelo SysML 1.x do Cameo, MagicDraw, Enterprise Architect, Rhapsody ou Papyrus em texto SysML v2, revise o que mudou de forma e importe-o para um projeto SysML v2.

Como usá-lo →

Nesta página
  1. Visão geral
  2. Conceitos
    1. Convertido, aproximado e deixado de fora
    2. O pacote SysMLv1Library
    3. Corpos opacos se tornam representações textuais
  3. Como usá-lo
    1. Quando e por quê
    2. Importar um modelo SysML v1 em um projeto
    3. Importar uma versão mais recente do mesmo modelo
    4. Guardar o relatório e o texto
    5. Exportar o modelo da sua ferramenta SysML v1
  4. Exemplo prático: o modelo CubeSat EO-1
  5. Dicas e erros comuns
  6. O que é convertido
  7. Limites
  8. Mensagens
  9. Páginas relacionadas

Visão geral

Você pode trazer um modelo SysML 1.x para um projeto SysML v2. O Holarch lê o arquivo XMI do modelo, converte-o em texto SysML v2, checa o texto e mostra um relatório de conversão antes de qualquer mudança.

  • Entrada: um modelo SysML 1.x como XMI (.xmi, .uml, .xml) ou um projeto do Cameo ou MagicDraw (.mdzip).
  • Saída: texto SysML v2 no seu projeto (um único Desfazer reverte tudo) ou um novo projeto SysML v2.
  • Relatório: cada elemento v1 com seu resultado: Convertido, Aproximado ou Deixado de fora, e o motivo.

A conversão segue a transformação de SysML v1 para SysML v2 da especificação OMG SysML 2.0, onde um modelo trocado como XMI traz detalhes suficientes para isso.

Conceitos

Convertido, aproximado e deixado de fora

Cada elemento do modelo v1 recebe um resultado:

  • Convertido: o elemento tem uma contrapartida direta em SysML v2, como um bloco que se torna uma part def.
  • Aproximado: o elemento é mantido de forma alterada. Por exemplo, uma full port tipada por um interface block se torna uma port, e uma transição por um pseudoestado choice se torna uma transição por caminho.
  • Deixado de fora: o SysML v2 não tem equivalente, ou o elemento aponta para algo que não está no arquivo. Exemplos são flow final nodes, partições de atividade, extensões de caso de uso e instance specifications.

O relatório dá, em palavras, o motivo de cada elemento aproximado ou deixado de fora.

O pacote SysMLv1Library

Algumas propriedades do SysML v1 não têm palavra-chave no SysML v2, como o isEncapsulated de um bloco ou um relacionamento refine. O conversor as mantém como metadados do pacote SysMLv1Library, por exemplo @SysMLv1Library::RefineData { isRefine = true; }. O pacote faz parte da biblioteca do Holarch, então esses nomes são resolvidos em todo projeto SysML v2.

Corpos opacos se tornam representações textuais

Opaque behaviors, opaque actions, guards e constraint specifications trazem texto em uma linguagem como OCL ou inglês. O conversor mantém cada corpo como uma representação textual: language "OCL" /* … */. Corpos em SysML ou KerML são checados como o resto do texto. Consulte Representações textuais.

Como usá-lo

Quando e por quê

Use a importação quando uma equipe migra um modelo SysML 1.x existente para SysML v2, ou quer reutilizar partes de um. O texto convertido é um ponto de partida: o relatório diz o que revisar manualmente.

Importar um modelo SysML v1 em um projeto

  1. Abra um projeto SysML v2 e clique em Modelo → Importar e exportar.
  2. Em Importar, escolha Neste projeto ou Em um projeto SysML v2 novo.
  3. Solte o arquivo .xmi, .uml, .xml ou .mdzip na caixa, ou clique na caixa para escolhê-lo. Você vê um cartão de progresso com as fases Lendo o arquivo XMI…, Convertendo para SysML v2… e Checando o resultado….
  4. Leia Conversão do SysML v1 no topo da pré-visualização. Ela informa o número de elementos convertidos, aproximados e deixados de fora, e se o texto SysML v2 passa nas checagens sem problemas.
  5. Use Mostrar para listar os elementos aproximados e deixados de fora, apenas um desses grupos, ou todos os elementos. Cada linha dá o elemento, seu tipo no SysML v1, o resultado com a palavra-chave e o nome qualificado no SysML v2, e Por quê.
  6. Abra Mostrar o texto SysML v2 para ler o resultado antes de importá-lo.
  7. Desmarque na tabela abaixo os pacotes que você não quiser e clique em Importar N pacotes (ou Criar projeto). O modelo é importado, e um único Desfazer reverte tudo. Desfazer o remove de novo.

Importar uma versão mais recente do mesmo modelo

Quando o modelo SysML v1 mudar, exporte-o de novo e importe o novo arquivo no mesmo projeto (Neste projeto). Cada elemento convertido recebe seu id a partir do id do elemento no arquivo XMI (xmi:id), então a importação atualiza os elementos no lugar: um elemento renomeado ou movido para outro pacote na ferramenta SysML v1 continua sendo o mesmo elemento, com seus layouts de diagrama, comentários, vínculos e histórico. O relatório diz quantos elementos recebem seus ids do modelo SysML v1. Elementos sem nome (conectores, sucessões) são correspondidos pela sua posição no modelo.

Um projeto importado de um modelo SysML v1 antes de o Holarch derivar ids do arquivo XMI mantém seus ids: uma exportação mais recente atualiza seus elementos pelo nome, e elementos novos no modelo SysML v1 recebem seus ids dele.

Guardar o relatório e o texto

  • Clique em Baixar relatório para obter um arquivo CSV com cada elemento, seu resultado, seu caminho no SysML v2 e o motivo.
  • Clique em Baixar texto SysML v2 para obter o arquivo .sysml convertido.

Exportar o modelo da sua ferramenta SysML v1

  • Cameo Systems Modeler e MagicDraw: importe o projeto .mdzip diretamente, ou use File → Export To → Eclipse UML2 (v5.x) XMI File e importe o arquivo .xmi.
  • Enterprise Architect: selecione o pacote, escolha Publish → Export XML, selecione XMI 2.1 e importe o arquivo .xml. Arquivos de projeto do Enterprise Architect (.eap, .qea) não podem ser lidos diretamente.
  • IBM Rhapsody: exporte o modelo com o XMI toolkit (XMI 2.x) e importe o arquivo.
  • Eclipse Papyrus: importe o arquivo .uml do modelo.

Exemplo prático: o modelo CubeSat EO-1

A demonstração CubeSat EO-1 é um projeto LML. Sua exportação SysML v1 serve como um modelo de teste realista.

  1. Abra a demonstração CubeSat EO-1 e exporte-a como XMI UML/SysML no formato OMG XMI 2.5.1 (consulte Exportar um modelo UML/SysML (XMI)).
  2. Abra um projeto SysML v2, clique em Modelo → Importar e exportar, escolha Em um projeto SysML v2 novo e solte o arquivo .xmi. O relatório diz: 1.042 elementos, 1.007 convertidos, 32 aproximados, 3 deixados de fora. O texto SysML v2 passa nas checagens sem problemas.
  3. Defina Mostrar como Deixado de fora. As três linhas são uma extensão de caso de uso, que o SysML v2 não tem, e dois relacionamentos trace para elementos sem nome, aos quais o texto SysML v2 não consegue se referir.
  4. Clique em Criar projeto. O novo projeto SysML v2 abre no Editor com a estrutura, as funções, os requisitos e os rastros do satélite.

Dicas e erros comuns

  • Importe um arquivo XMI por vez, sem outros arquivos. Importe um arquivo XMI SysML v1 por vez, sem outros arquivos.
  • Dê nome aos elementos que você rastreia. Relacionamentos com elementos sem nome ficam de fora, porque o texto SysML v2 se refere aos elementos pelo nome.
  • Reimporte, não recrie. Importe uma exportação mais recente no mesmo projeto em vez de em um novo: os elementos mantêm seus ids apenas dentro do projeto que os tem.
  • Confira as aproximações primeiro. São os pontos em que o significado pode diferir do modelo v1, como portas tipadas por blocos ou extremidades de conectores dentro de parts.
  • Elementos com o mesmo nome no mesmo lugar são renomeados com um sufixo como _2. O relatório lista cada renomeação.
  • Requisitos mantidos em uma ferramenta de requisitos (DOORS, Polarion, Jama, codebeamer) chegam como ReqIF, não como XMI. Importe o arquivo .reqif na mesma página: ele se torna requisitos SysML v2 com o mesmo tipo de relatório (Importar e exportar requisitos ReqIF).

O que é convertido

SysML v1SysML v2
Modelo, pacotepackage
Bloco, atorpart def
Value type, data type, enumeraçãoattribute def, enum def (value types com uma unidade SI conhecida especializam a grandeza ISQ)
Sinalitem def
Interface blockport def
Propriedades de parte, de referência e de valorpart, ref part, attribute, com multiplicidades e valores padrão
Proxy port, flow propertyport, item ou attribute in/out
Full portpart com @SysMLv1Library::PortData
Conector, conector de vinculação, fluxo de itensconnect, bind, flow
Generalização:>
Atividade, call behavior action, pinsaction def, action, parâmetros
Fluxos de controle e de objetos, guardssucessões com guards if e else, fluxos entre parâmetros
Initial, final, decision, merge, fork, joinstart, done, decide, merge, fork, join
Máquina de estados, estados, regiõesstate def, state, estados paralelos
Transições, gatilhos de sinal e de tempotransition com accept, accept after, guards e efeitos
Interaçãooccurrence def com linhas de vida e mensagens
Caso de uso, subject, includeuse case def, subject, include
Requisito (id e texto)requirement <'id'> Name { doc /* text */ }
Satisfy, verify, derive requirementsatisfy, verify em um objetivo de verificação, conexão de derivação
Refine, tracedependency com metadados SysMLv1Library
Allocate, dependencyallocate, dependency
Constraint block, constraintconstraint def, assert constraint
Estereótipos e valores marcadosmetadata def por estereótipo, aplicada com suas tags
Comentário, documentaçãodoc, comment

Limites

  • Um arquivo de no máximo 64 MB.
  • No máximo 250.000 elementos, aninhados em no máximo 512 níveis. Um modelo aninhado mais fundo, ou com um ciclo de posse, não é importado.
  • No modelo convertido, elementos aninhados em mais de 128 níveis ficam de fora com o motivo nesting.
  • O texto convertido tem no máximo 8 MB.
  • Diagramas e seu layout não são convertidos. Crie vistas no projeto SysML v2.

Mensagens

MensagemO que fazer
Importe um arquivo XMI SysML v1 por vez, sem outros arquivos.Importe o arquivo XMI sozinho.
<arquivo> não contém elementos UML ou SysML. Exporte o modelo como XMI 2.x e importe-o de novo.Exporte o modelo de novo como XMI 2.x.
Nenhum modelo UML foi encontrado em <arquivo>. No Cameo ou MagicDraw, exporte o modelo como Eclipse UML2 XMI e importe o arquivo .xmi.Exporte o projeto como XMI.
O modelo SysML v1 tem mais de 250.000 elementos. Exporte uma parte menor do modelo.Exporte um pacote por vez.
O texto SysML v2 convertido teria mais de 8 MB. Exporte uma parte menor do modelo.Exporte um pacote por vez.

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