SysML v2
Scambio di modelli SysML v2
Importare file .sysml, archivi zip e SysML v2 JSON in un progetto SysML v2 con un'anteprima, ed esportare il modello o un pacchetto come testo .sysml o SysML v2 JSON.
In questa pagina
- Panoramica
- Concetti
- Come usarlo
- Quando e perché
- Importare file in questo progetto
- Importare file in un nuovo progetto
- Aggiornare un package da una nuova versione
- Rinominare e spostare elementi nel testo mantenendone gli id
- Importazioni di grandi dimensioni sul servizio ospitato
- Esportare il modello o un package
- Importare ed esportare requisiti ReqIF
- Prelevare da un repository e inviarvi modifiche
- Esempio guidato: la demo Hybrid Car
- Suggerimenti e buone pratiche
- Errori comuni
- Come si collega alle altre funzionalità
- La pagina Importazione ed esportazione
- Repository
- Come vengono letti i file
- Messaggi
- Limiti
- Pagine correlate
Panoramica
I progetti SysML v2 scambiano modelli con altri strumenti SysML v2 come file. La pagina Importazione ed esportazione (Modello → Importazione ed esportazione) fa entrambe le cose:
- Importa legge file
.sysml, uno.zipdi file.sysmlo un file JSON SysML v2. Mostra un'anteprima di ciò che cambia, poi lo applica a questo progetto (un solo annullamento revoca tutto) oppure crea un nuovo progetto SysML v2. - Esporta scrive l'intero modello o un package come testo SysML v2 (
.sysml) o come JSON SysML v2 (.json). - I file ReqIF (
.reqif,.reqifz) provenienti da strumenti di gestione dei requisiti si importano come requisiti SysML v2, e i requisiti si esportano come ReqIF: vedere Importare ed esportare requisiti ReqIF.
È anche possibile creare un progetto direttamente dai file: in Gestisci progetti, fare clic su File di progetto ▾ → Importa file SysML v2….
Suggerimento: per mantenere il modello allineato a un repository di modelli SysML v2 che offre la Systems Modeling API, usare la sezione Repository della stessa pagina: vedere Prelevare da un repository e inviarvi modifiche.
Concetti
Formati di file
| Formato | Contenuto | Importazione | Esportazione |
|---|---|---|---|
Testo SysML v2 (.sysml) | La notazione testuale, un file per ogni package di primo livello. | Sì | Sì |
Archivio zip (.zip) | Più file .sysml. Le cartelle diventano package. | Sì | Sì, quando vengono esportati più file |
JSON SysML v2 (.json) | Un elenco piatto di elementi, ciascuno con @id e @type, come quello usato dalla Systems Modeling API. | Sì | Sì |
ReqIF (.reqif, .reqifz) | Requisiti con i loro attributi, la gerarchia e le relazioni, da DOORS, Polarion, Jama, codebeamer e altri strumenti di gestione dei requisiti. | Sì, convertiti in requisiti | Sì, i requisiti |
I file KerML (.kerml) non vengono ancora importati.
Id e corrispondenze
Ogni elemento di un progetto SysML v2 ha un id. I due formati lo conservano in modo diverso:
- Il JSON conserva gli id. Un elemento importato di nuovo dal JSON corrisponde all'elemento con lo stesso id.
- I riferimenti alla libreria standard vengono riconosciuti. Il JSON della Systems Modeling API, della SysML v2 Pilot Implementation o di un altro repository nomina gli elementi della libreria standard (unità come
ISQ::mass,ScalarValues::Real,Parts::Part) con gli id standard. L'importazione li legge come gli stessi elementi della libreria, quindi unità e tipi restano risolti. - Il testo conserva gli id quando lo si richiede. Spuntare Includi id degli elementi quando si esporta testo
.sysml. Ogni definizione, uso e package con nome riporta allora il suo id come prima riga del corpo,@HolarchMetadata::ElementId { id = "…"; }. Quando quel testo viene importato di nuovo, ogni elemento con un id corrisponde all'elemento con lo stesso id, anche se è stato rinominato, spostato in un altro proprietario o in un altro package di primo livello, oppure riordinato. Le sue posizioni nei diagrammi, i commenti, le tracce e i collegamenti restano. - Il testo senza id viene abbinato per nome. Holarch abbina i package di primo livello per nome, e gli elementi al loro interno per nome e posizione. Gli id vengono mantenuti dove gli elementi corrispondono. Un elemento rinominato viene ancora abbinato se mantiene la sua posizione; un elemento rinominato e spostato contemporaneamente diventa un nuovo elemento.
L'esportazione lo segnala sotto i controlli di esportazione: “Gli id degli elementi sono conservati nel JSON. Nel testo .sysml, spuntare Includi id degli elementi per conservarli: gli elementi mantengono così le posizioni nei diagrammi, i commenti e le tracce quando il testo modificato viene importato di nuovo, anche dopo una ridenominazione o uno spostamento. Senza id, gli elementi vengono abbinati per nome.”
Id degli elementi nel testo
@HolarchMetadata::ElementId { id = "…"; } è un normale metadato SysML v2: ElementId è una definizione di metadati nel package di libreria proprio di Holarch HolarchMetadata (nella Libreria standard sotto Holarch), accanto a TBD e TBR. Gli altri strumenti SysML v2 leggono la riga come un'annotazione di metadati; per risolverne il nome hanno bisogno di HolarchMetadata.sysml di quella libreria.
- L'id appartiene all'elemento il cui corpo contiene la riga. Gli elementi senza nome (connessioni, successioni, commenti) non portano id e vengono abbinati in base al contenuto, come prima.
- Holarch non conserva la riga come elemento. L'Editor mostra il modello senza queste righe, e un elemento il cui corpo conteneva solo la riga viene mostrato come
part engine : Engine;. - Gli id devono essere univoci. Quando lo stesso id compare due volte (per esempio dopo aver copiato un blocco nel testo), il primo elemento lo mantiene e la copia diventa un nuovo elemento.
- Un id che non è un UUID (per esempio
"R-17") viene trasformato in un UUID fisso, così la stessa stringa dà sempre lo stesso elemento, come in un'importazione JSON. - Un id che il progetto non ha viene mantenuto per il nuovo elemento. Eliminare un elemento in Holarch e importare di nuovo il testo lo riporta indietro con il suo vecchio id.
- Nell'Editor, una riga incollata funziona all'interno del package che si sta modificando: un id che appartiene a un elemento di un altro package lì viene ignorato, e l'elemento viene abbinato per nome. Per spostare elementi tra package mantenendone gli id, esportare con gli id e importare i file modificati.
La definizione di parte Car della demo Hybrid Car porta una riga di questo tipo nel suo file sorgente, quindi il suo id è lo stesso in ogni copia della demo.
Le cartelle diventano package
In un archivio zip, ogni cartella diventa un package che contiene i suoi file e le sue sottocartelle. Un file powertrain/engine.sysml all'interno dell'archivio viene letto come se fosse scritto all'interno di package powertrain { … }. I file al livello superiore dell'archivio vengono letti così come sono. Cartelle e file vengono letti in ordine di nome.
Cosa confronta l'anteprima
L'anteprima ha una riga per ogni package di primo livello (oppure, per un nuovo progetto, per ogni elemento di primo livello). Ogni riga ha un risultato:
| Risultato | Significato | Importato per impostazione predefinita |
|---|---|---|
| Nuovo | Il progetto non ha un package con quel nome (o id). Viene aggiunto. | Sì |
| Modificato | Il progetto ha il package; l'importazione aggiunge, modifica o rimuove elementi al suo interno. Il dettaglio indica quanti, per esempio “3 aggiunti, 1 modificato (id mantenuti dove gli elementi corrispondono)”. | Sì |
| Invariato | Il package è uguale a quello di questo progetto. | No (niente da fare) |
| Conflitto | Il package non può essere unito. Il dettaglio spiega perché e cosa fare. | No |
Come usarlo
Quando e perché
Usare Importazione ed esportazione quando un modello passa tra Holarch e un altro strumento SysML v2, o tra progetti Holarch:
- Avviare un progetto Holarch da un modello scritto altrove.
- Introdurre un package mantenuto da un altro team, come una libreria di componenti, e aggiornarlo quando inviano una nuova versione.
- Consegnare un package a un fornitore o a uno strumento che legge testo o JSON SysML v2.
- Tenere i file
.sysmlnel proprio sistema di controllo delle versioni accanto al progetto Holarch.
Importare file in questo progetto
- Aprire Modello → Importazione ed esportazione.
- In Importa, scegliere In questo progetto.
- Rilasciare i file sulla zona di rilascio, oppure fare clic su di essa e sceglierli.
Compare “Lettura dei file…”, poi l'anteprima: il numero di package di primo livello e di file, gli eventuali problemi e una tabella con Importa, Package, Elementi e Risultato.
- Leggere l'elenco dei problemi, se presente. Indica ogni file e riga che non viene analizzata e ogni file che è stato saltato.
- Togliere la spunta ai package che non si vogliono importare. Per sostituire un package in conflitto per nome, spuntarlo.
Con un piano che ha un limite di elementi, l'anteprima conta gli elementi che il progetto avrebbe dopo l'importazione (le relazioni non contano). Se il numero supera il limite, l'anteprima lo segnala, per esempio “Questa importazione porterebbe il progetto a 1.804 elementi; il piano Free ne consente 1.000.”, e Importa N package resta disattivato finché non si toglie la spunta a un numero sufficiente di package. Nulla viene applicato o inviato al server. Le importazioni in un nuovo progetto vengono verificate allo stesso modo rispetto al limite per progetto del proprio piano.
- Fare clic su Importa N package.
Il messaggio riporta “Importati N package.” La pagina riporta “Importati N package (M elementi). Annulla ripristina l'importazione in un solo passo.” Fare clic su Apri testo per vederli.
Importare file in un nuovo progetto
- Aprire Modello → Importazione ed esportazione e scegliere In un nuovo progetto SysML v2.
- Trascinare o scegliere i file.
L'anteprima elenca gli elementi di primo livello, tutti spuntati.
- Togliere la spunta a quelli che non si vogliono e modificare il Nome del progetto. Per impostazione predefinita è il nome dell'unico file o del primo package.
- Fare clic su Crea progetto.
Il nuovo progetto si apre nell'Editor.
Da Gestisci progetti, File di progetto ▾ → Importa file SysML v2… fa lo stesso in un solo passo. Se alcune parti dei file non si possono leggere, chiede prima: “Trovati N problemi: alcune parti dei file vengono omesse. Creare il progetto con il resto? Per vedere prima i problemi, aprire un progetto SysML v2 e usare Importazione ed esportazione.” Fare clic su Crea progetto per continuare.
Aggiornare un package da una nuova versione
- Esportare o ricevere la nuova versione come file
.sysmlo JSON. - Importarla In questo progetto.
Il package mostra Modificato, con il numero di elementi aggiunti, modificati e rimossi.
- Fare clic su Importa 1 package.
Gli elementi corrispondenti mantengono i loro id, quindi i collegamenti a essi (collegamenti dei requisiti, rischi, layout delle viste, commenti) restano. Gli elementi che non sono più nel file vanno nel Cestino.
Rinominare e spostare elementi nel testo mantenendone gli id
- Esportare i package come Testo SysML v2 con Includi id degli elementi spuntato.
- Modificare i file: rinominare elementi, spostarli in altri proprietari o in un altro file di package, riordinarli. Mantenere ogni riga
@HolarchMetadata::ElementIdall'interno del corpo del suo elemento. - Importare i file modificati In questo progetto.
I package mostrano Modificato. Gli elementi rinominati e spostati contano come modificati, non come aggiunti e rimossi.
- Fare clic su Importa N package.
Gli elementi mantengono i loro id: posizioni nei diagrammi, commenti, tracce e collegamenti restano. Gli elementi spostati in un altro package lasciano il package in cui si trovavano.
Importazioni di grandi dimensioni sul servizio ospitato
Nel servizio ospitato, un'importazione di 5.000 elementi o più viene applicata dal server, non dal browser. Quando ogni package spuntato è Nuovo o sostituisce un Conflitto, il server legge i file da sé (i passi seguenti). Quando un package spuntato è Modificato, il browser calcola l'unione come di consueto e carica le modifiche una sola volta; il server le scrive poi in un solo passo, con la stessa scheda di avanzamento, Annulla importazione e Annulla importazione.
- Scegliere i file e controllare l'anteprima come per qualsiasi importazione.
- Fare clic su Importa N package (o Crea progetto).
I file vengono caricati una sola volta. Il server li legge con gli stessi controlli e gli stessi id degli elementi dell'anteprima e scrive il risultato in un solo passo.
- Seguire la scheda di avanzamento in fondo alla finestra: mostra la fase (caricamento, lettura, controllo, applicazione, aggiornamento dell'indice del progetto) e il tempo rimanente.
È possibile lasciare la pagina o chiudere la scheda. L'importazione continua sul server e, alla successiva apertura del progetto, il risultato è presente. Ogni copia aperta del progetto si ricarica quando l'importazione viene applicata; le modifiche non inviate vengono inviate di nuovo dopo il ricaricamento.
- Gli altri membri vedono “Nome sta importando file…” nella stessa scheda e nella pagina Importazione ed esportazione.
- Un'importazione alla volta: una seconda importazione di grandi dimensioni nello stesso progetto attende che la prima sia terminata.
- Annulla importazione (chi l'ha avviata, o un proprietario) interrompe l'importazione prima che venga applicata. Nulla viene modificato.
- Annulla importazione: ⌘Z / Ctrl+Z nel browser non revoca un'importazione sul server. Fare clic su Annulla importazione nella pagina Importazione ed esportazione per riportare il progetto allo stato precedente all'ultima importazione. Lo stato precedente all'annullamento resta in Cronologia, quindi le modifiche fatte dopo l'importazione si possono recuperare da lì.
- Attività del progetto e Cronologia elencano l'importazione come una sola voce della persona che l'ha avviata.
Esportare il modello o un package
- Aprire Modello → Importazione ed esportazione.
- In Esporta, scegliere cosa esportare: L'intero modello o un package tramite il suo nome qualificato.
- Scegliere il formato: Testo SysML v2 (.sysml; un .zip per più package) o JSON SysML v2 (.json).
- Per un testo da modificare e importare di nuovo, spuntare Includi id degli elementi.
- Fare clic su Esporta.
Viene scaricato un file, o uno zip quando l'esportazione contiene più file. Il messaggio riporta “Esportato <file>.” o “Esportati N file come zip.”
Per esportare rapidamente un package, usare il Browser: il menu della riga di un package contiene Esporta come .sysml ed Esporta come JSON.
Importare ed esportare requisiti ReqIF
ReqIF è il formato di scambio degli strumenti di gestione dei requisiti. Un file ReqIF viene importato come un package di requisiti SysML v2 e i requisiti vengono esportati di nuovo come ReqIF, così uno strumento di gestione dei requisiti e un progetto SysML v2 possono scambiarsi gli stessi requisiti in entrambe le direzioni.
Importare un file ReqIF:
- Aprire Modello → Importazione ed esportazione (oppure fare clic su Importa… nella pagina Requisiti, o scegliere Importa ReqIF… in ⌘K / Ctrl+K).
- Trascinare il file
.reqifo.reqifzsul riquadro, oppure fare clic sul riquadro per sceglierlo. Un file ReqIF per importazione. - Il pannello ReqIF mostra il numero di requisiti, capitoli e relazioni, quanti sono stati convertiti, approssimati od omessi, e se il testo SysML v2 supera i controlli senza problemi.
- In Nomi brevi da, scegliere ID esterno (il numero che si vede nello strumento di origine, come
SRS-12) o Identificatore ReqIF (l'id interno dello strumento). I requisiti senza ID esterno prendono l'identificatore. - In Tipi di relazione, scegliere cosa diventa ogni tipo di relazione: Deriva, Raffina, Dipendenza o Ometti. L'anteprima viene ricalcolata e la scelta viene conservata per la successiva importazione dello stesso file.
- Fare clic su Importa 1 package. Un solo annullamento revoca l'intera importazione. Il messaggio riporta “Importati N requisiti da <title>.”
Cosa crea l'importazione:
| ReqIF | SysML v2 |
|---|---|
| Requisito (spec object) | requirement, con l'ID esterno o l'identificatore come nome breve, il nome e il testo come doc |
| Tipo di requisito | requirement def, con un attributo per ogni attributo ReqIF |
| Tipo di dato enumerazione | enum def |
| Attributo di stato (Draft, Proposed, Approved e così via) | Lo stato del requisito in Holarch |
| Titolo di capitolo | package con il numero del capitolo come nome breve |
| Requisito annidato | requirement annidato |
| Relazione derived from | Connessione di derivazione |
| Relazione refines | Dipendenza con l'annotazione Refinement |
| satisfies, verified by e altre relazioni | Dipendenza (il report spiega perché) |
| Specifica | package all'interno del package del file |
Le tabelle diventano righe di testo con | tra le celle, gli elenchi diventano righe che iniziano con un trattino, e formattazione e link conservano solo il loro testo; questi requisiti sono Approssimati. Immagini e oggetti incorporati non vengono importati; il requisito che ne conteneva uno viene elencato con il motivo, così da potervi allegare il file. Scarica report salva ogni requisito e relazione con il relativo risultato in CSV; Scarica testo SysML v2 salva il testo.
Importare una copia più recente del file: importarla nello stesso progetto. Holarch trova il package dell'importazione precedente e confronta requisito per requisito:
- I requisiti mantengono i loro id degli elementi, quindi diagrammi, collegamenti satisfy e verify, revisioni e Cronologia restano collegati. I requisiti rinominati e spostati vengono aggiornati sul posto.
- I requisiti assenti dal nuovo file vengono conservati. Spuntare Rimuovi gli N requisiti assenti da questo file per spostarli nel Cestino.
- Parti, casi di verifica e collegamenti aggiunti in Holarch vengono conservati.
- Un requisito modificato solo in Holarch mantiene la propria modifica. Un requisito modificato sia qui sia nel file prende il testo del file; il testo precedente resta nella Cronologia. L'anteprima li elenca in Modificati qui e nel file.
Esportare come ReqIF:
- In Esporta, scegliere un package o L'intero modello, e ReqIF (.reqif) o Archivio ReqIF (.reqifz).
- Fare clic su Esporta. Il messaggio riporta “Esportati N requisiti come <file>.”
Esporta… → Requisiti (ReqIF) nella pagina Database o Requisiti esporta allo stesso modo i requisiti elencati (o selezionati).
Il file contiene il nome breve di ogni requisito (come ReqIF.ForeignID), il nome, il doc (come XHTML), lo stato e i valori degli attributi, la gerarchia dei package come specifica e le relazioni derive, refine e di dipendenza. I requisiti importati da ReqIF mantengono identificatori, tipi e tipi di relazione originali, così lo strumento di origine aggiorna i propri requisiti invece di aggiungerne copie; esportando e importando di nuovo il file, ogni package risulta Invariato. I valori calcolati degli attributi vengono scritti come testo. I collegamenti satisfy e verify restano in Holarch: ReqIF non ha parti né casi di verifica.
Prelevare da un repository e inviarvi modifiche
Collegare il progetto a un ramo di un repository di modelli SysML v2 per leggerne l'ultimo commit e inviare indietro le proprie modifiche.
- Aprire Modello → Importazione ed esportazione e trovare la sezione Repository.
- Inserire l'Indirizzo del repository (l'indirizzo https della sua Systems Modeling API) e, se il repository lo richiede, il Token di accesso.
- Fare clic su Carica progetti, quindi scegliere il Progetto e il Ramo. Per avviare un nuovo progetto del repository da questo modello, fare invece clic su Nuovo progetto del repository.
- Fare clic su Pull…. Holarch legge l'ultimo commit del ramo ed elenca ogni differenza: Nuovo, Modificato, Rimosso o Conflitto. Quando non c'è nulla da prelevare, compare “Aggiornato: nessuna modifica nel repository.”
- Togliere la spunta alle differenze che non si vogliono, quindi fare clic su Applica pull. Un solo annullamento revoca l'intero pull.
- Dopo aver modificato il modello, fare clic su Push. Le modifiche dall'ultimo commit sincronizzato vanno nel ramo come un unico nuovo commit. Compare, per esempio, “Inviati 3 modificati come commit 1a2b3c4d.”
Un Conflitto è un elemento modificato sia qui sia nel repository dall'ultima sincronizzazione. Un conflitto senza spunta mantiene la versione di questo progetto.
Nota: un push viene rifiutato quando il ramo ha commit che questo progetto non ha prelevato: “Il ramo del repository ha commit che questo progetto non ha prelevato. Eseguire prima il pull, poi di nuovo il push.”
Esempio guidato: la demo Hybrid Car
Creare prima la demo: in Gestisci progetti, fare clic su File di progetto ▾ → Nuovo progetto demo → Hybrid Car (SysML v2).
- Aprire Modello → Importazione ed esportazione. In Esporta, scegliere L'intero modello e Testo SysML v2, quindi fare clic su Esporta.
Viene scaricato uno zip con un file per ogni package di primo livello, come
Vehicles.sysml,VehicleRequirements.sysml,VehicleBehavior.sysmleVehicleViews.sysml. - Aprire
VehicleRequirements.sysmlin un editor di testo. Cambiareattribute maxCurbMass : MassValue = 1650 [kg];in1600 [kg]e salvare. - Tornati in Importazione ed esportazione, scegliere In questo progetto e trascinare
VehicleRequirements.sysml.L'anteprima mostra VehicleRequirements come Modificato, con il numero di elementi modificati. Gli altri package non sono nel file, quindi non vengono elencati.
- Fare clic su Importa 1 package.
Il valore cambia nel modello. Il requisito Sedan Mass (VR-1.1) nomina
maxCurbMass, quindi i suoi collegamenti vengono contrassegnati per la revisione (vedere Requisiti e verifica nei progetti SysML v2). Premere ⌘Z / Ctrl+Z per annullare l'importazione. - Per avviare un secondo progetto dagli stessi file, scegliere In un nuovo progetto SysML v2, trascinare lo zip e fare clic su Crea progetto.
Suggerimenti e buone pratiche
- Usare JSON per spostare un modello tra strumenti SysML v2 quando gli id contano, per esempio quando l'altro strumento conserva i collegamenti tramite id. Usare il testo quando le persone leggono o revisionano i file; spuntare Includi id degli elementi quando il testo torna in Holarch dopo la modifica.
- Omettere gli id nel testo consegnato a persone che si limitano a leggerlo: le righe ne aggiungono una per elemento.
- Mantenere un package di primo livello per file. L'esportazione scrive i file in questo modo e un'importazione successiva confronta quindi package per package.
- Importare un package di un altro team nel suo package di primo livello. Gli aggiornamenti toccano poi solo quel package.
- Controllare l'elenco dei problemi prima di importare. I membri che non vengono analizzati sono omessi.
Errori comuni
- Un package mostra Conflitto: “Esiste un package denominato X con altri id.” Il progetto ha un package con quel nome che non è stato importato da questo JSON. Spuntare la riga per sostituirlo (il vecchio package va nel Cestino), oppure importare in un nuovo progetto.
- “L'importazione contiene due package di primo livello denominati X; viene importato solo il primo.” Due file dichiarano lo stesso package di primo livello. Unirli in un unico file o rinominarne uno.
- Un elemento rinominato è stato importato come nuovo. Il testo non aveva id degli elementi e l'elemento è stato rinominato e spostato contemporaneamente (o sono cambiati sia il tipo sia il nome). Esportare con Includi id degli elementi, apportare la modifica e importare di nuovo.
- Mancano elementi dopo l'importazione. Un membro che non viene analizzato è omesso: “Questo membro non viene analizzato ed è omesso.” Correggere la riga indicata nell'elenco dei problemi, quindi importare di nuovo.
- Un'importazione JSON viene rifiutata. Importare un file JSON SysML v2 alla volta, senza file
.sysml.
Come si collega alle altre funzionalità
- Editor: i package importati si aprono lì; i file esportati sono il testo che si vede lì.
- Annulla e Cestino: un solo annullamento revoca un'intera importazione in questo progetto; gli elementi che rimuove o sostituisce vanno nel Cestino.
- Controllo delle modifiche: valori e documentazione che cambiano tramite un'importazione contrassegnano i collegamenti dei requisiti per la revisione, come qualsiasi altra modifica.
- File di progetto Holarch: Esporta questo progetto… in Gestisci progetti salva l'intero progetto Holarch, con rischi, documenti e altri dati Holarch.
.sysmle JSON contengono solo il modello. - Conversione: per spostare un modello tra LML e SysML v2, creare una copia convertita (vedere Conversione tra LML e SysML v2).
La pagina Importazione ed esportazione
Importazione
| Controllo | Uso |
|---|---|
| In questo progetto | Unisce i file nel progetto aperto. Non disponibile per chi può solo visualizzare il progetto; per queste persone, le importazioni creano un nuovo progetto. |
| In un nuovo progetto SysML v2 | Crea un nuovo progetto dai file. |
| Area di rilascio | “Trascinare qui i file o fare clic per sceglierli”. Accetta file .sysml, un .zip di file .sysml o un file JSON SysML v2. |
| Tabella di anteprima | Importa (casella di spunta), Package (nome e tipo), Elementi (numero), Risultato (Nuovo, Modificato, Invariato o Conflitto, con un dettaglio). |
| Nome del progetto | (Solo nuovo progetto) Il nome del nuovo progetto, fino a 200 caratteri. |
| Importa N package / Crea progetto | Applica l'importazione. |
| Annulla | Chiude l'anteprima senza importare. |
Gli elementi fuori da qualsiasi package nel testo .sysml vengono elencati insieme in una riga, Fuori dai package.
Quando il modello cambia mentre un'anteprima è aperta (un'altra scheda, un collaboratore o Annulla), l'anteprima viene ricalcolata.
Esportazione
| Controllo | Uso |
|---|---|
| Esporta (ambito) | L'intero modello, o qualsiasi package tramite nome qualificato. |
| come (formato) | Testo SysML v2 (.sysml; un .zip per più package) o JSON SysML v2 (.json). |
| Includi id degli elementi | (Solo testo; disattivato per impostazione predefinita) Scrive l'id di ogni elemento con nome nel testo come @HolarchMetadata::ElementId { id = "…"; }, così una copia modificata e importata di nuovo mantiene gli id anche dopo rinomine e spostamenti. |
| Esportazione | Scarica il file. |
L'esportazione di testo scrive un file per ogni package di primo livello, con il suo nome (Vehicles.sysml). Gli elementi fuori dai package vanno in Outside packages.sysml. L'esportazione JSON scrive un file con il nome del progetto o del package.
Repository
La sezione Repository collega il progetto a un ramo di un repository che offre la Systems Modeling API.
- Indirizzo del repository: l'indirizzo https dell'API del repository. Holarch si connette solo a indirizzi https su host pubblici; gli amministratori del sito possono limitare host e porte.
- Token di accesso: memorizzato in forma cifrata per il proprio account e questo progetto e inviato solo a quell'indirizzo. Non viene mai più mostrato; lasciare il campo vuoto per mantenere il token memorizzato.
- Carica progetti, Progetto e Ramo: scegliere dove sincronizzare. Nuovo progetto del repository crea un progetto nel repository per questo modello.
- Pull…, Applica pull: leggere l'ultimo commit, esaminare le differenze e applicarle; un solo annullamento revoca tutto. Holarch confronta con l'ultimo commit sincronizzato, così può distinguere le proprie modifiche da quelle del repository.
- Push: inviare le modifiche dall'ultimo commit sincronizzato come un unico commit. “Nulla da inviare: il modello corrisponde all'ultimo commit sincronizzato.” significa che non c'è nulla di nuovo.
- Impostazioni… modifica la connessione. Disconnetti rimuove il token memorizzato e lo stato di sincronizzazione; il modello resta.
- Le operazioni sul repository richiedono il ruolo di editor. I lettori non possono eseguire pull o push.
- I push vengono rifiutati per i progetti con marcature di dati regolamentati.
Come vengono letti i file
- I file vengono controllati prima di leggere qualsiasi cosa: dimensioni, numero, annidamento e lunghezza dei testi.
- In uno zip, i file nascosti e le cartelle
__MACOSXvengono ignorati. Link, file diversi da.sysmle una seconda copia dello stesso percorso vengono saltati, e l'elenco dei problemi spiega perché. - Il testo deve essere UTF-8. È consentito un byte-order mark.
- Ogni elemento importato viene controllato prima di essere scritto. Un elemento rifiutato porta con sé i membri che possiede; l'elenco dei problemi li conta.
- In JSON, gli elementi di tipi che Holarch non interpreta vengono conservati come sono stati importati: vedere Elementi che Holarch non interpreta.
Elementi che Holarch non interpreta
Il JSON SysML v2 può contenere tipi di elementi che Holarch non modella, come behavior, step o interaction di KerML. Holarch li conserva invece di ometterli:
- Ciascuno resta nel modello con il suo id, nome, proprietario e il suo JSON originale, comprese le relazioni (tipizzazioni, specializzazioni e altre) e ciò che possiedono. I suoi membri lo mantengono come proprietario.
- Il Browser mostra il tipo originale con un'etichetta Non interpretato; puntare sull'etichetta per la spiegazione. L'ispettore mostra il tipo, l'id nel file e a cosa puntano le relazioni.
- Non può essere rinominato né modificato in Holarch. Modificarlo nello strumento da cui proviene e importarlo di nuovo. È possibile spostarlo o eliminarlo.
- Non ha testo SysML. L'Editor lo omette dal testo, insieme a tutto ciò che possiede, e una nota sopra il testo indica quanti elementi non sono mostrati. La modifica del testo non li rimuove mai. Anche un'esportazione
.sysmlli omette. - Un'esportazione JSON lo riscrive invariato. Viene adeguato solo ciò che è cambiato nel modello: un membro eliminato o aggiunto, un membro rinominato o un nuovo proprietario.
- L'anteprima dell'importazione elenca ogni tipo conservato una volta, come nota, per esempio 2 elementi Behavior vengono conservati come importati. Le note non sono problemi.
Non conservati: lo spazio dei nomi radice senza nome in cui alcuni strumenti racchiudono un'intera esportazione (i suoi membri diventano elementi di primo livello) e gli elementi non supportati all'interno di un valore, che vengono elencati come problemi. Un elemento il cui JSON supera 256 KB conserva solo tipo e id.
Messaggi
| Messaggio | Significato e soluzione |
|---|---|
| Scegliere file .sysml, un .zip di file .sysml o un file JSON SysML v2. | Non è stato scelto alcun file. |
| Nessun file .sysml trovato. Scegliere file .sysml, un .zip di file .sysml o un file JSON SysML v2. | L'archivio o la selezione non contiene file .sysml. |
| Importare un file JSON SysML v2 alla volta, senza file .sysml. | Sono stati scelti più file JSON, o JSON insieme a testo. |
| <file> non è un file ReqIF (…). Esportarlo dallo strumento di origine come ReqIF 1.0 o successivo e importarlo di nuovo. | Il file non è XML ReqIF, oppure contiene un DOCTYPE, che Holarch non legge. |
| <file> non contiene requisiti (nessun elemento SPEC-OBJECT). Esportare le specifiche con i loro oggetti e importare di nuovo il file. | Il file ReqIF ha tipi ma nessun requisito. |
| <title> ha N requisiti, più di quanti ne accetti un'importazione (circa M). Esportare le specifiche come file ReqIF separati. | Il testo SysML v2 supererebbe il limite di 8 MB. Importare le specifiche un file alla volta. |
| <file> non è testo UTF-8. Salvarlo come UTF-8 e importarlo di nuovo. | Convertire la codifica del file. |
| <file> non è un archivio ZIP valido. Creare di nuovo l'archivio. | L'archivio è danneggiato. |
| <file> contiene file cifrati. Creare l'archivio senza password. | Gli archivi protetti da password non vengono letti. |
| <path> è compresso più di 200:1, il che è tipico di una zip bomb. Creare di nuovo l'archivio. | L'archivio è stato rifiutato per sicurezza. |
| L'archivio usa un metodo di compressione non supportato. Crearlo con la compressione ZIP standard. | Usare la compressione standard (deflate). |
| I file KerML non vengono ancora importati. | I file .kerml vengono saltati. |
| Da un archivio vengono importati solo i file .sysml. | Gli altri file in uno zip vengono saltati. |
| I link non vengono importati. | I link simbolici in uno zip vengono saltati. |
| L'archivio contiene questo file due volte; viene importata la prima copia. | Due voci hanno lo stesso percorso. |
| <file> non è JSON valido. Esportare di nuovo il modello. | Il file JSON è danneggiato. |
| <file> non è JSON SysML v2 (un elenco di elementi con @id e @type). Scegliere un'esportazione JSON SysML v2. | Il JSON è in un altro formato. |
| La riga N di <file> supera 64 KB. Spezzare la riga, quindi importare di nuovo il file. | Le righe molto lunghe vengono rifiutate. |
| Questo membro non viene analizzato ed è omesso. | Correggere la riga indicata nell'elenco dei problemi. |
| Un elemento con questo id si trova all'interno di <element> in questo progetto. Spostarlo prima al primo livello, oppure importare in un nuovo progetto. | (Conflitto) Il package di primo livello del JSON esiste già più in profondità nel modello. |
| N id di elementi di questo package sono usati altrove in questo progetto. Importare invece in un nuovo progetto. | (Conflitto) Il JSON riutilizza id di altri elementi. |
| Il testo del package non viene analizzato dopo la stampa. Importarlo in un nuovo progetto. | (Conflitto) Non è stato possibile unire il package. |
| N elementi <kind> vengono conservati come importati (non interpretati): … | (Nota) Gli elementi di un tipo che Holarch non interpreta vengono conservati invariati. Vedere Elementi che Holarch non interpreta. |
| Un elemento di tipo <kind> all'interno di un valore non è supportato ed è omesso. | Un valore (un'espressione) contiene un elemento che Holarch non sa leggere. Il resto del valore viene conservato come testo. |
| Un elemento di tipo <kind> è troppo grande per essere conservato per intero; vengono conservati solo tipo e id. | Il suo JSON supera 256 KB. |
| L'importazione non è stata applicata: … Nulla è stato modificato. | L'importazione non è riuscita; il progetto è invariato. |
| Il modello è vuoto. Aggiungere un package, quindi esportare di nuovo. | Non c'è nulla da esportare. |
| Il package da esportare non esiste più. Sceglierne un altro. | Il package è stato eliminato mentre la pagina era aperta. |
Limiti
| Limite | Valore |
|---|---|
| File per importazione | 2,000 |
Testo .sysml per importazione (decompresso) | 8 MB |
| Archivio zip | 16 MB, 10.000 voci |
| Annidamento delle cartelle in uno zip | 32 cartelle |
| Elementi per importazione (testo o JSON) | 100,000 |
| File JSON | 24 MB, annidamento di 64 livelli |
| JSON di un elemento che Holarch non interpreta | 256 KB, annidamento di 12 livelli |
| Lunghezza della riga | 64 KB |
File ReqIF (.reqif, o .reqif all'interno di un .reqifz) | 64 MB; il testo SysML v2 che produce deve rientrare nel limite di 8 MB per il testo (circa da 8.000 a 20.000 requisiti) |
- Le risposte del repository sono limitate a 64 MB per un intero pull e ogni operazione sul repository si interrompe dopo 120 secondi.
- Ogni account può eseguire al massimo 300 operazioni sul repository all'ora.
- I file KerML (
.kerml) non vengono ancora importati. - Nell'app ospitata, il server legge le importazioni fino a 1,5 MB di testo
.sysml. Le importazioni più grandi vengono lette nel browser, con lo stesso risultato. - I dati Holarch accanto al modello (stato dei requisiti, rischi, budget, impostazioni del simulatore, layout delle viste) non fanno parte dei file
.sysmlo JSON. Per conservarli, usare Esporta questo progetto… in Gestisci progetti.
Pagine correlate
- L'Editor di testo e il Browser
- Conversione tra LML e SysML v2
- Primi passi con i progetti SysML v2
- Importazione di modelli SysML v1: XMI da strumenti SysML 1.x, convertito in SysML v2.
- Importazione ed esportazione per i progetti LML (compreso ReqIF in LML) e i file di progetto Holarch.
SysML® e OMG® sono marchi registrati di Object Management Group, Inc. negli Stati Uniti e in altri paesi.