SysML v2
Importazione di modelli SysML v1
Convertire un modello SysML 1.x da Cameo, MagicDraw, Enterprise Architect, Rhapsody o Papyrus in testo SysML v2, rivedere ciò che ha cambiato forma e importarlo in un progetto SysML v2.
In questa pagina
Panoramica
Un modello SysML 1.x si può portare in un progetto SysML v2. Holarch legge il file XMI del modello, lo converte in testo SysML v2, controlla il testo e mostra un report di conversione prima che qualcosa cambi.
- Input: un modello SysML 1.x come XMI (
.xmi,.uml,.xml) o un progetto Cameo o MagicDraw (.mdzip). - Output: testo SysML v2 nel progetto (un solo annullamento revoca tutto), o un nuovo progetto SysML v2.
- Report: ogni elemento v1 con il suo risultato, Convertito, Approssimato o Omesso, e il motivo.
La conversione segue la trasformazione da SysML v1 a SysML v2 della specifica OMG SysML 2.0, laddove un modello scambiato come XMI contiene dettagli sufficienti.
Concetti
Convertito, approssimato e omesso
Ogni elemento del modello v1 riceve un risultato:
- Convertito: l’elemento ha un corrispondente diretto in SysML v2, come un blocco che diventa una
part def. - Approssimato: l'elemento viene conservato in forma modificata. Per esempio, una full port tipizzata da un interface block diventa una porta, e una transizione attraverso un choice pseudostate diventa una transizione per ogni percorso.
- Omesso: SysML v2 non ha un equivalente, oppure l'elemento punta a qualcosa che non è nel file. Esempi sono flow final node, activity partition, use case extension e instance specification.
Il report spiega a parole il motivo di ogni elemento approssimato e omesso.
Il package SysMLv1Library
Alcune proprietà di SysML v1 non hanno una parola chiave SysML v2, come isEncapsulated di un block o una relazione refine. Il convertitore le conserva come metadati del package SysMLv1Library, per esempio @SysMLv1Library::RefineData { isRefine = true; }. Il package fa parte della libreria di Holarch, quindi questi nomi vengono risolti in ogni progetto SysML v2.
I corpi opachi diventano rappresentazioni testuali
Opaque behavior, opaque action, guardie e constraint specification contengono testo in un linguaggio come OCL o l'inglese. Il convertitore conserva ogni corpo come rappresentazione testuale: language "OCL" /* … */. I corpi in SysML o KerML vengono controllati come il resto del testo. Vedere Rappresentazioni testuali.
Come usarlo
Quando e perché
Usare l'importazione quando un team sposta un modello SysML 1.x esistente in SysML v2 o vuole riutilizzarne alcune parti. Il testo convertito è un punto di partenza: il report indica cosa esaminare a mano.
Importare un modello SysML v1 in un progetto
- Aprire un progetto SysML v2 e fare clic su Modello → Importazione ed esportazione.
- In Importa, scegliere In questo progetto o In un nuovo progetto SysML v2.
- Trascinare il file
.xmi,.uml,.xmlo.mdzipsul riquadro, oppure fare clic sul riquadro per sceglierlo. Compare una scheda di avanzamento con le fasi Lettura del file XMI…, Conversione in SysML v2… e Controllo del risultato…. - Leggere Conversione da SysML v1 in cima all'anteprima. Indica il numero di elementi convertiti, approssimati e omessi, e se il testo SysML v2 supera i controlli senza problemi.
- Usare Mostra per elencare gli elementi approssimati e omessi, solo uno dei due gruppi o tutti gli elementi. Ogni riga riporta l'elemento, il suo tipo SysML v1, il risultato con la parola chiave SysML v2 e il nome qualificato, e Perché.
- Aprire Mostra il testo SysML v2 per leggere il risultato prima di importarlo.
- Togliere la spunta ai package non desiderati nella tabella sottostante, quindi fare clic su Importa N package (o Crea progetto). Il modello viene importato, e un solo annullamento revoca tutto. Annulla lo rimuove di nuovo.
Importare una versione più recente dello stesso modello
Quando il modello SysML v1 cambia, esportarlo di nuovo e importare il nuovo file nello stesso progetto (In questo progetto). Ogni elemento convertito prende il proprio id dall'id dell'elemento nel file XMI (xmi:id), quindi l'importazione aggiorna gli elementi sul posto: un elemento rinominato o spostato in un altro package nello strumento SysML v1 resta lo stesso elemento, con layout dei diagrammi, commenti, collegamenti e cronologia. Il report indica quanti elementi prendono il proprio id dal modello SysML v1. Gli elementi senza nome (connettori, successioni) vengono abbinati in base alla loro posizione nel modello.
Un progetto importato da un modello SysML v1 prima che Holarch derivasse gli id dal file XMI mantiene i propri id: un'esportazione più recente ne aggiorna gli elementi per nome, e gli elementi nuovi nel modello SysML v1 prendono il loro id da esso.
Conservare il report e il testo
- Fare clic su Scarica report per un file CSV con ogni elemento, il suo risultato, il suo percorso SysML v2 e il motivo.
- Fare clic su Scarica testo SysML v2 per il file
.sysmlconvertito.
Esportare il modello dallo strumento SysML v1
- Cameo Systems Modeler e MagicDraw: importare direttamente il progetto
.mdzip, oppure usare File → Export To → Eclipse UML2 (v5.x) XMI File e importare il file.xmi. - Enterprise Architect: selezionare il package, scegliere Publish → Export XML, selezionare XMI 2.1 e importare il file
.xml. I file di progetto di Enterprise Architect (.eap,.qea) non si possono leggere direttamente. - IBM Rhapsody: esportare il modello con il toolkit XMI (XMI 2.x) e importare il file.
- Eclipse Papyrus: importare il file
.umldel modello.
Esempio guidato: il modello CubeSat EO-1
La demo CubeSat EO-1 è un progetto LML. La sua esportazione SysML v1 costituisce un modello di prova realistico.
- Aprire la demo CubeSat EO-1 ed esportarla come XMI UML/SysML nel formato OMG XMI 2.5.1 (vedere Esportare un modello UML/SysML (XMI)).
- Aprire un progetto SysML v2, fare clic su Modello → Importazione ed esportazione, scegliere In un nuovo progetto SysML v2 e trascinare il file
.xmi. Il report riporta: 1.042 elementi, 1.007 convertiti, 32 approssimati, 3 omessi. Il testo SysML v2 supera i controlli senza problemi. - Impostare Mostra su Omesso. Le tre righe sono una use case extension, che SysML v2 non ha, e due relazioni trace verso elementi senza nome, a cui il testo SysML v2 non può fare riferimento.
- Fare clic su Crea progetto. Il nuovo progetto SysML v2 si apre nell'Editor con struttura, funzioni, requisiti e tracce del satellite.
Suggerimenti ed errori comuni
- Importare un file XMI alla volta, senza altri file. Importare un file XMI SysML v1 alla volta, senza altri file.
- Dare un nome agli elementi verso cui si traccia. Le relazioni verso elementi senza nome vengono omesse, perché il testo SysML v2 fa riferimento agli elementi per nome.
- Reimportare, non ricreare. Importare un'esportazione più recente nello stesso progetto anziché in uno nuovo: gli elementi mantengono i loro id solo all'interno del progetto che li contiene.
- Controllare prima le approssimazioni. Sono i punti in cui il significato può differire dal modello v1, come porte tipizzate da block o estremità di connettori all'interno di parti.
- Gli elementi con lo stesso nome nello stesso punto vengono rinominati con un suffisso come
_2. Il report elenca ogni rinomina. - I requisiti conservati in uno strumento di gestione dei requisiti (DOORS, Polarion, Jama, codebeamer) arrivano come ReqIF, non come XMI. Importare il file
.reqifnella stessa pagina: diventa requisiti SysML v2 con lo stesso tipo di report (Importare ed esportare requisiti ReqIF).
Cosa viene convertito
| SysML v1 | SysML v2 |
|---|---|
| Modello, package | package |
| Blocco, attore | part def |
| Value type, data type, enumerazione | attribute def, enum def (i value type con un'unità SI nota specializzano la grandezza ISQ) |
| Signal | item def |
| Interface block | port def |
| Proprietà part, reference e value | part, ref part, attribute, con molteplicità e valori predefiniti |
| Proxy port, flow property | port, in/out item o attribute |
| Full port | part con @SysMLv1Library::PortData |
| Connettore, binding connector, item flow | connect, bind, flow |
| Generalizzazione | :> |
| Activity, call behavior action, pin | action def, action, parametri |
| Control flow e object flow, guardie | successioni con guardie if ed else, flussi tra parametri |
| Initial, final, decision, merge, fork, join | start, done, decide, merge, fork, join |
| State machine, stati, regioni | state def, state, stati paralleli |
| Transizioni, trigger di segnale e di tempo | transition con accept, accept after, guardie ed effetti |
| Interaction | occurrence def con lifeline e messaggi |
| Use case, subject, include | use case def, subject, include |
| Requirement (id e testo) | requirement <'id'> Name { doc /* text */ } |
| Satisfy, verify, derive requirement | satisfy, verify in un obiettivo di verifica, connessione di derivazione |
| Refine, trace | dependency con metadati SysMLv1Library |
| Allocate, dependency | allocate, dependency |
| Constraint block, constraint | constraint def, assert constraint |
| Stereotipi e tagged value | metadata def per ogni stereotipo, applicata con i suoi tag |
| Comment, documentation | doc, comment |
Limiti
- Un file di al massimo 64 MB.
- Al massimo 250.000 elementi, annidati al massimo su 512 livelli. Un modello annidato più in profondità, o con un ciclo di proprietà, non viene importato.
- Nel modello convertito, gli elementi annidati su più di 128 livelli vengono omessi con il motivo annidamento.
- Il testo convertito è al massimo di 8 MB.
- I diagrammi e il loro layout non vengono convertiti. Creare le viste nel progetto SysML v2.
Messaggi
| Messaggio | Che cosa fare |
|---|---|
| Importare un file XMI SysML v1 alla volta, senza altri file. | Importare il file XMI da solo. |
| <file> non contiene elementi UML o SysML. Esportare il modello come XMI 2.x e importarlo di nuovo. | Esportare di nuovo il modello come XMI 2.x. |
| Nessun modello UML trovato in <file>. In Cameo o MagicDraw, esportare il modello come Eclipse UML2 XMI e importare il file .xmi. | Esportare il progetto come XMI. |
| Il modello SysML v1 ha più di 250.000 elementi. Esportare una parte più piccola del modello. | Esportare un package alla volta. |
| Il testo SysML v2 convertito supererebbe 8 MB. Esportare una parte più piccola del modello. | Esportare un package alla volta. |
Pagine correlate
- Scambio di modelli SysML v2
- Importare ed esportare requisiti ReqIF: requisiti da DOORS, Polarion e altri strumenti di gestione dei requisiti.
- Notazione testuale SysML v2
- Conversione tra LML e SysML v2
SysML® e OMG® sono marchi registrati di Object Management Group, Inc. negli Stati Uniti e in altri paesi.