Importação e exportação
Formatos de importação e exportação
Traga especificações, planilhas, arquivos de intercâmbio de requisitos e modelos para um projeto do Holarch, e leve o modelo para fora como documentos, tabelas, imagens, arquivos de intercâmbio e arquivos de projeto completos. Esta página lista cada formato, em que sentido ele funciona, o que transporta e seus limites conhecidos.
Como funcionam as importações e exportações
- As exportações estão abertas a todos os membros do projeto, inclusive leitores. As importações exigem o papel de Proprietário ou Editor, porque alteram o projeto.
- Uma importação pela página Importar e exportar mostra uma pré-visualização, dá novos IDs aos itens importados e é uma única etapa de desfazer. Para atualizar itens existentes em vez de adicionar novos, associe-os por ID, nome ou número.
- O conteúdo importado é limpo: o texto formatado perde scripts e links inseguros, as imagens SVG perdem scripts e referências externas, e XML com declarações DOCTYPE ou ENTITY é recusado.
- As exportações CSV neutralizam texto que uma planilha executaria como fórmula. Os nomes de arquivo são limpos para todos os sistemas operacionais.
- Cada projeto é um projeto LML ou um projeto SysML v2. As importações de Word, planilhas, texto e ReqIF são para projetos LML. Projetos SysML v2 importam texto e JSON SysML v2, e modelos SysML 1.x como XMI ou .mdzip, convertidos para SysML v2. Projetos LML também importam XMI. Os arquivos de projeto e as exportações de Word, Excel e CSV das páginas compartilhadas funcionam em ambos.
Ir para: Requisitos e especificações · Modelos · Planilhas e tabelas · Documentos e relatórios · Imagens · Arquivos de projeto · API e MCP
Requisitos e especificações
| Formato | Sentido | O que cobre | Limites conhecidos |
|---|---|---|---|
| Word (.docx) | Importar | Uma especificação se torna um documento numerado. Os títulos se tornam Statements aninhados por nível; parágrafos com “shall”, “must”, “will” ou “should” e itens de listas numeradas se tornam Requirements. As tabelas se tornam um item por linha, ou permanecem como tabelas em uma descrição. Negrito, itálico, listas e imagens são mantidos, as alterações controladas inseridas são lidas e o arquivo original é anexado. | Imagens em EMF, WMF e outros formatos além de PNG, JPEG, GIF, WebP e SVG são ignoradas. Texto excluído em alterações controladas não é importado. |
| Texto simples (.txt ou colado) | Importar | Linhas numeradas e frases com “shall” se tornam um documento numerado de Statements e Requirements. A numeração de tópicos é detectada ou escolhida: decimal, romana, letras, níveis mistos, estilo DoD ou um padrão personalizado. | A estrutura vem apenas da numeração e da redação. |
| ReqIF (.reqif, .reqifz) | Importação e exportação | Importação: cada SPEC-OBJECT se torna um item, com a hierarquia da especificação, seu tipo como classe e atributos de string, XHTML, booleano, data, enumeração, inteiro e real. SPEC-RELATIONs se tornam relacionamentos; satisfy, verify e deriveReqt se tornam satisfies, verifies e traced from; trace e refine se tornam traced to. Exportação a partir do Banco de dados ou de um documento: um tipo por classe com número, nome, descrição e todos os atributos, relacionamentos como SPEC-RELATIONs e a decomposição como hierarquia. | Tipos de relação sem correspondência se tornam traced to; vínculos que o esquema não permite são ignorados com um aviso. |
Modelos
| Formato | Sentido | O que cobre | Limites conhecidos |
|---|---|---|---|
| XMI de UML e SysML 1.x (.xmi, .uml, .xml, .mdzip) | Importação e exportação | Importação: XMI 2.x com UML 2.5 e o perfil SysML 1.3 a 1.7, e arquivos de projeto .mdzip. Requisitos com seus ids e texto, blocos, partes, portas, propriedades de valor, tipos de valor com unidades, generalizações, conectores e fluxos de itens, atividades com seu fluxo de controle, máquinas de estados com estados paralelos e transições de choice, junction, fork e join, diagramas de sequência, casos de teste, pacotes, estereótipos e valores marcados. Satisfy, verify, deriveReqt, refine, trace, copy e allocate se tornam relacionamentos do Holarch. Os diagramas de blocos, de blocos internos, de máquina de estados e de ação são desenhados a partir do modelo importado. Exportação: XMI SysML 1.6 (XMI 2.5.1) para Cameo/MagicDraw, Enterprise Architect e Rhapsody, ou Papyrus (Eclipse UML, .uml) para o Papyrus, com requisitos, blocos, partes, portas, tipos de valor com unidades, blocos de restrição, conectores com fluxos de itens, atividades, casos de uso, casos de teste, máquinas de estados e os relacionamentos de rastreabilidade. Os itens importados mantêm seus ids XMI e a exportação os grava de volta, então importar uma versão posterior do mesmo modelo atualiza os itens em vez de adicionar cópias. Com os atributos e rótulos do Holarch ativados, o arquivo volta a ser importado no Holarch sem perdas. | Layouts de diagramas e operações não são importados; a revisão lista o que fica de fora. O fluxo de uma atividade só é desenhado quando ela é bem estruturada. Artifacts, tarefas, riscos, problemas, decisões, itens de tempo e de custo não são exportados. |
| Código-fonte Java (.java) | Importar | Em um diagrama de classes: classes, interfaces e enums se tornam Assets, campos se tornam Characteristics e métodos se tornam Actions com seus parâmetros e resultados como Input/Outputs. | Um arquivo ou código colado por vez. |
| Texto SysML v2 (.sysml, ou um .zip de arquivos .sysml) | Importação e exportação | Importe para um projeto SysML v2 ou um novo, com uma pré-visualização por pacote: novo, alterado, inalterado ou em conflito. As pastas de um zip se tornam pacotes. Exporte o modelo inteiro ou um pacote; vários pacotes são baixados como um zip. | O texto não contém ids de elementos, então uma reimportação associa os elementos pelo nome. Arquivos KerML (.kerml) não são importados. Até 2.000 arquivos, 8 MB de texto e um zip de 16 MB por importação; o texto deve estar em UTF-8. |
| SysML v2 JSON (.json) | Importação e exportação | A lista plana de elementos com @id e @type que a Systems Modeling API usa. Os ids dos elementos são mantidos, então uma reimportação associa por id. | Até 24 MB e 100.000 elementos. Tipos de elemento que o Holarch não interpreta são mantidos como importados, marcados como Não interpretado, e gravados de volta sem alteração. |
| Repositório de modelos SysML v2 | Pull e push | Conecte um projeto SysML v2 a um branch de um repositório que ofereça a Systems Modeling API. Faça pull do commit mais recente e revise cada diferença antes de aplicá-la; faça push das suas mudanças como um único commit. | Somente endereços https em hosts públicos. Um push é recusado enquanto o branch tiver commits que não foram puxados. 64 MB por pull, 120 segundos por operação e 300 operações por conta por hora. Exige o papel de Editor. |
| Systems Modeling API no Holarch | Leitura e commit por outras ferramentas | Outras ferramentas SysML v2 leem os elementos de um projeto SysML v2 como SysML v2 JSON via REST, com um token de acesso pessoal, e fazem commit de mudanças em branches de solicitação de mudança. | main é somente leitura; os commits vão para solicitações de mudança que um aprovador aplica no Holarch. Somente heads de branches; sem tags, merges ou consultas salvas. |
| SysML v1 para SysML v2 (.xmi, .uml, .xml, .mdzip) | Importar | Um modelo SysML 1.x do Cameo ou MagicDraw, Enterprise Architect, Rhapsody ou Papyrus é convertido em texto SysML v2, checado e importado para um projeto SysML v2 ou um novo como uma única etapa de desfazer. Um relatório de conversão lista cada elemento como convertido, aproximado ou deixado de fora, com o motivo, e pode ser baixado como CSV. | Diagramas e seus layouts não são convertidos. Relacionamentos com elementos sem nome são deixados de fora. |
| LML para SysML v2 e de volta | Cópia convertida, nos dois sentidos | Um novo projeto na outra linguagem: Assets, portas, Conduits, Input/Outputs, requisitos, vínculos de satisfy, casos de teste, Actions com seu fluxo, estados e equações. Riscos, decisões, tarefas, documentos, quadros brancos, status de requisitos e resultados de teste também são levados. Um relatório lista o que foi convertido e o que não foi, e pode ser baixado como CSV. | Layouts de diagramas, histórico, linhas de base e solicitações de mudança não são convertidos. Elementos para os quais uma linguagem não tem lugar, como Measures e Resources da LML ou cálculos e casos de análise do SysML v2, são listados no relatório. |
Os dados do Holarch junto a um modelo SysML v2, como status de requisitos, riscos, orçamentos e layouts de visões, não fazem parte dos arquivos .sysml nem SysML v2 JSON. Uma exportação de projeto os mantém.
Planilhas e tabelas
| Formato | Sentido | O que cobre | Limites conhecidos |
|---|---|---|---|
| Excel (.xlsx, .xlsm) e CSV | Importar | Itens novos ou atualizados de qualquer classe, com um mapeamento de colunas proposto a partir dos cabeçalhos. Atributos, rótulos, relacionamentos, hierarquia a partir de uma coluna de pai ou dos números, e novos atributos criados a partir dos dados. Associe itens existentes por ID, nome ou número para atualizá-los. | Excel 97-2003 (.xls) e CSV separado por ponto e vírgula não são lidos. Nomes e números são cortados em 255 caracteres. |
| Excel e CSV a partir do Banco de dados | Exportar | Qualquer conjunto de itens como uma tabela com atributos e relacionamentos escolhidos, com hierarquia e totalizações, como definições, como matriz de relacionamentos, como histórico de mudanças ou como comentários. | As células do Excel comportam até 32.000 caracteres; texto mais longo é cortado. |
| Excel e CSV a partir de outras páginas | Exportar | RVTM, VCRM, RVM, RTM, RSM e TVM; resultados de qualidade de requisitos; registro de TBD/TBR; registro de interfaces; matrizes N² e I²; orçamentos e TPMs; registro de riscos; estudos de trade-off; tabelas de análise funcional; comparações de linhas de base; dados de gráficos; linhas do tempo, logs de eventos e execuções do simulador. | Cada página exporta suas próprias colunas. |
| Matriz de rastreabilidade (.xlsx, .csv) | Importação e exportação | Exporte qualquer relacionamento como matriz. Edite a pasta de trabalho em uma planilha e importe-a de volta: a pré-visualização lista os vínculos a adicionar, os vínculos a remover e as células ignoradas. | A importação só adiciona e remove vínculos entre itens existentes. As células que o esquema não permite são ignoradas e listadas. |
Documentos e relatórios
| Formato | Sentido | O que cobre | Limites conhecidos |
|---|---|---|---|
| Word (.docx) | Exportar | Documentos e estruturas de tópicos com estilos de título do Word, marcações, páginas de capa e números de página; redlines com alterações controladas entre linhas de base; decomposições de entidades; relatórios de diagramas; ICDs; casos de teste; RVTM e matrizes de rastreabilidade; resumos de estudos de trade-off; relatórios de análise funcional; o pacote de arquitetura DoDAF. | As páginas são em formato US Letter. |
| PowerPoint (.pptx) | Exportar | Apresentações, um slide por página, com caixas de texto, formas e anotações do orador. As apresentações também são exportadas como HTML e Word. | Nenhum listado. |
| Markdown (.md) | Exportar | Um documento como títulos e texto em Markdown. | Nenhum listado. |
| HTML | Exportar | Páginas web de diagramas, relatórios de diagramas, gráficos, apresentações e matrizes de rastreabilidade. | Nenhum listado. |
| Impressão e PDF | Exportar | Documentos, tabelas e diagramas pela caixa de diálogo de impressão do navegador, que salva em PDF. Os quadros brancos exportam PDF diretamente. | As páginas PDF de quadros brancos são imagens. |
Imagens
| Formato | Sentido | O que cobre | Limites conhecidos |
|---|---|---|---|
| PNG e SVG | Exportar | Diagramas, gráficos, slides, painéis do simulador e cartões da galeria. PNG em uma escala escolhida, com ou sem fundo; SVG como imagem vetorial escalável. | Nenhum listado. |
| Quadros brancos: PNG, JPG, SVG, PDF | Exportar | Um quadro, uma seleção, a visão atual, um frame ou todos os quadros. O SVG mantém formas e texto editáveis em ferramentas vetoriais. | As páginas PDF são imagens. |
| Imagens e arquivos anexados | Importar | Imagens em texto formatado, imagens de entidades, atributos de arquivo, quadros brancos e slides. Gráficos PNG, JPEG ou SVG para produtos DoDAF, como um OV-1 com áreas clicáveis. | Imagens com mais de 4.000 px no lado maior são reduzidas. Os arquivos são limitados a 10 MB no plano Free, 25 MB no Individual e 100 MB no Team, e os projetos a 100 MB no plano Free. |
Arquivos de projeto
| Formato | Sentido | O que cobre | Limites conhecidos |
|---|---|---|---|
| Backup do Holarch (.holarch) e arquivo de projeto (.json) | Importação e exportação | Um projeto inteiro para backup ou para movê-lo para outro servidor Holarch: itens, relacionamentos, diagramas, linhas de base, comentários, histórico e preferências do Início, com anexos e imagens. Um backup .holarch traz um checksum para cada parte e é checado antes de ser importado. É importado como um novo projeto do qual você é proprietário. Os formatos de backup e JSON são documentados. | Sempre um novo projeto; para mesclar em um projeto aberto, use a importação com mesclagem abaixo. |
| Mesclar em um projeto (.holarch, .json) | Importar | Backups e pacotes do Holarch com seus arquivos anexados, e exportações de projeto, do Banco de dados e de documentos do Holarch, mesclados no projeto aberto. Classes, atributos, rótulos e relacionamentos são associados pelo nome, e itens de esquema ausentes podem ser adicionados antes. Comentários, histórico e layouts de diagramas são levados quando escolhidos. | Scripts de simulação vindos de um arquivo são marcados como importados, e o simulador pergunta antes de executá-los. |
| Pacote de projeto (.holarch) | Exportar | Os itens escolhidos com seus relacionamentos, diagramas, comentários e esquema, e cada arquivo anexado, checados quanto a danos na importação. | Contém os itens escolhidos; linhas de base e histórico não são incluídos. |
| Esquema (.json) | Importação e exportação | As classes, relações, atributos e rótulos de um projeto. A importação mescla o que falta no projeto, ou substitui o esquema. | Nenhum listado. |
| Linhas de base e dados de documentos (.json) | Exportação; dados de documentos também são importados | Uma linha de base com sua data, documento, aprovações e snapshot. Os itens, relacionamentos e estado de um documento, que podem ser mesclados em outro projeto. | Nenhum listado. |
| Produtos DoDAF (JSON) e subconjunto DM2 PES (XML) | Exportar | A descrição da arquitetura, cada produto com seus dados e o dicionário. O XML grava o dicionário nos termos do DoDAF Meta Model. | O XML usa o namespace próprio do Holarch e não é validado com o esquema DM2 PES. |
| Cronograma do MS Project (.xml) | Exportar | As linhas de Gantt de uma execução de simulação como cronograma XML do MS Project. | Somente a partir de execuções do simulador. |
API e MCP
Scripts leem e alteram projetos pela API REST, com um token de acesso pessoal e uma descrição OpenAPI. Ferramentas de IA como o Claude se conectam pelo Model Context Protocol (MCP); suas mudanças chegam como propostas que você revisa antes de serem aplicadas. Consulte API e MCP.