Importazione ed esportazione
Formati di importazione ed esportazione
Portare specifiche, fogli di calcolo, file di interscambio dei requisiti e modelli in un progetto Holarch, ed estrarre il modello come documenti, tabelle, immagini, file di interscambio e file di progetto completi. Questa pagina elenca ogni formato, in quale direzione funziona, che cosa trasporta e i suoi limiti noti.
Come funzionano importazioni ed esportazioni
- Le esportazioni sono aperte a ogni membro del progetto, lettori compresi. Le importazioni richiedono il ruolo Proprietario o Editor, perché modificano il progetto.
- Un’importazione dalla pagina Importazione ed esportazione mostra un’anteprima, assegna nuovi ID agli elementi importati ed è un unico passo di annullamento. Per aggiornare elementi esistenti invece di aggiungerne di nuovi, abbinarli per ID, nome o numero.
- Il contenuto importato viene ripulito: il testo formattato perde script e link non sicuri, le immagini SVG perdono script e riferimenti esterni, e l’XML con dichiarazioni DOCTYPE o ENTITY viene rifiutato.
- Le esportazioni CSV neutralizzano il testo che un foglio di calcolo eseguirebbe come formula. I nomi dei file vengono ripuliti per ogni sistema operativo.
- Ogni progetto è un progetto LML o un progetto SysML v2. Le importazioni da Word, fogli di calcolo, testo e ReqIF sono per i progetti LML. I progetti SysML v2 importano testo e JSON SysML v2, e modelli SysML 1.x come XMI o .mdzip, convertiti in SysML v2. Anche i progetti LML importano XMI. I file di progetto, e le esportazioni Word, Excel e CSV delle pagine condivise, funzionano in entrambi.
Vai a: Requisiti e specifiche · Modelli · Fogli di calcolo e tabelle · Documenti e report · Immagini · File di progetto · API e MCP
Requisiti e specifiche
| Formato | Direzione | Cosa copre | Limiti noti |
|---|---|---|---|
| Word (.docx) | Importazione | Una specifica diventa un documento numerato. I titoli diventano Statements annidati per livello; i paragrafi con «shall», «must», «will» o «should» e le voci di elenchi numerati diventano Requirements. Le tabelle diventano un elemento per riga, oppure restano tabelle in una descrizione. Grassetto, corsivo, elenchi e immagini vengono mantenuti, le revisioni inserite vengono lette e il file originale viene allegato. | Le immagini in EMF, WMF e in formati diversi da PNG, JPEG, GIF, WebP e SVG vengono saltate. Il testo eliminato con revisioni non viene importato. |
| Testo semplice (.txt o incollato) | Importazione | Le righe numerate e le frasi con «shall» diventano un documento numerato di Statements e Requirements. La numerazione della struttura viene rilevata o scelta: decimale, romana, lettere, livelli misti, stile DoD o uno schema personalizzato. | La struttura deriva solo da numerazione e formulazione. |
| ReqIF (.reqif, .reqifz) | Importazione ed esportazione | Importazione: ogni SPEC-OBJECT diventa un elemento, con la gerarchia della specifica, il suo tipo come classe e gli attributi stringa, XHTML, booleani, data, enumerazione, interi e reali. Le SPEC-RELATION diventano relazioni; satisfy, verify e deriveReqt diventano satisfies, verifies e traced from; trace e refine diventano traced to. Esportazione dal Database o da un documento: un tipo per classe con numero, nome, descrizione e ogni attributo, le relazioni come SPEC-RELATION e la scomposizione come gerarchia. | I tipi di relazione senza corrispondenza diventano traced to; i collegamenti che lo schema non consente vengono saltati con un avviso. |
Modelli
| Formato | Direzione | Cosa copre | Limiti noti |
|---|---|---|---|
| XMI UML e SysML 1.x (.xmi, .uml, .xml, .mdzip) | Importazione ed esportazione | Importazione: XMI 2.x con UML 2.5 e il profilo SysML da 1.3 a 1.7, e archivi di progetto .mdzip. Requisiti con id e testo, block, part, port, value property, value type con unità, generalizzazioni, connettori e item flow, activity con il loro flusso di controllo, macchine a stati con stati paralleli e transizioni choice, junction, fork e join, diagrammi di sequenza, test case, package, stereotipi e tagged value. Satisfy, verify, deriveReqt, refine, trace, copy e allocate diventano relazioni di Holarch. I diagrammi a blocchi, a blocchi interni, di macchina a stati e di azione vengono disegnati dal modello importato. Esportazione: XMI SysML 1.6 (XMI 2.5.1) per Cameo/MagicDraw, Enterprise Architect e Rhapsody, oppure Papyrus (Eclipse UML, .uml) per Papyrus, con requisiti, block, part, port, value type con unità, constraint block, connettori con item flow, activity, casi d’uso, test case, macchine a stati e le relazioni di tracciabilità. Gli elementi importati mantengono i loro id XMI e l’esportazione li riscrive, quindi importare una versione successiva dello stesso modello aggiorna gli elementi invece di aggiungerne copie. Con attributi ed etichette di Holarch attivi, il file si reimporta in Holarch senza perdite. | I layout dei diagrammi e le operazioni non vengono importati; la revisione elenca ciò che viene tralasciato. Il flusso di un’activity viene disegnato solo quando è ben strutturato. Artifact, task, rischi, problemi, decisioni, elementi di tempo e di costo non vengono esportati. |
| Sorgente Java (.java) | Importazione | In un diagramma delle classi: classi, interfacce ed enum diventano Assets, i campi diventano Characteristics e i metodi diventano Actions con i loro parametri e risultati come Input/Outputs. | Un file o un sorgente incollato alla volta. |
| Testo SysML v2 (.sysml, o un .zip di file .sysml) | Importazione ed esportazione | Importazione in un progetto SysML v2 o in uno nuovo, con un’anteprima per package: nuovo, modificato, invariato o in conflitto. Le cartelle di uno zip diventano package. Esportazione dell’intero modello o di un package; più package vengono scaricati come zip. | Il testo non contiene id degli elementi, quindi una reimportazione abbina gli elementi per nome. I file KerML (.kerml) non vengono importati. Fino a 2.000 file, 8 MB di testo e uno zip da 16 MB per importazione; il testo deve essere UTF-8. |
| SysML v2 JSON (.json) | Importazione ed esportazione | L’elenco piatto di elementi con @id e @type usato dalla Systems Modeling API. Gli id degli elementi vengono mantenuti, quindi una reimportazione abbina per id. | Fino a 24 MB e 100.000 elementi. I tipi di elemento che Holarch non interpreta vengono mantenuti come importati, contrassegnati come Non interpretato, e riscritti invariati. |
| Repository di modelli SysML v2 | Pull e push | Collegare un progetto SysML v2 a un ramo di un repository che offre la Systems Modeling API. Prelevare l’ultimo commit ed esaminare ogni differenza prima di applicarla; inviare le proprie modifiche come un unico commit. | Solo indirizzi https su host pubblici. Un push viene rifiutato finché il ramo ha commit non prelevati. 64 MB per pull, 120 secondi per operazione e 300 operazioni per account all’ora. Richiede il ruolo Editor. |
| Systems Modeling API in Holarch | Lettura e commit da altri strumenti | Altri strumenti SysML v2 leggono gli elementi di un progetto SysML v2 come SysML v2 JSON tramite REST, con un token di accesso personale, ed eseguono commit di modifiche in rami di richieste di modifica. | main è di sola lettura; i commit vanno in richieste di modifica che un approvatore applica in Holarch. Solo le teste dei rami; niente tag, merge o query salvate. |
| Da SysML v1 a SysML v2 (.xmi, .uml, .xml, .mdzip) | Importazione | Un modello SysML 1.x da Cameo o MagicDraw, Enterprise Architect, Rhapsody o Papyrus viene convertito in testo SysML v2, controllato e importato in un progetto SysML v2 o in uno nuovo come un unico passo di annullamento. Un rapporto di conversione elenca ogni elemento come convertito, approssimato o tralasciato, con il motivo, e si scarica come CSV. | I diagrammi e il loro layout non vengono convertiti. Le relazioni verso elementi senza nome vengono tralasciate. |
| Da LML a SysML v2 e ritorno | Copia convertita, in entrambe le direzioni | Un nuovo progetto nell’altro linguaggio: Assets, port, Conduits, Input/Outputs, requisiti, collegamenti satisfy, casi di test, Actions con il loro flusso, stati ed equazioni. Rischi, decisioni, task, documenti, lavagne, stato dei requisiti e risultati dei test vengono riportati. Un rapporto elenca che cosa è stato convertito e che cosa no, e si scarica come CSV. | Layout dei diagrammi, cronologia, baseline e richieste di modifica non vengono convertiti. Gli elementi per cui un linguaggio non ha posto, come Measures e Resources di LML o calcoli e analysis case di SysML v2, sono elencati nel rapporto. |
I dati di Holarch accanto a un modello SysML v2, come stato dei requisiti, rischi, budget e layout delle viste, non fanno parte dei file .sysml o SysML v2 JSON. Un’esportazione del progetto li conserva.
Fogli di calcolo e tabelle
| Formato | Direzione | Cosa copre | Limiti noti |
|---|---|---|---|
| Excel (.xlsx, .xlsm) e CSV | Importazione | Elementi nuovi o aggiornati di qualsiasi classe, con una mappatura delle colonne proposta a partire dalle intestazioni. Attributi, etichette, relazioni, gerarchia da una colonna padre o dai numeri, e nuovi attributi creati dai dati. Abbinare gli elementi esistenti per ID, nome o numero per aggiornarli. | Excel 97-2003 (.xls) e CSV separato da punto e virgola non vengono letti. Nomi e numeri vengono troncati a 255 caratteri. |
| Excel e CSV dal Database | Esportazione | Qualsiasi insieme di elementi come tabella con attributi e relazioni scelti, con gerarchia e aggregazioni, come definizioni, come matrice delle relazioni, come cronologia delle modifiche o come commenti. | Le celle di Excel contengono fino a 32.000 caratteri; il testo più lungo viene troncato. |
| Excel e CSV da altre pagine | Esportazione | RVTM, VCRM, RVM, RTM, RSM e TVM; risultati della qualità dei requisiti; registro TBD/TBR; registro delle interfacce; matrici N² e I²; budget e TPM; registro dei rischi; studi di trade-off; tabelle di analisi funzionale; confronti tra baseline; dati dei grafici; timeline, registri degli eventi ed esecuzioni del simulatore. | Ogni pagina esporta le proprie colonne. |
| Matrice di tracciabilità (.xlsx, .csv) | Importazione ed esportazione | Esportare qualsiasi relazione come matrice. Modificare la cartella di lavoro in un foglio di calcolo e reimportarla: l’anteprima elenca i collegamenti da aggiungere, quelli da rimuovere e le celle saltate. | L’importazione aggiunge e rimuove collegamenti solo tra elementi esistenti. Le celle che lo schema non consente vengono saltate ed elencate. |
Documenti e report
| Formato | Direzione | Cosa copre | Limiti noti |
|---|---|---|---|
| Word (.docx) | Esportazione | Documenti e strutture con gli stili di titolo di Word, contrassegni, copertine e numeri di pagina; redline con revisioni tra baseline; scomposizioni di entità; report di diagrammi; ICD; casi di test; RVTM e matrici di tracciabilità; riepiloghi di studi di trade-off; report di analisi funzionale; il pacchetto di architettura DoDAF. | Le pagine sono in formato US Letter. |
| PowerPoint (.pptx) | Esportazione | Presentazioni, una diapositiva per pagina, con caselle di testo, forme e note del relatore. Le presentazioni si esportano anche in HTML e Word. | Nessuno indicato. |
| Markdown (.md) | Esportazione | Un documento come titoli e testo Markdown. | Nessuno indicato. |
| HTML | Esportazione | Pagine web di diagrammi, report di diagrammi, grafici, presentazioni e matrici di tracciabilità. | Nessuno indicato. |
| Stampa e PDF | Esportazione | Documenti, tabelle e diagrammi tramite la finestra di stampa del browser, che salva in PDF. Le lavagne esportano direttamente in PDF. | Le pagine PDF delle lavagne sono immagini. |
Immagini
| Formato | Direzione | Cosa copre | Limiti noti |
|---|---|---|---|
| PNG e SVG | Esportazione | Diagrammi, grafici, diapositive, pannelli del simulatore e schede della galleria. PNG a una scala scelta, con o senza sfondo; SVG come immagine vettoriale scalabile. | Nessuno indicato. |
| Lavagne: PNG, JPG, SVG, PDF | Esportazione | Una tavola, una selezione, la vista corrente, una cornice o tutte le tavole. SVG mantiene forme e testo modificabili negli strumenti vettoriali. | Le pagine PDF sono immagini. |
| Immagini e file allegati | Importazione | Immagini nel testo formattato, immagini delle entità, attributi file, lavagne e diapositive. Grafica PNG, JPEG o SVG per i prodotti DoDAF, come un OV-1 con aree attive. | Le immagini oltre 4.000 px sul lato più lungo vengono ridotte. I file sono limitati a 10 MB con il piano Free, 25 MB con Individual e 100 MB con Team, e i progetti a 100 MB con il piano Free. |
File di progetto
| Formato | Direzione | Cosa copre | Limiti noti |
|---|---|---|---|
| Backup Holarch (.holarch) e file di progetto (.json) | Importazione ed esportazione | Un intero progetto, per il backup o per spostarlo su un altro server Holarch: elementi, relazioni, diagrammi, baseline, commenti, cronologia e preferenze della Home, con allegati e immagini. Un backup .holarch contiene un checksum per ogni parte e viene controllato prima dell’importazione. Si importa come nuovo progetto di cui si è proprietari. I formati backup e JSON sono documentati. | Sempre un nuovo progetto; per unire in un progetto aperto, usare l’importazione con unione qui sotto. |
| Unione in un progetto (.holarch, .json) | Importazione | Backup e pacchetti Holarch con i loro file allegati, ed esportazioni di progetti, Database e documenti Holarch, uniti nel progetto aperto. Classi, attributi, etichette e relazioni vengono abbinati per nome, e gli elementi di schema mancanti possono essere aggiunti prima. Commenti, cronologia e layout dei diagrammi vengono inclusi se scelti. | Gli script di simulazione provenienti da un file vengono contrassegnati come importati, e il simulatore chiede conferma prima di eseguirli. |
| Pacchetto di progetto (.holarch) | Esportazione | Gli elementi scelti con le loro relazioni, diagrammi, commenti e schema, e ogni file allegato, controllati per danni all’importazione. | Contiene gli elementi scelti; baseline e cronologia non sono incluse. |
| Schema (.json) | Importazione ed esportazione | Classi, relazioni, attributi ed etichette di un progetto. L’importazione unisce ciò che manca al progetto, oppure sostituisce lo schema. | Nessuno indicato. |
| Baseline e dati dei documenti (.json) | Esportazione; i dati dei documenti si importano anche | Una baseline con la sua data, il documento, le approvazioni e l’istantanea. Gli elementi, le relazioni e lo stato di un documento, che si possono unire in un altro progetto. | Nessuno indicato. |
| Prodotti DoDAF (JSON) e sottoinsieme DM2 PES (XML) | Esportazione | La descrizione dell’architettura, ogni prodotto con i suoi dati e il dizionario. L’XML scrive il dizionario nei termini del DoDAF Meta Model. | L’XML usa lo spazio dei nomi proprio di Holarch e non viene validato rispetto allo schema DM2 PES. |
| Pianificazione MS Project (.xml) | Esportazione | Le righe Gantt di un’esecuzione di simulazione come pianificazione XML di MS Project. | Solo dalle esecuzioni del simulatore. |
API e MCP
Gli script leggono e modificano i progetti tramite la REST API, con un token di accesso personale e una descrizione OpenAPI. Strumenti di IA come Claude si collegano tramite il Model Context Protocol (MCP); le loro modifiche arrivano come proposte da esaminare prima che vengano applicate. Vedere API e MCP.