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.
Nesta página
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
- Abra um projeto SysML v2 e clique em Modelo → Importar e exportar.
- Em Importar, escolha Neste projeto ou Em um projeto SysML v2 novo.
- Solte o arquivo
.xmi,.uml,.xmlou.mdzipna 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…. - 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.
- 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ê.
- Abra Mostrar o texto SysML v2 para ler o resultado antes de importá-lo.
- 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
.sysmlconvertido.
Exportar o modelo da sua ferramenta SysML v1
- Cameo Systems Modeler e MagicDraw: importe o projeto
.mdzipdiretamente, 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
.umldo 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.
- 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)).
- 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. - 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.
- 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
.reqifna 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 v1 | SysML v2 |
|---|---|
| Modelo, pacote | package |
| Bloco, ator | part def |
| Value type, data type, enumeração | attribute def, enum def (value types com uma unidade SI conhecida especializam a grandeza ISQ) |
| Sinal | item def |
| Interface block | port def |
| Propriedades de parte, de referência e de valor | part, ref part, attribute, com multiplicidades e valores padrão |
| Proxy port, flow property | port, item ou attribute in/out |
| Full port | part com @SysMLv1Library::PortData |
| Conector, conector de vinculação, fluxo de itens | connect, bind, flow |
| Generalização | :> |
| Atividade, call behavior action, pins | action def, action, parâmetros |
| Fluxos de controle e de objetos, guards | sucessões com guards if e else, fluxos entre parâmetros |
| Initial, final, decision, merge, fork, join | start, done, decide, merge, fork, join |
| Máquina de estados, estados, regiões | state def, state, estados paralelos |
| Transições, gatilhos de sinal e de tempo | transition com accept, accept after, guards e efeitos |
| Interação | occurrence def com linhas de vida e mensagens |
| Caso de uso, subject, include | use case def, subject, include |
| Requisito (id e texto) | requirement <'id'> Name { doc /* text */ } |
| Satisfy, verify, derive requirement | satisfy, verify em um objetivo de verificação, conexão de derivação |
| Refine, trace | dependency com metadados SysMLv1Library |
| Allocate, dependency | allocate, dependency |
| Constraint block, constraint | constraint def, assert constraint |
| Estereótipos e valores marcados | metadata def por estereótipo, aplicada com suas tags |
| Comentário, documentação | doc, 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
| Mensagem | O 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. |
Páginas relacionadas
- Troca de modelos SysML v2
- Importar e exportar requisitos ReqIF: requisitos do DOORS, Polarion e outras ferramentas de requisitos.
- Notação textual SysML v2
- Conversão entre LML e SysML v2
SysML® e OMG® são marcas registradas da Object Management Group, Inc. nos Estados Unidos e em outros países.