Da SysML v1 a SysML v2
Portare il proprio modello SysML v1 in SysML v2 senza ridisegnarlo.
Trascinare un modello SysML v1 salvato come XMI (.xmi, .xml, .uml) o come archivio di progetto .mdzip in un progetto SysML v2. Holarch lo converte in testo SysML v2, controlla il testo e riporta ogni elemento come convertito, approssimato od omesso, con il motivo, prima che venga importato qualsiasi cosa.
Il convertitore fa parte di ogni piano, Free compreso. I nuovi account iniziano una prova Individual di 30 giorni al primo accesso: 10.000 elementi per progetto, senza carta, ritorno a Free al termine. Si ha già un account? Avvia la prova.
La prova: il modello CubeSat EO-1
| Risultato | Elementi |
|---|---|
| Convertiti | 1,007 |
| Approssimati | 32 |
| Omessi | 3 |
| Elementi letti | 1,042 |
| Problemi nel testo SysML v2 | 0 |
Il testo convertito supera il controllo senza errori né avvisi, e lo stesso modello si converte ogni volta nello stesso testo. Che cosa è stato approssimato e omesso
Importare un modello SysML v1
Importare il file XMI di un modello SysML v1 o un progetto .mdzip in un progetto SysML v2. Prima che venga creato qualsiasi cosa, un report di conversione elenca ogni elemento come convertito, approssimato od omesso, con il motivo, e si salva come file CSV. L'esempio è il modello CubeSat EO-1: 1.042 elementi, importati senza problemi.
Che cosa si ottiene dal convertitore
Un modello SysML v2 su cui lavorare e un elenco chiaro di ciò che va rivisto.
Nessun ridisegno
I blocchi diventano part def, porte, connettori e flussi di elementi vengono trasferiti, i requisiti mantengono i loro id e il loro testo, e le relazioni satisfy, verify e allocate restano tracciate.
Un report di ogni elemento
Ogni elemento del modello v1 è elencato con il suo tipo v1, il risultato, il nome SysML v2 che ha assunto e, per tutto ciò che è stato approssimato od omesso, il motivo a parole. Filtrarlo sullo schermo o scaricarlo come CSV.
Controllato prima dell’importazione
Il motore che controlla l’Editor SysML v2 durante la digitazione controlla il testo convertito. Si vedono prima il risultato, il testo e il report; l’importazione è un unico passo di annullamento.
Reimportare quando il modello v1 cambia
Gli elementi prendono i loro id dagli id XMI del modello v1. Importando un’esportazione più recente nello stesso progetto, gli elementi si aggiornano sul posto, anche se sono stati rinominati o spostati, con i layout dei diagrammi, i commenti, i collegamenti e la cronologia.
Un modello su cui lavorare
L’Editor, le viste, i requisiti, la verifica e le altre pagine di un progetto SysML v2 leggono il modello convertito come qualsiasi altro.
Il modello v1 resta com’è
Holarch ne legge un’esportazione e non vi scrive mai, così il modello v1 resta il riferimento mentre il team esamina la versione SysML v2.
Come funziona
- Trascinare il file. In un progetto SysML v2, fare clic su Modello → Importazione ed esportazione, scegliere In questo progetto o In un nuovo progetto SysML v2 e trascinare il file
.mdzip,.xmi,.umlo.xml. Una scheda di avanzamento mostra lettura, conversione e controllo. - Esaminare il report. Conversione da SysML v1 fornisce i conteggi, indica se il testo supera il controllo senza problemi ed elenca gli elementi approssimati e omessi con il motivo di ciascuno. Mostra il testo SysML v2 apre il risultato; scaricare il report o il file
.sysmlper conservarli. - Importare. Togliere la selezione dai package che non si desiderano e importare. Un solo Annulla rimuove di nuovo l’intera importazione.
Passo per passo, con le impostazioni di esportazione di ogni strumento: Importare modelli SysML v1 nei Docs, e la guida alla migrazione per pianificare il passaggio di un intero programma.
Un blocco convertito
part def Rover {
@SysMLv1Library::BlockData { isEncapsulated = true; }
part battery : Battery;
part computer : Computer;
attribute 'power budget' : Types::Power = 120 [SI::W];
connection 'power bus' connect battery.'out' to computer.'in';
satisfy Requirements::'Power Margin' by battery;
flow 'power flow' of Types::Charge from battery.'out' to computer.'in';
}Output del convertitore per un blocco incapsulato con due parti, una proprietà di valore in watt, un connettore tra proxy port con un item flow e una relazione satisfy. La guida alla migrazione mostra l’intero piccolo modello, prima e dopo.
Che cosa legge
- SysML v1 come XMI 2.x: UML 2.5 con il profilo SysML 1.x.
.xmi: un file XMI..xml: XMI salvato con l’estensione.xml..uml: un file di modello XMI..mdzip: un archivio di progetto compresso che contiene il modello come XMI; Holarch legge l’XMI al suo interno.- Altri formati di progetto: uno strumento che conserva i modelli in un proprio formato di progetto esporta prima il modello come XMI.
Un file per importazione, fino a 64 MB, 250.000 elementi e 512 livelli di annidamento.
Che cosa produce
- Testo SysML v2 nel progetto aperto o in un nuovo progetto SysML v2, importato come un unico passo di annullamento.
- Un controllo del testo, mostrato prima dell’importazione.
- Un report di conversione di ogni elemento, filtrabile sullo schermo e scaricabile come CSV.
- Il file
.sysmlda scaricare, per la revisione o per un altro strumento SysML v2.
La conversione si basa sulla trasformazione da SysML v1 a SysML v2 della specifica OMG SysML 2.0.
Convertito, approssimato od omesso
Ogni elemento del modello v1 riceve uno di tre risultati, così si sa esattamente dove guardare.
Convertiti
L’elemento ha una controparte diretta in SysML v2. Un blocco diventa una part def, un interface block una port def, un requisito mantiene id e testo.
Approssimati
L’elemento viene conservato in forma modificata. Una full port tipizzata da un interface block diventa una porta; una transizione attraverso un choice diventa una transizione per ogni percorso; un’unità che non è un’unità SI mappata diventa un numero reale con l’unità nella sua documentazione.
Omessi
SysML v2 non ha una controparte, oppure l’elemento punta a qualcosa che non è nel file. Ne sono esempi i flow final node, le activity partition, le estensioni dei casi d’uso e le relazioni verso elementi senza nome.
Le proprietà SysML v1 senza una parola chiave SysML v2, come un blocco incapsulato, una full port o una relazione refine, vengono conservate come metadati del package SysMLv1Library, che Holarch carica in ogni progetto SysML v2. I propri stereotipi diventano definizioni di metadati con i loro tagged value, e i comportamenti opachi, le guardie e i vincoli mantengono il loro corpo come rappresentazioni testuali, ad esempio language "OCL" /* … */.
Che cosa si converte in che cosa
Le corrispondenze principali. I Docs le elencano tutte.
| SysML v1 | SysML v2 |
|---|---|
| Pacchetto | package, annidato come in v1 |
| Blocco, attore | part def |
| Value type, enumerazione | attribute def, enum def; un value type con un’unità SI nota specializza la grandezza ISQ |
| Proprietà part, reference e value | part, ref part, attribute, con molteplicità e valori predefiniti |
| Interface block, proxy port, flow property | port def, port, item o attribute con direzione |
| Connettore, binding connector, item flow | connect, bind, flow |
| Attività, azioni, flussi di controllo e di oggetti | action def, azioni, successioni con guardie, flussi tra parametri |
| Macchina a stati, stati, transizioni | state def, stati, transizioni con accept, guardie ed effetti |
| Requisito, satisfy, verify, derive | requirement con id e testo, satisfy, verify, connessioni di derivazione |
| Allocate, refine, trace | allocate; dependency con metadati SysMLv1Library |
| Caso d’uso, interazione, constraint block | use case def, occurrence def con messaggi, constraint def |
| Stereotipi e tagged value | metadata def per ogni stereotipo, applicata con i suoi tag |
Un esempio svolto: il modello CubeSat EO-1
La demo CubeSat EO-1 esportata come SysML 1.6 XMI e importata in un nuovo progetto SysML v2: 1.042 elementi letti, 1.007 convertiti, 32 approssimati, 3 omessi. Il testo SysML v2 supera il controllo senza errori né avvisi, e il nuovo progetto si apre con la struttura, le funzioni, i requisiti e le tracce del satellite. Ogni elemento approssimato e omesso, per motivo:
| Elementi | Risultato | Motivo |
|---|---|---|
| 10 connettori | Approssimati | Un’estremità del connettore si trova all’interno di una parte; il percorso fino a essa è stato ricavato dai tipi delle parti. |
| 8 transizioni | Approssimati | 4 trigger di cambiamento e di tempo, come when Undervoltage, sono conservati come documentazione; 4 eventi senza segnale, come Contact Start, hanno ricevuto una definizione di item con quel nome. |
| 6 item flow | Approssimati | Il nome è usato due volte nello stesso punto; il flusso è stato rinominato con un suffisso. |
| 5 value type | Approssimati | L’unità (%, GB, Mbps, mNms, W/m^2) non è un’unità SI mappata da Holarch; il value type è un numero reale con l’unità nella sua documentazione. |
| 2 flussi di controllo | Approssimati | Un ramo senza guardia accanto ad altri con guardia; ha ricevuto la guardia true. |
| 1 stato finale | Approssimati | Uno stato finale è diventato uno stato semplice. |
| 1 estensione di caso d’uso | Omessi | SysML v2 non ha estensioni dei casi d’uso. |
| 2 relazioni trace | Omessi | Puntano a elementi senza nome, a cui il testo SysML v2 non può fare riferimento. |
Il file EO-1 è l’esportazione SysML 1.6 di Holarch stesso, quindi usa la parte di SysML v1 che Holarch scrive. Un modello proveniente da un altro strumento di solito usa una parte più ampia del linguaggio, e i suoi numeri saranno diversi: la misura che conta è il report del proprio modello, che si vede prima che venga importato qualsiasi cosa. Anche i modelli di test di Holarch, scritti nelle forme XMI di diversi strumenti SysML v1, si convertono in testo che supera il controllo senza problemi, e lo stesso modello si converte ogni volta nello stesso testo.
Domande
Che cosa si perde nella conversione?
I diagrammi e il loro layout non vengono convertiti: creare viste nel progetto SysML v2 per i diagrammi che contano. Gli elementi per cui SysML v2 non ha una controparte vengono omessi, come le estensioni dei casi d’uso, i flow final node e le activity partition, e così le relazioni verso elementi senza nome, perché il testo SysML v2 fa riferimento agli elementi per nome (dare un nome agli elementi a cui si traccia prima di esportare). Gli elementi approssimati vengono conservati in forma modificata; sono i punti in cui il significato può differire dal modello v1, quindi vanno esaminati per primi. Il report li indica tutti, con il motivo.
Il modello convertito è pronto all’uso?
Supera il controllo senza problemi e ogni pagina di un progetto SysML v2 funziona con esso, ma va considerato un punto di partenza. Alcune differenze tra i linguaggi meritano una decisione di modellazione, non solo una traduzione. Che cosa supportano i progetti SysML v2, e le lacune note: Copertura del linguaggio SysML v2.
Quanto può essere grande il modello da convertire?
Un file di al massimo 64 MB, con al massimo 250.000 elementi annidati al massimo su 512 livelli, e al massimo 8 MB di testo convertito. Esportare un modello più grande un package alla volta. Al modello convertito si applicano gli elementi per progetto del piano: 1.000 con Free, 10.000 con Individual e 50.000 con Team. Vedere che cosa conta come elemento. Per un modello oltre 10.000 elementi, chiedere una valutazione Team.
Posso continuare a lavorare nel mio strumento SysML v1?
Sì. Holarch legge un’esportazione e non modifica mai il modello v1. Quando il modello v1 cambia, esportarlo di nuovo e importare il nuovo file nello stesso progetto: gli elementi prendono i loro id dal file XMI, quindi si aggiornano sul posto, anche dopo una ridenominazione o uno spostamento. Gli elementi con lo stesso nome nello stesso punto vengono rinominati con un suffisso come _2, e il report elenca ogni ridenominazione.
Dove va a finire il mio file?
Holarch legge e converte il file XMI o .mdzip nel browser; il file stesso non viene caricato. Su app.holarch.app il testo SysML v2 convertito viene inviato a Holarch per preparare l’anteprima, e viene salvato nel progetto solo al momento dell’importazione. Il servizio ospitato non accetta CUI né materiale soggetto a controllo delle esportazioni; per questi, Holarch funziona nel proprio ambiente (Enterprise). Maggiori informazioni in Sicurezza.
E i requisiti conservati in uno strumento di gestione dei requisiti?
Viaggiano come ReqIF (.reqif, .reqifz), il formato standard di interscambio dei requisiti. Holarch importa ed esporta ReqIF nei progetti LML e SysML v2. In un progetto SysML v2, un file ReqIF diventa requisiti, definizioni di requisito e package, con un report di ciò che è stato convertito, e i requisiti vengono riesportati con i loro identificativi originali. Nel nostro ciclo di andata e ritorno della demo CubeSat EO-1 da Holarch a ReqIF e ritorno, tutti i 407 elementi e i 979 valori di attributo sono tornati invariati. ReqIF nei progetti LML · ReqIF nei progetti SysML v2
Quanto costa il convertitore?
Niente in più: fa parte di ogni piano, Free compreso. I piani differiscono per elementi per progetto e per ciò che includono oltre alla modellazione; vedere Prezzi.
Integrare una migrazione nel proprio strumento?
Il convertitore fa parte dell’Holarch Language Engine, il motore alla base dei progetti SysML v2 di Holarch, ed è concesso in licenza a produttori di strumenti e integratori come componente aggiuntivo di migrazione. È lo stesso convertitore che funziona in Holarch.
- Il proprio prodotto legge il file XMI, il motore converte: inviare il modello v1 come JSON nella forma neutra documentata, e ricevere come JSON il testo SysML v2, il controllo del motore su di esso e il report di ogni elemento con un codice di motivo stabile e il nome SysML v2 che ha assunto.
- Funziona dove funziona il proprio prodotto: nel browser come WebAssembly in un Web Worker, o sul proprio server tramite Node.js o l’estensione Python con l’uso su server.
- Ripetibile e limitato: lo stesso modello si converte ogni volta nello stesso testo; modelli fino a 250.000 elementi, e uno più grande riceve una risposta di errore, mai un blocco.
- Attivato dal token di licenza, senza ricompilazione né modifiche al codice. La valutazione gratuita di 60 giorni funziona sul proprio computer con la documentazione e gli esempi.
Una richiesta e la sua risposta
// Request (the model shortened)
{ "op": "v1_convert",
"model": { "format": "holarch-xmi-model", … } }
// Answer (shortened)
{ "text": "package 'Rover Model' { … }",
"diagnostics": [],
"report": {
"summary": { "elements": 31, "converted": 27,
"approximated": 2, "dropped": 2 },
"items": [ { "kind": "Association",
"status": "dropped",
"reason": "association" }, … ] } }
La richiesta v1_convert nel riferimento API del motore. Il motore offre anche simulazione e uso su server come componenti aggiuntivi.
Vedere il proprio modello in SysML v2.
Convertirlo, leggere il report e importare solo quando si è soddisfatti.
I nuovi account iniziano una prova Individual di 30 giorni al primo accesso: 10.000 elementi per progetto, senza carta, ritorno a Free al termine. Si ha già un account? Avviare la prova in Impostazioni account → Piano e fatturazione.