Holarch

De SysML v1 para SysML v2

Leve seu modelo SysML v1 para o SysML v2 sem redesenhá-lo.

Solte um modelo SysML v1 salvo como XMI (.xmi, .xml, .uml) ou como arquivo de projeto .mdzip em um projeto SysML v2. O Holarch o converte em texto SysML v2, checa o texto e informa cada elemento como convertido, aproximado ou deixado de fora, com o motivo, antes de qualquer importação.

O conversor faz parte de todos os planos, inclusive o Free. Novas contas começam uma avaliação de 30 dias do Individual no primeiro login: 10.000 itens por projeto, sem cartão, de volta ao Free quando termina. Já tem uma conta? Comece a avaliação.

Prova: o modelo CubeSat EO-1

ResultadoElementos
Convertidos1,007
Aproximados32
Deixados de fora3
Elementos lidos1,042
Problemas no texto SysML v20

O texto convertido é checado sem erros e sem avisos, e o mesmo modelo é convertido no mesmo texto todas as vezes. O que foi aproximado e deixado de fora

Importar um modelo SysML v1

Importe o arquivo XMI ou o projeto .mdzip de um modelo SysML v1 em um projeto SysML v2. Antes de qualquer coisa ser criada, um relatório de conversão lista cada elemento como convertido, aproximado ou deixado de fora, com o motivo, e é salvo como arquivo CSV. O exemplo é o modelo CubeSat EO-1: 1.042 elementos, importados sem problemas.

Importar um modelo SysML v1 na página de Vídeos

O que você obtém do conversor

Um modelo SysML v2 com que você pode trabalhar e uma lista clara do que revisar.

Sem redesenhar

Os blocos viram part defs, portas, conectores e fluxos de itens são trazidos, os requisitos mantêm seus ids e textos, e os relacionamentos satisfy, verify e allocate continuam rastreados.

Um relatório de cada elemento

Cada elemento do modelo v1 é listado com seu tipo na v1, seu resultado, o nome SysML v2 que recebeu e, para tudo o que foi aproximado ou deixado de fora, o motivo por extenso. Filtre-o na tela ou baixe-o como CSV.

Checado antes de você importar

O mesmo motor que checa o Editor SysML v2 enquanto você digita checa o texto convertido. Você vê primeiro o resultado, o texto e o relatório; a importação é uma única etapa de desfazer.

Reimporte à medida que o modelo v1 muda

Os elementos recebem seus ids a partir dos ids XMI do modelo v1. Importe uma exportação mais recente no mesmo projeto e os elementos são atualizados no lugar, também quando foram renomeados ou movidos, com seus layouts de diagrama, comentários, vínculos e histórico.

Um modelo com que você pode trabalhar

O Editor, as visões, os requisitos, a verificação e as outras páginas de um projeto SysML v2 leem o modelo convertido como qualquer outro.

Seu modelo v1 continua como está

O Holarch lê uma exportação dele e nunca grava de volta, então o modelo v1 continua sendo a referência enquanto a equipe revisa a versão SysML v2.

Como funciona

  1. Solte o arquivo. Em um projeto SysML v2, clique em Modelo → Importar e exportar, escolha Neste projeto ou Em um projeto SysML v2 novo e solte o arquivo .mdzip, .xmi, .uml ou .xml. Um cartão de progresso mostra a leitura, a conversão e a checagem.
  2. Revise o relatório. Conversão do SysML v1 traz as contagens, diz se o texto é checado sem problemas e lista os elementos aproximados e deixados de fora com o motivo de cada um. Mostrar o texto SysML v2 abre o resultado; baixe o relatório ou o arquivo .sysml para guardá-los.
  3. Importe. Desmarque os pacotes que você não quer e importe. Um único Desfazer remove a importação inteira de novo.

Passo a passo, com as configurações de exportação de cada ferramenta: Importar modelos SysML v1 nos Docs, e o guia de migração para planejar a mudança de um programa inteiro.

Um bloco convertido

part def Rover {
  @SysMLv1Library::BlockData { isEncapsulated = true; }
  part battery : Battery;
  part computer : Computer;
  attribute 'power budget' : Types::Power = 120 [SI::W];
  connection 'power bus' connect battery.'out' to computer.'in';
  satisfy Requirements::'Power Margin' by battery;
  flow 'power flow' of Types::Charge from battery.'out' to computer.'in';
}

Saída do conversor para um bloco encapsulado com duas partes, uma propriedade de valor em watts, um conector entre portas proxy com um fluxo de itens e um relacionamento satisfy. O guia de migração mostra o pequeno modelo inteiro, antes e depois.

O que ele lê

  • SysML v1 como XMI 2.x: UML 2.5 com o perfil SysML 1.x.
  • .xmi: um arquivo XMI.
  • .xml: XMI salvo com a extensão .xml.
  • .uml: um arquivo de modelo XMI.
  • .mdzip: um arquivo de projeto compactado que contém o modelo como XMI; o Holarch lê o XMI que está dentro.
  • Outros formatos de projeto: uma ferramenta que guarda os modelos no seu próprio formato de projeto exporta o modelo como XMI primeiro.

Um arquivo por importação, até 64 MB, 250.000 elementos e 512 níveis de aninhamento.

O que sai

  • Texto SysML v2 no projeto aberto ou em um novo projeto SysML v2, importado como uma única etapa de desfazer.
  • Uma checagem do texto, exibida antes de você importar.
  • Um relatório de conversão de cada elemento, filtrável na tela e disponível para download como CSV.
  • O arquivo .sysml para baixar, para revisão ou para outra ferramenta SysML v2.

A conversão se baseia na transformação de SysML v1 para SysML v2 da especificação OMG SysML 2.0.

Convertido, aproximado ou deixado de fora

Cada elemento do modelo v1 recebe um de três resultados, para que você saiba exatamente onde olhar.

Convertidos

O elemento tem uma contrapartida direta no SysML v2. Um bloco vira uma part def, um bloco de interface uma port def, e um requisito mantém seu id e seu texto.

Aproximados

O elemento é mantido em forma alterada. Uma porta completa tipada por um bloco de interface vira uma porta; uma transição por uma escolha vira uma transição por caminho; uma unidade que não é uma unidade SI mapeada vira um número real com a unidade na sua documentação.

Deixados de fora

O SysML v2 não tem contrapartida, ou o elemento aponta para algo que não está no arquivo. Exemplos são nós finais de fluxo, partições de atividade, extensões de caso de uso e relacionamentos com elementos sem nome.

As propriedades do SysML v1 sem palavra-chave no SysML v2, como um bloco encapsulado, uma porta completa ou um relacionamento refine, são mantidas como metadados do pacote SysMLv1Library, que o Holarch carrega em todo projeto SysML v2. Seus próprios estereótipos viram definições de metadados com seus valores marcados, e comportamentos opacos, guardas e restrições mantêm seus corpos como representações textuais, como language "OCL" /* … */.

O que vira o quê

Os principais mapeamentos. Os Docs listam todos.

SysML v1SysML v2
Pacotepackage, aninhado como na v1
Bloco, atorpart def
Tipo de valor, enumeraçãoattribute def, enum def; um tipo de valor com uma unidade SI conhecida especializa a grandeza ISQ
Propriedades de parte, de referência e de valorpart, ref part, attribute, com multiplicidades e valores padrão
Bloco de interface, porta proxy, propriedade de fluxoport def, port, item ou attribute direcionado
Conector, conector de vinculação, fluxo de itensconnect, bind, flow
Atividade, ações, fluxos de controle e de objetosaction def, ações, sucessões com guardas, fluxos entre parâmetros
Máquina de estados, estados, transiçõesstate def, estados, transições com accept, guardas e efeitos
Requisito, satisfy, verify, deriverequirement com seu id e texto, satisfy, verify, conexões de derivação
Allocate, refine, traceallocate; dependency com metadados de SysMLv1Library
Caso de uso, interação, bloco de restriçãouse case def, occurrence def com mensagens, constraint def
Estereótipos e valores marcadosmetadata def por estereótipo, aplicada com suas tags

Um exemplo resolvido: o modelo CubeSat EO-1

O demo CubeSat EO-1 exportado como XMI SysML 1.6 e importado em um novo projeto SysML v2: 1.042 elementos lidos, 1.007 convertidos, 32 aproximados, 3 deixados de fora. O texto SysML v2 é checado sem erros e sem avisos, e o novo projeto abre com a estrutura, as funções, os requisitos e os rastros do satélite. Cada elemento aproximado e deixado de fora, por motivo:

ElementosResultadoMotivo
10 conectoresAproximadosUma extremidade de conector fica dentro de uma parte; o caminho até ela foi deduzido a partir dos tipos das partes.
8 transiçõesAproximados4 gatilhos de mudança e de tempo, como when Undervoltage, são mantidos como documentação; 4 eventos sem sinal, como Contact Start, receberam uma definição de item com esse nome.
6 fluxos de itensAproximadosO nome é usado duas vezes no mesmo lugar; o fluxo foi renomeado com um sufixo.
5 tipos de valorAproximadosA unidade (%, GB, Mbps, mNms, W/m^2) não é uma unidade SI que o Holarch mapeia; o tipo de valor é um número real com a unidade na sua documentação.
2 fluxos de controleAproximadosUm ramo sem guarda ao lado de ramos com guarda; ele recebeu a guarda true.
1 estado finalAproximadosUm estado final virou um estado simples.
1 extensão de caso de usoDeixados de foraO SysML v2 não tem extensões de caso de uso.
2 relacionamentos traceDeixados de foraEles apontam para elementos sem nome, aos quais o texto SysML v2 não pode se referir.

O arquivo do EO-1 é a própria exportação SysML 1.6 do Holarch, então usa a parte do SysML v1 que o Holarch grava. Um modelo de outra ferramenta normalmente usa mais da linguagem, e seus números serão diferentes: o relatório do seu próprio modelo é a medida que conta, e você o vê antes de qualquer importação. Os modelos de teste do Holarch, escritos nas formas de XMI de várias ferramentas SysML v1, também são convertidos em texto checado sem problemas, e o mesmo modelo é convertido no mesmo texto todas as vezes.

Perguntas

O que se perde na conversão?

Os diagramas e seu layout não são convertidos: crie visões no projeto SysML v2 para os diagramas que importam. Os elementos sem contrapartida no SysML v2 ficam de fora, como extensões de caso de uso, nós finais de fluxo e partições de atividade, assim como os relacionamentos com elementos sem nome, porque o texto SysML v2 se refere aos elementos pelo nome (dê nome aos elementos que você rastreia antes de exportar). Os elementos aproximados são mantidos em forma alterada; é neles que o significado pode diferir do modelo v1, então revise-os primeiro. O relatório nomeia cada um deles, com o motivo.

O modelo convertido está pronto para uso?

Ele é checado sem problemas e todas as páginas de um projeto SysML v2 funcionam com ele, mas trate-o como ponto de partida. Algumas diferenças entre as linguagens merecem uma decisão de modelagem, não apenas uma tradução. O que os projetos SysML v2 suportam, e as lacunas conhecidas: Cobertura da linguagem SysML v2.

Qual o tamanho do modelo que posso converter?

Um arquivo de no máximo 64 MB, com no máximo 250.000 elementos aninhados em no máximo 512 níveis, e no máximo 8 MB de texto convertido. Exporte um modelo maior um pacote de cada vez. O limite de itens por projeto do seu plano vale para o modelo convertido: 1.000 no Free, 10.000 no Individual e 50.000 no Team. Veja o que conta como item. Para um modelo acima de 10.000 itens, peça uma avaliação do Team.

Posso continuar trabalhando na minha ferramenta SysML v1?

Sim. O Holarch lê uma exportação e nunca altera o modelo v1. Quando o modelo v1 mudar, exporte-o de novo e importe o novo arquivo no mesmo projeto: os elementos recebem seus ids a partir do arquivo XMI, então são atualizados no lugar, também após uma renomeação ou uma movimentação. Elementos com o mesmo nome em um mesmo lugar são renomeados com um sufixo como _2, e o relatório lista cada renomeação.

Para onde vai meu arquivo?

O Holarch lê e converte o arquivo XMI ou .mdzip no seu navegador; o arquivo em si não é enviado. No app.holarch.app, o texto SysML v2 convertido é enviado ao Holarch para preparar a pré-visualização, e só é salvo no seu projeto quando você importa. O serviço hospedado não aceita CUI nem material sujeito a controle de exportação; para isso, o Holarch roda no seu próprio ambiente (Enterprise). Mais em Segurança.

E os requisitos mantidos em uma ferramenta de gerenciamento de requisitos?

Eles trafegam como ReqIF (.reqif, .reqifz), o formato padrão de intercâmbio de requisitos. O Holarch importa e exporta ReqIF em projetos LML e SysML v2. Em um projeto SysML v2, um arquivo ReqIF vira requisitos, definições de requisitos e pacotes, com um relatório do que foi convertido, e os requisitos são exportados de volta com seus identificadores originais. No nosso ciclo de ida e volta do demo CubeSat EO-1 do Holarch para ReqIF e de volta, todos os 407 itens e 979 valores de atributos voltaram inalterados. ReqIF em projetos LML · ReqIF em projetos SysML v2

Quanto custa o conversor?

Nada a mais: ele faz parte de todos os planos, inclusive o Free. Os planos diferem em itens por projeto e no que incluem além da modelagem; veja Preços.

Vai incluir uma migração na sua própria ferramenta?

O conversor faz parte do Holarch Language Engine, o motor por trás dos projetos SysML v2 do Holarch, e é licenciado para fornecedores de ferramentas e integradores como o complemento de migração. É o mesmo conversor que roda no Holarch.

  • Seu produto lê o arquivo XMI, o motor converte: envie o modelo v1 como JSON na forma neutra documentada e receba de volta o texto SysML v2, a checagem dele feita pelo motor e o relatório de cada elemento com um código de motivo estável e o nome SysML v2 que recebeu, em JSON.
  • Roda onde seu produto roda: no navegador como WebAssembly em um Web Worker, ou no seu servidor pelo Node.js ou pela extensão Python com uso em servidor.
  • Repetível e limitado: o mesmo modelo é convertido no mesmo texto todas as vezes; modelos de até 250.000 elementos, e um maior recebe uma resposta de erro, nunca um travamento.
  • Ativado pelo seu token de licença, sem recompilação e sem alteração de código. A avaliação gratuita de 60 dias roda no seu próprio computador, com a documentação e os exemplos.

Uma requisição e sua resposta

// Request (the model shortened)
{ "op": "v1_convert",
  "model": { "format": "holarch-xmi-model", … } }

// Answer (shortened)
{ "text": "package 'Rover Model' { … }",
  "diagnostics": [],
  "report": {
    "summary": { "elements": 31, "converted": 27,
                 "approximated": 2, "dropped": 2 },
    "items": [ { "kind": "Association",
                 "status": "dropped",
                 "reason": "association" }, … ] } }

A requisição v1_convert na referência da API do motor. O motor também oferece simulação e uso em servidor como complementos.

Veja seu próprio modelo em SysML v2.

Converta-o, leia o relatório e importe só quando estiver satisfeito.

Novas contas começam uma avaliação de 30 dias do Individual no primeiro login: 10.000 itens por projeto, sem cartão, de volta ao Free quando termina. Já tem uma conta? Comece a avaliação em Ajustes da conta → Plano e cobrança.