Holarch

SysML v2

Conversione tra LML e SysML v2

Creare una copia SysML v2 di un progetto LML, o una copia LML di un progetto SysML v2, con un resoconto di ciò che viene convertito e di ciò che non lo è.

Come usarlo →

In questa pagina
  1. Panoramica
  2. Concetti
    1. Una copia, non un cambio di tipo
    2. Come si corrispondono i due linguaggi
    3. I dati Holarch vengono copiati
    4. Cosa non viene convertito
  3. Come usarlo
    1. Quando e perché
    2. Creare una copia convertita
    3. Controllare la copia
    4. Esempio guidato: la demo Hybrid Car come copia LML
    5. Suggerimenti e buone pratiche
    6. Errori comuni
  4. Riferimento del report
    1. Da LML a SysML v2
    2. Da SysML v2 a LML
    3. CSV del report
  5. Messaggi
  6. Limiti
  7. Pagine correlate

Panoramica

Il tipo di un progetto, LML o SysML v2, viene fissato alla creazione. Per lavorare su un modello LML in SysML v2, o su un modello SysML v2 con le pagine LML, creare una copia convertita:

  • Crea una copia SysML v2… su un progetto LML scrive il suo modello come testo SysML v2 in un nuovo progetto SysML v2.
  • Crea una copia LML… su un progetto SysML v2 trasforma il suo modello in entità e relazioni LML in un nuovo progetto LML.

Il progetto originale non viene mai modificato. Prima che la copia venga creata, un report elenca ciò che viene convertito, con i conteggi, e ciò che non lo è, con il motivo. Lo stesso report viene salvato nel nuovo progetto.

Concetti

Una copia, non un cambio di tipo

La conversione crea sempre un nuovo progetto. È possibile continuare a lavorare nell'originale e convertire di nuovo in seguito; ogni conversione crea un altro nuovo progetto. Nulla collega la copia all'originale.

Come si corrispondono i due linguaggi

LML e SysML v2 descrivono molte delle stesse cose in modi diversi. La conversione usa questa corrispondenza in entrambe le direzioni:

LMLSysML v2
AssetDefinizione di parte, con un uso di parte ovunque venga usata
Scomposizione di un Asset (decomposed by)Uso di parte nella definizione del genitore
PortUso di porta
Characteristic di un AssetUso di attributo
ConduitUso di connessione, o uso di interfaccia quando entrambe le estremità sono porte
Input/OutputDefinizione di item, con parametri item in e out e flussi
Requirement (Number, Name, Description)Uso di requisito (nome breve, nome, doc)
satisfied bysatisfy
Test CaseUso di verifica con un obiettivo verify
Test SuitePackage di casi di verifica
Action, con il suo flussoUso di azione con successioni
SYNC e blocchi paralleliFork e join
ORDecide e merge
LOOPAzione di ciclo
performed byperform
Caratteristiche di stato e transizioniDefinizione di stato con transizioni, che la parte esibisce
Equation e le sue variabiliDefinizione di vincolo con i suoi parametri

I dati Holarch vengono copiati

Alcuni dati non hanno posto in nessuno dei due linguaggi. Sono dati Holarch e vengono copiati con i loro collegamenti:

  • Rischi, decisioni, attività, costi, pianificazioni, problemi, documenti e lavagne vengono copiati e restano collegati agli elementi convertiti.
  • Lo stato dei requisiti e i metodi di verifica restano con ogni requisito; i risultati dei test restano con ogni caso di test. Vengono conservati anche gli stati personalizzati dei flussi di lavoro delle classi.
  • Le modifiche allo schema vengono riportate in entrambe le direzioni, compresi i flussi di lavoro delle classi con i loro stati, stati ritirati, transizioni e approvatori.
  • I commenti di discussione seguono il loro elemento.
  • Le probabilità dei rami delle decisioni restano con i rami, per il Simulatore.
  • Una copia LML creata da una copia SysML v2 recupera gli attributi e le etichette LML conservati dalla prima conversione.

Cosa non viene convertito

  • Layout dei diagrammi. Viste e diagrammi vengono disegnati da zero nella copia.
  • Cronologia, baseline e richieste di modifica. La copia inizia senza di esse.
  • Elementi per cui un linguaggio non ha posto, come Measure e Resource di LML, o enumerazioni, calcoli e casi di analisi di SysML v2.

Il report nomina ognuno di questi elementi e ne indica il motivo. Vedere Riferimento del report.

Come usarlo

Quando e perché

Convertire quando il linguaggio del progetto non è più adatto al lavoro:

  • Da LML a SysML v2: il team o un cliente ora lavora in SysML v2, oppure il modello deve essere scambiato con strumenti SysML v2. Convertire, quindi esportare .sysml o JSON (vedere Scambio di modelli SysML v2).
  • Da SysML v2 a LML: serve una pagina o un diagramma LML che i progetti SysML v2 non hanno, oppure si vuole il modello nella forma di ciclo di vita di Holarch per una revisione.

Convertire quando il modello è stabile e leggere il report prima di fare affidamento sulla copia.

Creare una copia convertita

  1. In Gestisci progetti, fare clic su ⋯ nella riga del progetto.
  2. Scegliere Crea una copia SysML v2… (per un progetto LML) o Crea una copia LML… (per un progetto SysML v2).

    Holarch controlla la conversione; in un progetto grande una barra di avanzamento in fondo alla finestra riporta “Controllo della conversione…”. Poi si apre la finestra di dialogo con il report.

  3. Leggere il report:
    • Convertito elenca ogni tipo di elemento, quanti ce ne sono e cosa diventa, per esempio “Requisiti 24 usi di requisito”.
    • Non convertito elenca ogni tipo di elemento che non viene convertito, quanti sono e perché.
  4. Fare clic su Scarica report (CSV) per salvare il report con una riga per elemento, se serve fuori da Holarch.
  5. Inserire il Nome del nuovo progetto. Per impostazione predefinita è il nome dell'originale seguito da “(SysML v2)” o “(LML)”.
  6. Fare clic su Crea copia.

    Il messaggio riporta “Creato “<name>””. La copia si apre sulla sua pagina Home.

  7. Aprire il documento Report di conversione nella copia. Elenca ogni elemento che non è stato convertito, per numero e nome.

Controllare la copia

  1. In una copia SysML v2, aprire Modello → Editor.

    Il modello è un unico package di primo livello con il nome del progetto. Contiene i package Architecture, System, Items, Requirements, Verification, Behavior, Constraints e Views (solo quelli che hanno contenuto).

  2. Cercare i segni di problema nel margine. Se il testo convertito ha problemi, la finestra di dialogo lo ha segnalato prima della creazione della copia: “Il testo convertito ha N problemi. La copia li mostra nel suo Editor.”
  3. Aprire le viste in Viste (Architecture Overview, System Connections) per vedere la struttura disegnata da zero.
  4. In una copia LML, aprire il Database e i diagrammi per controllare Asset, Requirement e flussi di azioni.

Esempio guidato: la demo Hybrid Car come copia LML

Creare prima la demo: in Gestisci progetti, fare clic su File di progetto ▾ → Nuovo progetto demo → Hybrid Car (SysML v2).

  1. In Gestisci progetti, fare clic su ⋯ in Hybrid Car (SysML v2 demo) e scegliere Crea una copia LML…. La copia si chiamerà “Hybrid Car (SysML v2 demo) (LML)”.
  2. Leggere il report.

    In Convertito: gli usi di parte diventano Asset, gli usi di porta Port, gli attributi Characteristic, gli usi di connessione e di interfaccia Conduit, gli usi e le definizioni di requisito Requirement, gli usi di verifica Test Case, le azioni Action, e stati e transizioni i loro equivalenti LML.

    In Non convertito, tra gli altri:

    • Specializzazioni: LML non ha specializzazione; le parti ricevono una copia delle feature delle loro definizioni generali. SportCar :> Car è una di queste.
    • Ridefinizioni: la feature che ridefinisce sostituisce quella ereditata in ogni parte copiata. La batteria della berlina viene copiata con 48 kg.
    • Enumerazioni (DriveMode, FuelKind): i valori degli attributi vengono conservati come testo.
    • Calcoli (PowerToWeight, ElectricRange) e casi di analisi (PowerToWeightAnalysis).
    • Connettori di binding (bind output = transmission.output;): LML non ha binding tra feature.
    • Valori degli attributi: conservati come testo nel Value di ogni Characteristic; unità ed espressioni non vengono valutate.
    • Viste: i diagrammi vengono disegnati da zero nella copia LML.
  3. Fare clic su Crea copia.

    Si apre la copia LML. fleet.sedan e le sue parti sono Asset; il requisito Sedan Mass (VR-1.1) è un Requirement soddisfatto dall'Asset della berlina. Anche rischi, decisioni e attività della demo vengono copiati, collegati agli elementi convertiti.

Per provare la direzione opposta, creare la demo CubeSat EO-1 (un progetto LML) e scegliere Crea una copia SysML v2… su di essa.

Suggerimenti e buone pratiche

  • Riordinare un progetto LML prima di convertirlo: collegare ogni Conduit a esattamente due Asset o Port, associare ogni Characteristic a un Asset o a una Equation e rimuovere le Test Suite vuote. Altrimenti vengono segnalati come non convertiti.
  • In LML, scrivere le etichette dei rami OR come espressioni booleane sui valori del modello (come speed > 3) se si vuole che diventino guardie. Le altre etichette diventano commenti doc sulle successioni.
  • In SysML v2, assegnare agli attori un tipo di definizione di parte e ai parametri item un tipo di definizione di item. Quelli senza tipo non vengono convertiti.
  • Conservare l'originale. Dopo modifiche importanti, convertire di nuovo da esso anziché modificare entrambi i progetti in parallelo.

Errori comuni

  • Aspettarsi che l'originale cambi. Non cambia. La copia è un progetto separato.
  • Aspettarsi che i diagrammi mantengano il layout. I layout non vengono convertiti; disporre di nuovo le nuove viste o i nuovi diagrammi.
  • Parti mancanti in una copia LML. Una definizione di parte che nessuna parte usa non ha un Asset in LML, perché LML ha solo istanze. Usare la definizione in una parte, quindi convertire di nuovo.
  • Un elemento “non si risolve” nel report. Un nome nel testo SysML v2 non punta a nulla. Correggere il nome nell'Editor, quindi convertire di nuovo.

Riferimento del report

Da LML a SysML v2

Gli elementi convertiti comprendono Asset (definizioni di parte con i relativi usi di parte), Characteristic (attributi), Port, Conduit (connessioni o interfacce), Input/Output (definizioni di item), Requirement, Action e casi d'uso, flussi di item tra azioni, State, Transition, Equation (definizioni di vincolo), Performs, Test Suite, Test Case, Verifies, Satisfies, ed elementi Holarch (copiati con i loro collegamenti): artefatti, statement, attività, rischi, voci di pianificazione, costi, problemi, decisioni, pericoli e modi di guasto. I flussi di lavoro delle classi (le modifiche allo schema del progetto) vengono riportati con i loro stati personalizzati, transizioni e approvatori, così requisiti e casi di test mantengono i loro valori di Status personalizzati. La copia mantiene le impostazioni Programma formale e Sicurezza e affidabilità del progetto.

Non convertitoMotivo
Asset in un ciclo di scomposizioneUn asset che contiene se stesso non ha posto in un albero di parti. La sua definizione di parte viene convertita; non viene usata come parte.
Conduit senza esattamente due estremitàUna connessione SysML unisce due estremità. Collegare il conduit a due asset o porte, quindi convertire di nuovo.
Elementi trasferiti da un conduitIn questa conversione le connessioni non trasportano item. Gli item vengono convertiti come definizioni di item e flussi tra azioni.
Conduit scomposti in altri conduitQui le connessioni SysML non vengono annidate; ogni conduit diventa una connessione a sé.
Conteggi e script dei cicliUn ciclo SysML qui si ripete finché vale una condizione; il conteggio viene conservato come dato Holarch e ripristinato da Crea una copia LML.
Etichette e probabilità dei rami delle decisioniQuando ogni etichetta di una decisione è un'espressione booleana sui valori del modello, le etichette diventano le sue guardie; altrimenti diventano commenti doc sulle successioni. Le probabilità vengono conservate come dati Holarch per il Simulatore, ed entrambe vengono ripristinate da Crea una copia LML.
Elementi OR, SYNC e LOOPI costrutti vengono convertiti come nodi decide/merge, fork/join e loop; gli elementi che li nominavano non vengono conservati.
Azioni entry, do ed exit degli statiLe azioni vengono convertite come azioni; questa conversione non compila i corpi degli stati SysML.
Transizioni senza due stati della stessa macchinaUna transizione SysML unisce due stati della stessa definizione di stato.
Guardie e trigger delle transizioniIn LML sono scritti come testo libero; vengono conservati come dati Holarch, non come espressioni SysML, e ripristinati da Crea una copia LML.
Stati non specificati da un assetUno stato richiede l'asset di cui descrive il comportamento.
Espressioni delle equazioniLe espressioni usano nomi che non sono feature SysML; ciascuna viene conservata come commento nella sua definizione di vincolo.
Test suite senza casi di testUna suite diventa il package dei suoi casi di verifica; una suite vuota non ha nulla da contenere.
Casi di test che verificano qualcosa di diverso da un requisitoUn caso di verifica SysML verifica solo requisiti.
Cicli di testLe esecuzioni di test registrate su una suite non fanno parte del modello; viene conservato l'ultimo risultato di ogni caso.
Requisiti soddisfatti da altri tipi di elementiPer esempio, in SysML un requisito non soddisfa un altro requisito; usare la derivazione nel testo.
Altre relazioniQuesta conversione non ha una relazione SysML per esse; il report le nomina una per una.
MeasureLe misure di efficacia non hanno un elemento SysML in questa conversione.
ResourceLe quantità di risorse (consumes, produces) appartengono al simulatore LML e qui non hanno un elemento SysML.
Characteristic non associate a un asset o a un'equazioneUn attributo richiede un proprietario: specificarlo tramite un asset o renderlo una variabile di equazione.
Elementi di altre classiQuesta classe non ha un elemento SysML né un posto Holarch in un progetto SysML v2.
Feature e configurazioniNon ancora: le funzionalità e le configurazioni di una linea di prodotti non diventano punti di variazione, varianti e configurazioni SysML v2. Il report le elenca come elementi Feature ed elementi Configuration; modellare di nuovo le varianti nella copia (vedere Varianti e configurazioni SysML v2).
BaselineLe baseline del progetto LML non si applicano al nuovo modello; la copia inizia senza baseline.
CronologiaLa cronologia delle modifiche riparte da zero nella copia.
Richieste di modificaLe richieste di modifica LML propongono modifiche a elementi LML, che la copia non ha.
Layout dei diagrammiI diagrammi vengono disegnati da zero come viste SysML v2; le posizioni non vengono riportate.
Elementi convertiti nelle strutture dei documentiI documenti vengono copiati; i requisiti e gli altri elementi del modello nelle loro strutture sono ora elementi SysML e compaiono nel modello, non nella struttura.

Da SysML v2 a LML

Ogni uso di parte diventa un Asset, con una copia delle parti, delle porte e degli attributi della sua definizione (e delle definizioni che specializza). Le ridefinizioni sostituiscono ciò che ridefiniscono. Connessioni e interfacce diventano Conduit tra quegli Asset. Requisiti, casi di verifica, satisfy, verify, perform, parametri item, stati e transizioni vengono ricondotti come nella tabella precedente. Le successioni diventano flussi di azioni; le guardie di una decisione (o i commenti doc delle sue successioni) diventano le etichette dei rami OR, con le loro probabilità. Le modifiche allo schema del progetto vengono riportate, compresi i flussi di lavoro delle classi con i loro stati personalizzati, transizioni e approvatori, così requisiti e casi di test mantengono i loro valori di Status personalizzati.

Non convertitoMotivo
Connessioni con estremità che non si risolvonoCorreggere i nomi delle estremità nel testo, quindi convertire di nuovo.
Connessioni all'interno di definizioni che nessuna parte usaOgni connessione diventa un conduit tra le parti di ogni parte che la possiede; nulla usa questa definizione.
Connettori di bindingLML non ha binding (uguaglianza) tra feature.
Relazioni verify che non si risolvonoCorreggere il nome del requisito nell'obiettivo di verifica, quindi convertire di nuovo.
Parametri item senza definizione di itemTipizzare il parametro con un item def per convertirlo.
Attori senza definizione di parte nel modelloTipizzare l'attore con un part def per convertirlo.
Usi perform che non si risolvono in un'azione e una parteEseguire perform di un'azione da una definizione di parte o da un uso di parte, quindi convertire di nuovo.
Relazioni satisfy che non si risolvonoCorreggere i nomi nell'istruzione satisfy, quindi convertire di nuovo.
Successioni che non sono un flusso strutturatoI flussi di azioni LML sono sequenze con blocchi paralleli, di decisione e di ciclo; gli altri grafi di successioni vengono linearizzati.
Definizioni di stato che nessuna parte esibisceGli stati vengono convertiti senza l'asset di cui descrivono il comportamento.
Transizioni che non si risolvono in due statiCorreggere i nomi degli stati, quindi convertire di nuovo.
Trigger delle transizioni (accept)Le transizioni LML conservano il trigger solo come testo libero; il segnale accettato non viene collegato.
Definizioni di porta, interfaccia e connessioneVengono convertite come Port e Conduit dove le parti le usano; LML non ha tipi di porta, interfaccia o connessione.
Definizioni di attributo (value type)Le characteristic LML non hanno tipi.
Enumerazioni e valori di enumerazioneLML non ha enumerazioni; i valori degli attributi vengono conservati come testo.
Calcoli, casi di analisi, concernLML non ha calcoli, casi di analisi né concern degli stakeholder.
Viste e viewpointI diagrammi vengono disegnati da zero nella copia LML.
Azioni assignment, if, send e acceptLe azioni LML non hanno istruzioni.
DipendenzeLML non ha una dipendenza generica.
AllocazioniPer le azioni eseguite da parti, usare perform nel testo.
MetadatiLML non ha metadati.
OccorrenzeLML non ha occorrenze.
Casi d'uso inclusiLe relazioni include tra casi d'uso non vengono convertite.
AliasLe entità LML hanno un solo nome ciascuna.
Usi di riferimento (parametri di calcoli e casi)LML non ha parametri, tranne le variabili delle equazioni.
SpecializzazioniLML non ha specializzazione; le parti ricevono una copia delle feature delle loro definizioni generali.
RidefinizioniLa feature che ridefinisce sostituisce quella ereditata in ogni parte copiata.
SubsettingLML non ha subsetting.
ImportLML non ha spazi dei nomi; ogni entità è visibile nel progetto.
Definizioni distinte dagli usiLML ha solo istanze: una definizione di parte diventa gli Asset delle parti che la usano, e il suo testo va nelle loro descrizioni.
Molteplicità diverse da quelle delle partiSolo le molteplicità delle parti hanno un posto in LML (la Multiplicity di decomposed by).
Valori di attributoI valori vengono conservati come testo nel Value di ogni characteristic; unità ed espressioni non vengono valutate.
BaselineLe baseline del progetto SysML v2 non si applicano alla copia LML; questa inizia senza baseline.
CronologiaLa cronologia delle modifiche riparte da zero nella copia.
Richieste di modificaLe richieste di modifica SysML propongono modifiche al testo che non si applicano alle entità LML.

CSV del report

Scarica report (CSV) scrive una riga per ogni tipo di elemento convertito e una riga per ogni elemento non convertito. Le colonne sono Risultato (Convertito o Non convertito), Cosa, Conteggio, Diventa o motivo, Numero e Nome.

Messaggi

MessaggioSignificato e soluzione
Controllo della conversione… (barra di avanzamento)Il report è in preparazione.
Questo è già un progetto SysML v2. Scegliere invece Crea una copia LML….È stata scelta la direzione sbagliata.
Questo è già un progetto LML. Scegliere invece Crea una copia SysML v2….È stata scelta la direzione sbagliata.
Il testo convertito ha N problemi. La copia li mostra nel suo Editor.La copia si può creare; correggere i problemi nel suo Editor.
Il testo convertito non viene analizzato (…). Il progetto non è stato copiato; segnalarlo allegando il file del progetto.La conversione non è riuscita. Contattare l'assistenza con il file del progetto.
Il controllo SysML non si è avviato. Ricaricare la pagina e riprovare.Ricaricare e riprovare.
Impossibile leggere il progetto. Ricaricare la pagina e riprovare.Ricaricare e riprovare.
La copia non è stata creata: … Ricaricare la pagina e riprovare.Ricaricare e riprovare.
Creato “<name>”La copia è stata creata e aperta.

Limiti

  • Layout dei diagrammi, cronologia, baseline e richieste di modifica non vengono convertiti.
  • Non ancora: conversione di una linea di prodotti LML (funzionalità e configurazioni) in varianti SysML v2.
  • Il documento del report elenca fino a 500 elementi per tipo.

SysML® e OMG® sono marchi registrati di Object Management Group, Inc. negli Stati Uniti e in altri paesi.