Holarch

SysML v2

Troca de modelos SysML v2

Importe arquivos .sysml, arquivos zip e SysML v2 JSON para um projeto SysML v2 com uma pré-visualização, e exporte o modelo ou um pacote como texto .sysml ou SysML v2 JSON.

Como usá-lo →

Nesta página
  1. Visão geral
  2. Conceitos
    1. Formatos de arquivo
    2. Ids e correspondência
    3. Ids de elementos no texto
    4. Pastas se tornam pacotes
    5. O que a pré-visualização compara
  3. Como usá-lo
    1. Quando e por quê
    2. Importar arquivos para este projeto
    3. Importar arquivos para um novo projeto
    4. Atualizar um pacote a partir de uma nova versão
    5. Renomear e mover elementos no texto mantendo seus ids
    6. Importações grandes no serviço hospedado
    7. Exportar o modelo ou um pacote
    8. Importar e exportar requisitos ReqIF
    9. Obter de um repositório e enviar para ele
    10. Exemplo prático: a demonstração Hybrid Car
    11. Dicas e boas práticas
    12. Erros comuns
    13. Como se conecta a outros recursos
  4. A página Importar e exportar
    1. Importar
    2. Exportar
  5. Repositório
  6. Como os arquivos são lidos
    1. Elementos que o Holarch não interpreta
  7. Mensagens
  8. Limites
  9. Páginas relacionadas

Visão geral

Os projetos SysML v2 trocam modelos com outras ferramentas SysML v2 como arquivos. A página Importar e exportar (Modelo → Importar e exportar) faz as duas coisas:

  • Importar lê arquivos .sysml, um .zip de arquivos .sysml ou um arquivo JSON SysML v2. Ela mostra uma pré-visualização do que muda e depois aplica a este projeto (um único Desfazer reverte tudo) ou cria um novo projeto SysML v2.
  • Exportar grava o modelo inteiro ou um pacote como texto SysML v2 (.sysml) ou como JSON SysML v2 (.json).
  • Arquivos ReqIF (.reqif, .reqifz) de ferramentas de requisitos são importados como requisitos SysML v2, e os requisitos são exportados como ReqIF: consulte Importar e exportar requisitos ReqIF.

Você também pode criar um projeto diretamente a partir de arquivos: em Gerenciar projetos, clique em Arquivos de projeto ▾ → Importar arquivos SysML v2….

Dica: para manter o modelo sincronizado com um repositório de modelos SysML v2 que ofereça a Systems Modeling API, use a seção Repositório da mesma página: consulte Obter de um repositório e enviar para ele.

Conceitos

Formatos de arquivo

FormatoO que ele contémImportarExportar
Texto SysML v2 (.sysml)A notação textual, um arquivo por pacote de nível superior.SimSim
Arquivo zip (.zip)Vários arquivos .sysml. As pastas se tornam pacotes.SimSim, quando vários arquivos são exportados
JSON SysML v2 (.json)Uma lista plana de elementos, cada um com @id e @type, como a Systems Modeling API usa.SimSim
ReqIF (.reqif, .reqifz)Requisitos com seus atributos, hierarquia e relações, vindos do DOORS, Polarion, Jama, codebeamer e outras ferramentas de requisitos.Sim, convertidos em requisitosSim, os requisitos

Arquivos KerML (.kerml) ainda não são importados.

Ids e correspondência

Todo elemento de um projeto SysML v2 tem um id. Os dois formatos o mantêm de formas diferentes:

  • O JSON mantém os ids. Um elemento importado de novo a partir de JSON corresponde ao elemento com o mesmo id.
  • Referências à biblioteca padrão são entendidas. O JSON da Systems Modeling API, da SysML v2 Pilot Implementation ou de outro repositório nomeia os elementos da biblioteca padrão (unidades como ISQ::mass, ScalarValues::Real, Parts::Part) pelos ids padrão. A importação os lê como os mesmos elementos da biblioteca, então unidades e tipos continuam resolvidos.
  • O texto mantém os ids quando você pede. Marque Incluir ids dos elementos ao exportar texto .sysml. Toda definição, uso e pacote nomeado passa então a ter seu id como primeira linha do corpo, @HolarchMetadata::ElementId { id = "…"; }. Quando esse texto é importado de novo, cada elemento com id corresponde ao elemento com o mesmo id, mesmo que tenha sido renomeado, movido para outro proprietário ou outro pacote de nível superior, ou reordenado. Suas posições nos diagramas, comentários, rastros e vínculos permanecem.
  • O texto sem ids é associado pelo nome. O Holarch associa os pacotes de nível superior pelo nome e os elementos dentro deles pelos nomes e posições. Os ids são mantidos onde os elementos correspondem. Um elemento renomeado ainda é associado quando mantém seu lugar; um elemento que foi renomeado e movido ao mesmo tempo se torna um elemento novo.

A exportação informa isso abaixo dos controles de exportação: "Os ids dos elementos são mantidos no JSON. No texto .sysml, marque Incluir ids dos elementos para mantê-los: os elementos então mantêm suas posições nos diagramas, comentários e rastros quando o texto editado é importado de novo, mesmo após uma renomeação ou uma movimentação. Sem ids, os elementos são associados pelo nome."

Ids de elementos no texto

@HolarchMetadata::ElementId { id = "…"; } são metadados SysML v2 comuns: ElementId é uma definição de metadados do pacote de biblioteca próprio do Holarch HolarchMetadata (na Biblioteca padrão, em Holarch), ao lado de TBD e TBR. Outras ferramentas SysML v2 leem a linha como uma anotação de metadados; para resolver seu nome, elas precisam de HolarchMetadata.sysml dessa biblioteca.

  • O id pertence ao elemento cujo corpo contém a linha. Elementos sem nome (conexões, sucessões, comentários) não têm id e são associados pelo seu conteúdo, como antes.
  • O Holarch não mantém a linha como elemento. O Editor mostra o modelo sem essas linhas, e um elemento cujo corpo continha apenas a linha é mostrado como part engine : Engine;.
  • Os ids precisam ser únicos. Quando o mesmo id aparece duas vezes (por exemplo, depois de copiar um bloco no texto), o primeiro elemento o mantém e a cópia se torna um elemento novo.
  • Um id que não é um UUID (por exemplo "R-17") é transformado em um UUID fixo, então a mesma string sempre dá o mesmo elemento, como em uma importação JSON.
  • Um id que o projeto não tem é mantido para o novo elemento. Excluir um elemento no Holarch e importar o texto de novo o traz de volta com seu id antigo.
  • No Editor, uma linha colada funciona dentro do pacote que você está editando: um id que pertence a um elemento de outro pacote é ignorado ali, e o elemento é associado pelo nome. Para mover elementos entre pacotes mantendo seus ids, exporte com ids e importe os arquivos editados.

A definição de part Car da demonstração Hybrid Car tem essa linha no arquivo de origem, então seu id é o mesmo em todas as cópias da demonstração.

Pastas se tornam pacotes

Em um arquivo zip, cada pasta se torna um pacote que contém seus arquivos e subpastas. Um arquivo powertrain/engine.sysml dentro do arquivo zip é lido como se estivesse escrito dentro de package powertrain { … }. Os arquivos no topo do zip são lidos como estão. Pastas e arquivos são lidos em ordem de nome.

O que a pré-visualização compara

A pré-visualização tem uma linha por pacote de nível superior (ou, para um novo projeto, por elemento de nível superior). Cada linha tem um resultado:

ResultadoSignificadoImportado por padrão
NovoO projeto não tem pacote com esse nome (ou id). Ele é adicionado.Sim
AlteradoO projeto tem o pacote; a importação adiciona, altera ou remove elementos nele. O detalhe diz quantos, por exemplo "3 adicionados, 1 alterado (ids mantidos onde os elementos correspondem)".Sim
InalteradoO pacote é igual ao deste projeto.Não (nada a fazer)
ConflitoO pacote não pode ser mesclado. O detalhe diz o motivo e o que fazer.Não

Como usá-lo

Quando e por quê

Use Importar e exportar quando um modelo passa entre o Holarch e outra ferramenta SysML v2, ou entre projetos do Holarch:

  • Iniciar um projeto do Holarch a partir de um modelo escrito em outro lugar.
  • Trazer um pacote que outra equipe mantém, como uma biblioteca de componentes, e atualizá-lo quando ela enviar uma nova versão.
  • Entregar um pacote a um fornecedor ou a uma ferramenta que lê texto ou JSON SysML v2.
  • Manter arquivos .sysml no seu próprio controle de versão ao lado do projeto do Holarch.

Importar arquivos para este projeto

  1. Abra Modelo → Importar e exportar.
  2. Em Importar, escolha Neste projeto.
  3. Solte os arquivos na área de soltura, ou clique nela e escolha-os.

    Você vê "Lendo os arquivos…" e depois a pré-visualização: o número de pacotes de nível superior e de arquivos, eventuais problemas e uma tabela com Importar, Pacote, Elementos e Resultado.

  4. Leia a lista de problemas, se houver. Ela nomeia cada arquivo e linha que não é analisável e cada arquivo que foi ignorado.
  5. Desmarque qualquer pacote que você não queira importar. Para substituir um pacote que conflita pelo nome, marque-o.

    Em um plano com limite de itens, a pré-visualização conta os itens que o projeto teria após a importação (relacionamentos não contam). Se isso ultrapassar o limite, ela avisa, por exemplo "Esta importação levaria o projeto a 1.804 itens; o plano Free permite 1.000.", e Importar N pacotes fica desativado até você desmarcar pacotes suficientes. Nada é aplicado nem enviado ao servidor. Importações para um projeto novo são checadas da mesma forma em relação ao limite por projeto do seu plano.

  6. Clique em Importar N pacotes.

    A notificação diz "N pacotes importados." A página diz "N pacotes importados (M elementos). Desfazer reverte a importação em uma etapa." Clique em Abrir texto para vê-los.

Importar arquivos para um novo projeto

  1. Abra Modelo → Importar e exportar e escolha Em um projeto SysML v2 novo.
  2. Solte ou escolha os arquivos.

    A pré-visualização lista os elementos de nível superior, todos marcados.

  3. Desmarque os que você não quiser e edite o Nome do projeto. Por padrão, ele é o nome do arquivo único ou do primeiro pacote.
  4. Clique em Criar projeto.

    O novo projeto abre no Editor.

Em Gerenciar projetos, Arquivos do projeto ▾ → Importar arquivos SysML v2… faz o mesmo em uma etapa. Se partes dos arquivos não puderem ser lidas, ele pergunta antes: "N problemas encontrados: partes dos arquivos ficam de fora. Criar o projeto com o restante? Para ver os problemas antes, abra um projeto SysML v2 e use Importar e exportar." Clique em Criar projeto para continuar.

Atualizar um pacote a partir de uma nova versão

  1. Exporte ou receba a nova versão como arquivos .sysml ou JSON.
  2. Importe-a Neste projeto.

    O pacote mostra Alterado, com o número de elementos adicionados, alterados e removidos.

  3. Clique em Importar 1 pacote.

    Os elementos correspondentes mantêm seus ids, então os vínculos com eles (vínculos de requisitos, riscos, layouts de vistas, comentários) permanecem. Elementos que não estão mais no arquivo vão para a Lixeira.

Renomear e mover elementos no texto mantendo seus ids

  1. Exporte os pacotes como texto SysML v2 com Incluir ids dos elementos marcado.
  2. Edite os arquivos: renomeie elementos, mova-os para outros donos ou para outro arquivo de pacote, reordene-os. Mantenha cada linha @HolarchMetadata::ElementId dentro do corpo do seu elemento.
  3. Importe os arquivos editados Neste projeto.

    Os pacotes mostram Alterado. Elementos renomeados e movidos contam como alterados, não como adicionados e removidos.

  4. Clique em Importar N pacotes.

    Os elementos mantêm seus ids: suas posições nos diagramas, comentários, rastros e vínculos permanecem. Elementos movidos para outro pacote saem do pacote em que estavam.

Importações grandes no serviço hospedado

No serviço hospedado, uma importação de 5.000 elementos ou mais é aplicada pelo servidor, não pelo seu navegador. Quando todo pacote marcado é Novo ou substitui um Conflito, o próprio servidor lê os arquivos (as etapas abaixo). Quando um pacote marcado está Alterado, seu navegador calcula a mesclagem como de costume e envia as mudanças uma vez; o servidor então as grava em uma etapa, com o mesmo cartão de progresso, Cancelar importação e Desfazer importação.

  1. Escolha os arquivos e confira a pré-visualização como em qualquer importação.
  2. Clique em Importar N pacotes (ou Criar projeto).

    Os arquivos são enviados uma vez. O servidor os lê com as mesmas checagens e os mesmos ids de elementos da pré-visualização e grava o resultado em uma etapa.

  3. Acompanhe o cartão de progresso na parte inferior da janela: ele mostra a fase (enviando, lendo, checando, aplicando, atualizando o índice do projeto) e o tempo restante.

    Você pode sair da página ou fechar a aba. A importação continua no servidor, e quando você abrir o projeto de novo o resultado estará lá. Toda cópia aberta do projeto é recarregada quando a importação é aplicada; edições não enviadas são enviadas de novo após o recarregamento.

  • Outros membros veem "Nome está importando arquivo…" no mesmo cartão e na página Importar e exportar.
  • Uma importação por vez: uma segunda importação grande no mesmo projeto aguarda até a primeira terminar.
  • Cancelar importação (a pessoa que a iniciou ou um proprietário) interrompe a importação antes de ela ser aplicada. Nada é alterado.
  • Desfazer importação: ⌘Z / Ctrl+Z no navegador não reverte uma importação no servidor. Clique em Desfazer importação na página Importar e exportar para devolver o projeto ao estado anterior à importação mais recente. O estado anterior ao desfazer fica guardado no Histórico, então as edições feitas após a importação podem ser recuperadas de lá.
  • Atividade do projeto e Histórico listam a importação como uma única entrada da pessoa que a iniciou.

Exportar o modelo ou um pacote

  1. Abra Modelo → Importar e exportar.
  2. Em Exportar, escolha o que exportar: Todo o modelo ou um pacote pelo seu nome qualificado.
  3. Escolha o formato: Texto SysML v2 (.sysml; um .zip para vários packages) ou JSON do SysML v2 (.json).
  4. Para texto que você vai editar e importar de novo, marque Incluir ids dos elementos.
  5. Clique em Exportar.

    Um arquivo é baixado, ou um zip quando a exportação contém vários arquivos. A notificação diz "<arquivo> exportado." ou "N arquivos exportados como zip."

Para exportar um pacote rapidamente, use o Navegador: o menu da linha de um pacote tem Exportar como .sysml e Exportar como JSON.

Importar e exportar requisitos ReqIF

ReqIF é o formato de intercâmbio das ferramentas de requisitos. Um arquivo ReqIF é importado como um pacote de requisitos SysML v2, e os requisitos são exportados de volta como ReqIF, de modo que uma ferramenta de requisitos e um projeto SysML v2 podem trocar os mesmos requisitos nas duas direções.

Importar um arquivo ReqIF:

  1. Abra Modelo → Importar e exportar (ou clique em Importar… na página Requisitos, ou escolha Importar ReqIF… em ⌘K / Ctrl+K).
  2. Solte o arquivo .reqif ou .reqifz na caixa, ou clique na caixa para escolhê-lo. Um arquivo ReqIF por importação.
  3. O painel ReqIF mostra o número de requisitos, capítulos e relações, quantos foram convertidos, aproximados ou deixados de fora, e se o texto SysML v2 passa nas checagens sem problemas.
  4. Em Nomes curtos de, escolha ID externo (o número que as pessoas veem na ferramenta de origem, como SRS-12) ou Identificador ReqIF (o id interno da ferramenta). Requisitos sem ID externo recebem o identificador.
  5. Em Tipos de relação, escolha o que cada tipo de relação se torna: Derivar, Refinar, Dependência ou Deixar de fora. A pré-visualização é calculada de novo, e a escolha é mantida para a próxima importação do mesmo arquivo.
  6. Clique em Importar 1 pacote. Um único Desfazer reverte a importação inteira. A notificação diz "N requisitos importados de <título>."

O que a importação cria:

ReqIFSysML v2
Requisito (spec object)requirement, com o ID externo ou o identificador como nome curto, o nome e o texto como doc
Tipo de requisitorequirement def, com um atributo por atributo ReqIF
Tipo de dado de enumeraçãoenum def
Atributo de status (Draft, Proposed, Approved e assim por diante)O status do requisito no Holarch
Título de capítulopackage com o número do capítulo como nome curto
Requisito aninhadorequirement aninhado
Relação derived fromConexão de derivação
Relação refinesDependência com a anotação Refinement
satisfies, verified by e outras relaçõesDependência (o relatório diz por quê)
Especificaçãopackage dentro do pacote do arquivo

Tabelas se tornam linhas de texto com | entre as células, listas se tornam linhas que começam com um traço, e formatação e links mantêm apenas o texto; esses requisitos ficam Aproximados. Imagens e objetos incorporados não são importados; o requisito que continha um deles é listado com o motivo, para que você possa anexar o arquivo a ele. Baixar relatório salva cada requisito e relação com seu resultado como CSV; Baixar texto SysML v2 salva o texto.

Importar uma cópia mais recente do arquivo: importe-a no mesmo projeto. O Holarch encontra o pacote da importação anterior e compara requisito por requisito:

  • Os requisitos mantêm seus ids de elemento, então diagramas, vínculos de satisfy e verify, revisões e o Histórico continuam ligados. Requisitos renomeados e movidos são atualizados no lugar.
  • Requisitos ausentes no novo arquivo são mantidos. Marque Remover os N requisitos ausentes neste arquivo para movê-los para a Lixeira.
  • Parts, casos de verificação e vínculos que você adicionou no Holarch são mantidos.
  • Um requisito alterado só no Holarch mantém sua alteração. Um requisito alterado aqui e no arquivo recebe o texto do arquivo; o texto anterior fica no Histórico. A pré-visualização lista esses em Alterados aqui e no arquivo.

Exportar como ReqIF:

  1. Em Exportar, escolha um pacote ou Todo o modelo, e ReqIF (.reqif) ou Arquivo compactado ReqIF (.reqifz).
  2. Clique em Exportar. A notificação diz "N requisitos exportados como <arquivo>."

Exportar… → Requisitos (ReqIF) no Banco de dados ou na página Requisitos exporta os requisitos listados (ou selecionados) da mesma forma.

O arquivo contém o nome curto de cada requisito (como ReqIF.ForeignID), o nome, o doc (como XHTML), o status e os valores de atributos, a hierarquia de pacotes como a especificação, e os relacionamentos de derive, refine e dependência. Requisitos importados de ReqIF mantêm seus identificadores, tipos e tipos de relação originais, então a ferramenta de origem atualiza seus requisitos em vez de adicionar cópias; exportar e importar o arquivo de novo mostra todo pacote como Inalterado. Valores de atributos calculados são gravados como texto. Vínculos de satisfy e verify ficam no Holarch: o ReqIF não tem parts nem casos de verificação.

Obter de um repositório e enviar para ele

Conecte o projeto a um ramo de um repositório de modelos SysML v2 para ler o commit mais recente e enviar suas mudanças de volta.

  1. Abra Modelo → Importar e exportar e encontre a seção Repositório.
  2. Digite o Endereço do repositório (o endereço https da sua Systems Modeling API) e, se o repositório exigir, o Token de acesso.
  3. Clique em Carregar projetos e escolha o Projeto e o Ramo. Para iniciar um novo projeto de repositório a partir deste modelo, clique em Novo projeto de repositório.
  4. Clique em Pull…. O Holarch lê o commit mais recente do ramo e lista cada diferença: Novo, Alterado, Removido ou Conflito. Você vê "Atualizado: nenhuma mudança no repositório." quando não há nada para puxar.
  5. Desmarque as diferenças que você não quiser e clique em Aplicar pull. Um único Desfazer reverte o pull inteiro.
  6. Depois de alterar o modelo, clique em Push. Suas mudanças desde o último commit sincronizado vão para o ramo como um novo commit. Você vê, por exemplo, "3 alterados enviados como commit 1a2b3c4d."

Um Conflito é um elemento alterado aqui e no repositório desde a última sincronização. Um conflito desmarcado mantém a versão deste projeto.

Nota: um push é recusado quando o ramo tem commits que este projeto não puxou: "O ramo do repositório tem commits que este projeto não puxou. Faça pull primeiro e depois push de novo."

Exemplo prático: a demonstração Hybrid Car

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

  1. Abra Modelo → Importar e exportar. Em Exportar, escolha Todo o modelo e texto SysML v2 e clique em Exportar.

    Um zip é baixado com um arquivo por pacote de nível superior, como Vehicles.sysml, VehicleRequirements.sysml, VehicleBehavior.sysml e VehicleViews.sysml.

  2. Abra VehicleRequirements.sysml em um editor de texto. Altere attribute maxCurbMass : MassValue = 1650 [kg]; para 1600 [kg] e salve.
  3. De volta em Importar e exportar, escolha Neste projeto e solte VehicleRequirements.sysml.

    A pré-visualização mostra VehicleRequirements como Alterado, com o número de elementos alterados. Os outros pacotes não estão no arquivo, então não são listados.

  4. Clique em Importar 1 pacote.

    O valor muda no modelo. O requisito Sedan Mass (VR-1.1) nomeia maxCurbMass, então seus vínculos são marcados para revisão (consulte Requisitos e verificação em projetos SysML v2). Pressione ⌘Z / Ctrl+Z para desfazer a importação.

  5. Para iniciar um segundo projeto a partir dos mesmos arquivos, escolha Em um projeto SysML v2 novo, solte o zip e clique em Criar projeto.

Dicas e boas práticas

  • Use JSON para mover um modelo entre ferramentas SysML v2 quando os ids importam, por exemplo quando a outra ferramenta mantém vínculos por id. Use texto quando pessoas leem ou revisam os arquivos; marque Incluir ids dos elementos quando o texto volta ao Holarch após a edição.
  • Deixe os ids de fora do texto que você entrega a pessoas que apenas o leem: eles acrescentam uma linha por elemento.
  • Mantenha um pacote de nível superior por arquivo. A exportação grava os arquivos assim, e uma importação posterior então faz a correspondência pacote por pacote.
  • Importe um pacote de outra equipe em seu próprio pacote de nível superior. As atualizações então afetam apenas esse pacote.
  • Confira a lista de problemas antes de importar. Membros que não são analisáveis ficam de fora.

Erros comuns

  • Um pacote mostra Conflito: "Já existe um pacote chamado X com outros ids." O projeto tem um pacote com esse nome que não foi importado deste JSON. Marque a linha para substituí-lo (o pacote antigo vai para a Lixeira) ou importe em um projeto novo.
  • "A importação contém dois pacotes de nível superior chamados X; só o primeiro é importado." Dois arquivos declaram o mesmo pacote de nível superior. Mescle-os em um arquivo ou renomeie um deles.
  • Um elemento renomeado foi importado como novo. O texto não tinha ids de elementos, e o elemento foi renomeado e movido ao mesmo tempo (ou seu tipo e seu nome mudaram juntos). Exporte com Incluir ids dos elementos, faça a alteração e importe de novo.
  • Faltam elementos após a importação. Um membro que não é analisável fica de fora: "Este membro não é analisável e fica de fora." Corrija a linha que a lista de problemas nomeia e importe de novo.
  • Uma importação JSON é recusada. Importe um arquivo JSON SysML v2 por vez, sem arquivos .sysml.

Como se conecta a outros recursos

  • Editor: os pacotes importados abrem lá; os arquivos exportados são o texto que você vê lá.
  • Desfazer e Lixeira: um único Desfazer reverte uma importação inteira neste projeto; os elementos que ela remove ou substitui vão para a Lixeira.
  • Controle de mudanças: valores e documentação que mudam por uma importação marcam vínculos de requisitos para revisão, como qualquer outra edição.
  • Arquivos de projeto do Holarch: Exportar este projeto… em Gerenciar projetos salva o projeto Holarch inteiro, com riscos, documentos e outros dados do Holarch. .sysml e JSON contêm apenas o modelo.
  • Conversão: para mover um modelo entre LML e SysML v2, crie uma cópia convertida (consulte Conversão entre LML e SysML v2).

A página Importar e exportar

Importar

ControleUso
Neste projetoMescla os arquivos no projeto aberto. Não está disponível para quem só pode ver o projeto; para essas pessoas, as importações criam um projeto novo.
Em um projeto SysML v2 novoCria um projeto novo a partir dos arquivos.
Área de soltura"Solte arquivos aqui ou clique para escolhê-los". Aceita arquivos .sysml, um .zip de arquivos .sysml ou um arquivo JSON SysML v2.
Tabela de pré-visualizaçãoImportar (caixa de seleção), Pacote (nome e tipo), Elementos (contagem), Resultado (Novo, Alterado, Inalterado ou Conflito, com um detalhe).
Nome do projeto(Somente projeto novo) O nome do novo projeto, com até 200 caracteres.
Importar N pacotes / Criar projetoAplica a importação.
CancelarFecha a pré-visualização sem importar.

Elementos fora de qualquer pacote no texto .sysml são listados juntos em uma linha, Fora de packages.

Quando o modelo muda enquanto uma pré-visualização está aberta (outra aba, um colaborador ou Desfazer), a pré-visualização é calculada de novo.

Exportar

ControleUso
Exportar (escopo)Todo o modelo ou qualquer pacote pelo nome qualificado.
como (formato)Texto SysML v2 (.sysml; um .zip para vários packages) ou JSON do SysML v2 (.json).
Incluir ids dos elementos(Somente texto; desativado por padrão) Grava o id de cada elemento nomeado no texto como @HolarchMetadata::ElementId { id = "…"; }, para que uma cópia editada importada de novo mantenha os ids em renomeações e movimentações.
ExportarBaixa o arquivo.

A exportação de texto grava um arquivo por pacote de nível superior, com o nome dele (Vehicles.sysml). Elementos fora de pacotes vão para Outside packages.sysml. A exportação JSON grava um arquivo com o nome do projeto ou do pacote.

Repositório

A seção Repositório liga o projeto a um ramo de um repositório que oferece a Systems Modeling API.

  • Endereço do repositório: o endereço https da API do repositório. O Holarch só se conecta a endereços https em hosts públicos; os administradores do site podem limitar os hosts e as portas.
  • Token de acesso: guardado criptografado para sua conta e este projeto, e enviado apenas a esse endereço. Ele nunca é mostrado de novo; deixe o campo vazio para manter o token guardado.
  • Carregar projetos, Projeto e Ramo: escolha onde sincronizar. Novo projeto de repositório cria um projeto no repositório para este modelo.
  • Pull…, Aplicar pull: leem o commit mais recente, permitem revisar as diferenças e as aplicam, e um único Desfazer reverte tudo. O Holarch compara com o último commit que sincronizou, então consegue distinguir suas mudanças das do repositório.
  • Push: envia as mudanças desde o último commit sincronizado como um commit. "Nada para enviar: o modelo corresponde ao último commit sincronizado." significa que não há nada novo.
  • Ajustes… altera a conexão. Desconectar remove o token guardado e o estado de sincronização; o modelo permanece.
  • As operações de repositório exigem o papel de editor. Leitores não podem fazer pull nem push.
  • Pushes são recusados em projetos com marcações de dados regulados.

Como os arquivos são lidos

  • Os arquivos são checados antes de qualquer leitura: tamanhos, quantidades, aninhamento e comprimentos de texto.
  • Em um zip, arquivos ocultos e pastas __MACOSX são ignorados. Links, arquivos que não são .sysml e uma segunda cópia do mesmo caminho são ignorados, e a lista de problemas diz por quê.
  • O texto deve estar em UTF-8. Uma marca de ordem de bytes é permitida.
  • Cada elemento importado é checado antes de ser gravado. Um elemento recusado leva consigo seus membros próprios; a lista de problemas os conta.
  • Em JSON, elementos de tipos que o Holarch não interpreta são mantidos como foram importados: consulte Elementos que o Holarch não interpreta.

Elementos que o Holarch não interpreta

O JSON do SysML v2 pode conter tipos de elementos que o Holarch não modela, como behaviors, steps ou interactions do KerML. O Holarch os mantém em vez de deixá-los de fora:

  • Cada um permanece no modelo com seu id, nome, dono e seu JSON original, incluindo seus relacionamentos (tipagens, especializações e outros) e o que eles possuem. Seus membros o mantêm como dono.
  • O Navegador mostra seu tipo original com uma etiqueta Não interpretado; aponte para a etiqueta para ver a explicação. O inspetor mostra seu tipo, seu id no arquivo e para onde apontam seus relacionamentos.
  • Ele não pode ser renomeado nem editado no Holarch. Altere-o na ferramenta de onde veio e importe-o de novo. Você pode movê-lo ou excluí-lo.
  • Ele não tem texto SysML. O Editor o deixa de fora do texto, junto com tudo o que ele possui, e uma nota acima do texto diz quantos elementos não são mostrados. Editar o texto nunca os remove. Uma exportação .sysml também os deixa de fora.
  • Uma exportação JSON o grava de volta sem alterações. Só o que mudou no modelo é ajustado: um membro que você excluiu ou adicionou, um membro que você renomeou ou um novo dono.
  • A pré-visualização da importação lista cada tipo mantido uma vez, como nota, por exemplo 2 elementos Behavior são mantidos como importados. Notas não são problemas.

Não mantidos: o namespace raiz sem nome com que algumas ferramentas envolvem uma exportação inteira (seus membros se tornam elementos de nível superior) e elementos sem suporte dentro de um valor, que são listados como problemas. Um elemento cujo JSON é maior que 256 KB mantém apenas seu tipo e seu id.

Mensagens

MensagemSignificado e correção
Escolha arquivos .sysml, um .zip de arquivos .sysml ou um arquivo JSON SysML v2.Nenhum arquivo foi escolhido.
Nenhum arquivo .sysml foi encontrado. Escolha arquivos .sysml, um .zip de arquivos .sysml ou um arquivo JSON SysML v2.O arquivo compactado ou a seleção não contém arquivos .sysml.
Importe um arquivo JSON SysML v2 por vez, sem arquivos .sysml.Foram escolhidos vários arquivos JSON, ou JSON misturado com texto.
<arquivo> não é um arquivo ReqIF (…). Exporte-o da ferramenta de origem como ReqIF 1.0 ou posterior e importe-o de novo.O arquivo não é XML ReqIF, ou contém um DOCTYPE, que o Holarch não lê.
<arquivo> não contém requisitos (nenhum elemento SPEC-OBJECT). Exporte as especificações com seus objetos e importe o arquivo de novo.O arquivo ReqIF tem tipos, mas não tem requisitos.
<título> tem N requisitos, mais do que uma importação aceita (cerca de M). Exporte as especificações como arquivos ReqIF separados.O texto SysML v2 ultrapassaria o limite de 8 MB. Importe as especificações um arquivo por vez.
<arquivo> não é texto UTF-8. Salve-o como UTF-8 e importe-o de novo.Converta a codificação do arquivo.
<arquivo> não é um arquivo ZIP válido. Crie o arquivo compactado de novo.O arquivo compactado está danificado.
<arquivo> contém arquivos criptografados. Crie o arquivo compactado sem senha.Arquivos compactados protegidos por senha não são lidos.
<caminho> está compactado mais de 200:1, o que é típico de uma zip bomb. Crie o arquivo compactado de novo.O arquivo compactado foi recusado por segurança.
O arquivo compactado usa um método de compressão sem suporte. Crie-o com a compressão ZIP padrão.Use a compressão padrão (deflate).
Arquivos KerML ainda não são importados.Arquivos .kerml são ignorados.
Somente arquivos .sysml são importados de um arquivo compactado.Outros arquivos em um zip são ignorados.
Links não são importados.Links simbólicos em um zip são ignorados.
O arquivo compactado contém este arquivo duas vezes; a primeira cópia é importada.Duas entradas têm o mesmo caminho.
<arquivo> não é JSON válido. Exporte o modelo de novo.O arquivo JSON está danificado.
<arquivo> não é JSON do SysML v2 (uma lista de elementos com @id e @type). Escolha uma exportação JSON do SysML v2.O JSON está em outro formato.
A linha N de <arquivo> tem mais de 64 KB. Quebre a linha e importe o arquivo de novo.Linhas muito longas são recusadas.
Este membro não é analisável e fica de fora.Corrija a linha nomeada na lista de problemas.
Um elemento com este id está dentro de <elemento> neste projeto. Mova-o primeiro para o nível superior ou importe em um projeto novo.(Conflito) O pacote de nível superior do JSON já existe mais fundo no modelo.
N ids de elementos dele são usados em outro lugar deste projeto. Importe em um projeto novo.(Conflito) O JSON reutiliza ids de outros elementos.
O texto do pacote não é analisável após a impressão. Importe-o em um projeto novo.(Conflito) Não foi possível mesclar o pacote.
N elementos <tipo> são mantidos como importados (não interpretados): …(Nota) Elementos de um tipo que o Holarch não interpreta são mantidos sem alterações. Consulte Elementos que o Holarch não interpreta.
Um elemento do tipo <tipo> dentro de um valor não tem suporte e fica de fora.Um valor (uma expressão) contém um elemento que o Holarch não consegue ler. O restante do valor é mantido como texto.
Um elemento do tipo <tipo> é grande demais para ser mantido por inteiro; só seu tipo e seu id são mantidos.Seu JSON é maior que 256 KB.
A importação não foi aplicada: … Nada foi alterado.A importação falhou; o projeto não foi alterado.
O modelo está vazio. Adicione um pacote e exporte de novo.Não há nada para exportar.
O pacote a exportar não existe mais. Escolha outro.O pacote foi excluído enquanto a página estava aberta.

Limites

LimiteValor
Arquivos por importação2,000
Texto .sysml por importação (descompactado)8 MB
Arquivo zip16 MB, 10.000 entradas
Aninhamento de pastas em um zip32 pastas
Elementos por importação (texto ou JSON)100,000
Arquivo JSON24 MB, aninhamento de 64 níveis
JSON de um elemento que o Holarch não interpreta256 KB, aninhamento de 12 níveis
Comprimento da linha64 KB
Arquivo ReqIF (.reqif, ou .reqif dentro de um .reqifz)64 MB; o texto SysML v2 que ele gera deve caber no limite de texto de 8 MB (cerca de 8.000 a 20.000 requisitos)
  • As respostas do repositório são limitadas a 64 MB para um pull inteiro, e cada operação de repositório para após 120 segundos.
  • Cada conta pode executar no máximo 300 operações de repositório por hora.
  • Arquivos KerML (.kerml) ainda não são importados.
  • No aplicativo hospedado, o servidor lê importações de até 1,5 MB de texto .sysml. Importações maiores são lidas no seu navegador, com o mesmo resultado.
  • Os dados do Holarch ao lado do modelo (status de requisitos, riscos, orçamentos, ajustes do simulador, layouts de vistas) não fazem parte dos arquivos .sysml ou JSON. Use Exportar este projeto… em Gerenciar projetos para guardá-los.

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