Holarch

SysML v2

Varianti e configurazioni SysML v2

Modellare una linea di prodotti in un progetto SysML v2: punti di variazione, varianti, regole e configurazioni nel Browser e nell'ispettore, New Configuration…, viste mostrate come una sola configurazione e studi di trade-off delle configurazioni.

Come usarlo →

In questa pagina
  1. Panoramica
  2. Concetti
    1. Punti di variazione e varianti
    2. Linee di prodotti
    3. Regole
    4. Configurazioni
  3. Come usarlo
    1. Quando e perché
    2. Contrassegnare un punto di variazione
    3. Aggiungere una regola
    4. Creare una configurazione
    5. Modificare le scelte di una configurazione
    6. Mostrare il modello come un’unica configurazione
    7. Confrontare configurazioni in uno studio di trade-off
    8. Esempio guidato: la demo Hybrid Car
    9. Suggerimenti e buone pratiche
    10. Errori comuni
    11. Come si collega alle altre funzionalità
  4. Browser
  5. Ispettore
    1. Linea di prodotti
    2. Configurazione
    3. Punto di variazione e variante
  6. Visualizza come configurazione
  7. Messaggi
  8. Limiti
  9. Pagine correlate

Panoramica

Una linea di prodotti è un unico progetto con alcuni punti in cui i suoi prodotti differiscono, come la dimensione della batteria o la presenza di un caricatore. La linea si modella una volta sola, poi si può esaminare, controllare e confrontare qualsiasi singolo prodotto senza copiare il modello.

SysML v2 ha questa funzionalità integrata nel linguaggio. Holarch la mostra in tutta l'app:

  • Il Browser contrassegna linee di prodotti, punti di variazione, varianti e configurazioni, ed elenca le configurazioni di ogni linea di prodotti.
  • L'ispettore mostra i punti, le regole e le configurazioni di una linea di prodotti con un verdetto per ciascuno, e consente di cambiare le scelte di una configurazione.
  • Nuova configurazione… crea una configurazione da una finestra di dialogo che controlla le regole mentre si sceglie.
  • Visualizza come ▾ nella barra superiore mostra le viste, il Database, l'ispettore e la pagina Linea di prodotti come una singola configurazione.
  • Studi di trade-off può confrontare le configurazioni di una linea di prodotti o le varianti di un punto.

La variabilità nel testo è disponibile in tutti i piani. Nel piano Free la pagina Linea di prodotti, Nuova configurazione… e la modifica delle scelte di una configurazione nell'ispettore sono di sola lettura; modificarli fa parte dei piani Individual e Team. Vedere Linee di prodotti: piani.

Concetti

Punti di variazione e varianti

Un punto di variazione è un punto del progetto in cui i prodotti differiscono. Le sue varianti sono le scelte consentite.

  • Un uso di variazione è un punto all'interno di un progetto: variation part charger : Component { variant part noCharger; variant part wallbox; }.
  • Una definizione di variazione è un insieme riutilizzabile di scelte: variation part def BatteryPack { variant part standardPack; variant part largePack; }. Anche un uso tipizzato da essa, come part pack : BatteryPack;, è un punto.

Linee di prodotti

Una linea di prodotti è una definizione o un uso che possiede o eredita punti di variazione. Nella demo Hybrid Car, CarLine è la linea di prodotti: specializza Car e aggiunge i punti pack e charger. Anche una definizione che specializza una linea di prodotti è una linea di prodotti.

Regole

Una regola è un assert constraint della linea di prodotti. Esclude combinazioni di varianti. Nella demo, wallboxNeedsLargePack dice che il caricatore wallbox richiede il pacco grande:

assert constraint wallboxNeedsLargePack { charger == charger::wallbox implies pack == BatteryPack::largePack }

Finché un punto non ha una scelta, una regola su di esso non è né rispettata né violata: il suo verdetto è sconosciuto.

Configurazioni

Una configurazione è un prodotto della linea. È un uso tipizzato dalla linea di prodotti che vincola una variante a ogni punto. Holarch la contrassegna con @HolarchConfiguration (package HolarchVariability), così l'Editor segnala ogni punto non ancora scelto:

part plugInHybrid : CarLine {
  @HolarchConfiguration;
  part :>> pack = BatteryPack::largePack;
  part :>> charger = charger::wallbox;
}

Ogni configurazione ha un verdetto:

EsitoSignificato
ValidaÈ scelta una variante per ogni punto e ogni regola è rispettata.
Viola la regola …Una regola è violata; il verdetto la nomina.
IncompletaUn punto non ha ancora una variante scelta; il verdetto lo nomina.
SconosciutoNon è stato possibile valutare una regola, per esempio perché manca un valore che legge.

Holarch conta anche le combinazioni di varianti e quante di esse le regole consentono. Per una linea di prodotti molto grande controlla solo le prime combinazioni e indica quante ne ha controllate.

Come usarlo

Quando e perché

Usare la variabilità quando più prodotti condividono la maggior parte di un progetto: allestimenti di un veicolo, versioni per l'esportazione, suite di sensori, un prodotto con e senza un'opzione. Modellare una volta il progetto condiviso, contrassegnare i punti in cui i prodotti differiscono e aggiungere una configurazione per ogni prodotto. Ogni prodotto resta così allineato a ogni modifica del progetto condiviso.

Contrassegnare un punto di variazione

  1. Aprire l'Editor e il package che contiene il progetto.
  2. All'interno della definizione della linea di prodotti, scegliere Inserisci ▾ → Variazione. Compilare il nome e il tipo del punto.
  3. All'interno della variazione, scegliere Inserisci ▾ → Variante una volta per ogni scelta.
  4. Per riutilizzare un insieme di scelte, scegliere Inserisci ▾ → Variazione a livello di package. Scrive una definizione di variazione; tipizzare una parte con essa.

Il Browser mostra ora la linea di prodotti con l'icona dei riquadri impilati e il punto con un rombo.

Aggiungere una regola

  1. All'interno della definizione della linea di prodotti, scrivere un assert constraint sui suoi punti, per esempio assert constraint r { charger == charger::wallbox implies pack == BatteryPack::largePack }.
  2. Selezionare la linea di prodotti nel Browser.

La regola compare sotto Regole nella sezione Linea di prodotti dell'ispettore, insieme al numero di combinazioni che esclude.

Creare una configurazione

  1. Nel Browser, aprire il menu della riga (⋯, clic destro o Shift+F10) della linea di prodotti o del suo gruppo Configurazioni.
  2. Scegliere Nuova configurazione….
  3. Controllare Configura: la linea di prodotti a cui appartiene la configurazione.
  4. Inserire un Nome, come longRangeHybrid.
  5. In Scelte delle varianti, scegliere una variante per ogni punto di variazione. Il verdetto compare subito sotto le scelte, per esempio Valida: rispetta ogni regola o Viola la regola wallboxNeedsLargePack.
  6. Fare clic su Crea.

La configurazione viene scritta nel testo dopo l'ultima configurazione della linea di prodotti, contrassegnata con @HolarchConfiguration, e un solo annullamento revoca tutto. Il Browser la seleziona nel gruppo Configurazioni della linea di prodotti.

La finestra si può aprire anche con Nuova configurazione… nella sezione Linea di prodotti dell'ispettore, oppure da ⌘K / Ctrl+K.

Modificare le scelte di una configurazione

  1. Selezionare la configurazione nel Browser (o in una vista).
  2. Nella sezione Configurazione dell'ispettore, scegliere un'altra variante nell'elenco di un punto.

Il vincolo nel testo viene riscritto (part :>> pack = BatteryPack::standardPack;) e il verdetto si aggiorna; un solo annullamento revoca tutto. Scegliere Non scelto per rimuovere la scelta. Una scelta che aggiungerebbe un errore al modello viene rifiutata con il motivo.

Mostrare il modello come un’unica configurazione

  1. Nella barra superiore, fare clic su Visualizza come ▾ (riporta Tutte le configurazioni ▾ finché non se ne sceglie una) e scegliere una configurazione. Un banner sotto la barra superiore riporta, per esempio, Visualizzazione della configurazione plugInHybrid. e quanti elementi si applicano. Nelle Viste generali, di interconnessione e Griglia, le varianti non scelte e le altre configurazioni sono nascoste, e ogni punto di variazione mostra la sua scelta, come pack : BatteryPack = largePack. Il Database, l'ispettore e la pagina Linea di prodotti seguono la stessa scelta.
  2. Per tornare indietro, scegliere Visualizza come ▾ → Tutte le configurazioni, oppure fare clic su Esci nel banner.

Nei piani Individual e Team è possibile modificare mentre è mostrata una configurazione; ogni modifica è una modifica del testo SysML v2, controllata prima di essere applicata, e un solo annullamento revoca ciascuna di esse:

  • Scegliere una variante scrive il vincolo nella configurazione (part :>> pack = BatteryPack::largePack;).
  • Un valore di attributo modificato diventa il valore proprio della configurazione; la definizione mantiene il suo valore.
  • Le nuove parti e azioni appartengono alla configurazione.
  • Eliminare un elemento ereditato che si può omettere scrive part :>> roofBox[0]; nella configurazione. Un elemento ereditato obbligatorio non può essere eliminato lì; modificarlo nell'Editor.
  • Un rischio, un'attività o un altro elemento di Holarch creato si applica alla configurazione.

Nel piano Free la vista della configurazione è di sola lettura. Dall'ispettore di una configurazione, Mostra nella vista ▾ apre una vista della sua linea di prodotti mostrata come quella configurazione.

Confrontare configurazioni in uno studio di trade-off

  1. Aprire Rischi, problemi e decisioni → Studi di trade-off e uno studio (o fare clic su + Nuovo studio di trade-off).
  2. In Alternative, fare clic su + Dalla linea di prodotti….
  3. In Da, scegliere Configurazioni di … (una linea di prodotti) o Varianti di … (un punto di variazione).
  4. Togliere la spunta dagli elementi non desiderati e fare clic su Aggiungi.

Ogni configurazione o variante diventa un'alternativa, collegata all'elemento del modello. Aggiungere criteri e valori come in qualsiasi studio di trade-off, oppure usare Preleva valori dal modello.

Esempio guidato: la demo Hybrid Car

Creare la demo con File di progetto ▾ → Nuovo progetto demo → Hybrid Car (SysML v2) in Gestisci progetti.

  1. Aprire Modello → Browser ed espandere Vehicles. BatteryPack e CarLine hanno le icone della linea di prodotti; CarLine ha un gruppo Configurazioni con longRangeHybrid, plugInHybrid e selfChargingHybrid.
  2. Selezionare CarLine. La sezione Linea di prodotti elenca i punti pack (standardPack, largePack) e charger (noCharger, wallbox), la regola wallboxNeedsLargePack e le tre configurazioni, tutte Valida. Riporta 4 combinazioni: 3 consentite dalle regole, 1 esclusa (la wallbox con il pacco standard).
  3. Selezionare selfChargingHybrid e cambiare charger in wallbox. Il verdetto diventa Viola la regola wallboxNeedsLargePack. Premere ⌘Z / Ctrl+Z per annullare.
  4. Aprire la vista carLineVariants (Diagrammi). Scegliere Visualizza come ▾ → plugInHybrid. Il riquadro BatteryPack mantiene solo largePack, e il riquadro CarLine mostra pack : BatteryPack = largePack e variation charger : Component = wallbox.
  5. Aprire Studi di trade-off → Configuration Line-up (TR-2). Le sue alternative sono le tre configurazioni, valutate su prezzo, autonomia elettrica e praticità di ricarica.

Suggerimenti e buone pratiche

  • Mantenere il progetto condiviso nella linea di prodotti e solo le differenze nelle varianti. Una variante ridefinisce ciò che cambia (attribute :>> capacity = 12 [kW*h];).
  • Scrivere le regole appena si sa che una combinazione non è consentita. I verdetti intercettano così subito una configurazione errata.
  • Dare alle configurazioni il nome del prodotto, non delle scelte (plugInHybrid, non largePackWallbox).
  • Usare una sola vista per linea di prodotti e passarla da una configurazione all'altra, invece di una vista per configurazione.

Errori comuni

  • Una configurazione non è elencata sotto la sua linea di prodotti. Deve essere tipizzata dalla linea di prodotti (part x : CarLine). Controllarne il Tipo nell'ispettore.
  • Un verdetto resta Sconosciuto. Una regola legge un valore che in questa configurazione non ne ha. Scegliere una variante per ogni punto, oppure dare al valore un valore predefinito.
  • Una scelta viene rifiutata. La variante non è una delle varianti di quel punto. Scegliere dall'elenco nell'ispettore, oppure correggere il nome nel testo.

Come si collega alle altre funzionalità

  • Editor: Inserisci ▾ scrive Variazione, Variante, Configurazione e Scelta della variante. Tutto qui è normale testo SysML v2, quindi le importazioni, le esportazioni e gli altri strumenti SysML v2 lo leggono.
  • Studi di trade-off: configurazioni e varianti come alternative.
  • Diagrammi a blocchi di affidabilità: le varianti di un punto di variazione sono alternative, quindi il diagramma conta solo la variante scelta dalla configurazione in Visualizza come ▾. Con tutte le configurazioni mostrate, il punto è un unico blocco con i propri valori, e il riquadro indica di scegliere una configurazione.
  • Controlli del modello: Verifica → Controlli del modello segnala ogni configurazione che viola una regola o lascia un punto di variazione senza variante (ProductLine.3, un errore). La nota è il verdetto, come Viola la regola wallboxNeedsLargePack, e le regole violate sono elencate come elementi correlati. Correggi → Apri elemento apre la configurazione. L'API e l'MCP segnalano lo stesso rilievo (run_model_checks, GET …/model-checks).
  • Richieste di modifica e cronologia: ogni modifica è una normale modifica del modello, e un solo annullamento revoca ciascuna di esse.

Browser

  • Icone: riquadri impilati per una linea di prodotti, un rombo per un punto di variazione, un rombo pieno per una variante, cursori per una configurazione. Ogni icona ha un suggerimento.
  • Gruppo Configurazioni: il primo membro della riga di una linea di prodotti. Elenca le configurazioni della linea di prodotti ovunque siano dichiarate; ogni riga lì rappresenta la configurazione stessa. Il suo menu della riga ha Nuova configurazione….
  • Menu della riga: Nuova configurazione… su una linea di prodotti e su ciascuna delle sue configurazioni.
  • Lettori di schermo: il nome di una riga dice che cos'è, per esempio CarLine, part def, linea di prodotti o plugInHybrid, part, configurazione di CarLine.

Ispettore

Linea di prodotti

  • Punti di variazione: ogni punto con le varianti tra cui sceglie.
  • Regole: gli assert constraint della linea di prodotti, oppure Nessuna regola: ogni combinazione di varianti è consentita.
  • Configurazioni: una tabella delle configurazioni e dei loro verdetti.
  • Combinazioni: quante combinazioni di varianti esistono e quante le regole ne consentono, ne escludono o ne lasciano sconosciute.
  • Nuova configurazione…

Configurazione

  • Configura: la linea di prodotti.
  • Stato: il verdetto, annunciato ai lettori di schermo quando cambia.
  • Un elenco per ogni punto di variazione: la variante scelta, oppure Non scelto. Un solo annullamento revoca una modifica.
  • Regole: ogni regola come Rispettata, Violata o Sconosciuta.
  • Mostra nella vista ▾: le Viste generali, di interconnessione e Griglia che mostrano la linea di prodotti, aperte come questa configurazione.

Punto di variazione e variante

  • Un punto di variazione elenca le sue Varianti e, sotto Scelto da, ciò che sceglie ogni configurazione.
  • Una variante mostra di cosa è Variante di e quali configurazioni la scelgono.

Visualizza come configurazione

  • Dove: la barra superiore, quando il modello ha una configurazione. Una scelta per scheda del browser: le Viste generali, di interconnessione e Griglia, il Database, l'ispettore e la pagina Linea di prodotti la seguono.
  • Controllo: Visualizza come ▾ (riporta Tutte le configurazioni ▾ finché non se ne sceglie una). Il menu elenca Tutte le configurazioni, le configurazioni di ogni linea di prodotti con i loro verdetti, Applicabilità ▸ (mostra il modello a un numero di serie, a una data di costruzione o a entrambi: Numero di serie e data… è un'unità con quel numero di serie costruita in quella data) e Gestisci linea di prodotti. Il banner sotto la barra superiore ha Cambia ▾ ed Esci.
  • Cosa cambia: le varianti che la configurazione non sceglie e le altre configurazioni della stessa linea di prodotti sono nascoste, insieme a ciò che possiedono. I punti di variazione mostrano la loro scelta. I layout non vengono riorganizzati e sono condivisi da ogni configurazione.
  • Modifica: piani Individual e Team. Le modifiche seguono le regole descritte in Mostrare il modello come una configurazione. Nel piano Free, e per chi ha l'accesso in visualizzazione, la vista è di sola lettura e il banner ne spiega il motivo.
  • Griglia: la Tabella omette gli elementi nascosti e indica le scelte sopra la tabella. La Matrice mostra l'intera linea di prodotti.
  • Per scheda: la scelta viene conservata per la scheda del browser finché non la si cambia. Le immagini della vista nell'elenco Diagrammi mostrano l'intera linea di prodotti.
  • Lettori di schermo: il cambio annuncia la configurazione e quanti elementi si applicano, per esempio Visualizzazione della configurazione plugInHybrid. Si applicano … elementi., con Sola lettura. aggiunto quando non si può modificare.

Messaggi

MessaggioChe cosa fare
Il modello non ha ancora punti di variazione. Aggiungere una variazione nell'Editor (Inserisci ▾ → Variazione), poi riprovare.Contrassegnare prima un punto di variazione.
Il modello non ha ancora configurazioni o varianti. … (+ Dalla linea di prodotti…)Aggiungere prima un punto di variazione o una configurazione.
Inserire un nome per la configurazione.Digitare un nome in Nome.
… è già usato in …. Scegliere un altro nome.Un altro elemento dello stesso package ha quel nome.
I nomi hanno da 1 a 1.000 caratteri e nessuna interruzione di riga. Cambiare il nome.Accorciare il nome o rimuovere l'interruzione di riga.
Una scelta o una configurazione rifiutataAggiungerebbe un errore al modello; il messaggio indica l'errore. Correggere il testo, oppure scegliere un'altra variante.
Il controllo SysML non è disponibile, quindi i punti di variazione non possono essere letti.Ricaricare la pagina, oppure creare la configurazione nell'Editor con Inserisci ▾ → Configurazione.

Limiti

  • Per una linea di prodotti molto grande, il conteggio delle combinazioni controlla solo le prime combinazioni; le configurazioni vengono sempre controllate per intero.
  • Nel piano Free, una vista mostrata come una configurazione è di sola lettura.
  • Non ancora: rilasciare o ritirare una configurazione SysML v2. Ogni configurazione SysML v2 è in Draft, quindi il controllo della configurazione non ne blocca nessuna.
  • La variabilità riguarda il modello SysML v2. Gli elementi di Holarch accanto a esso (rischi, test, attività, sezioni di documenti) si applicano a ogni configurazione, tranne quelli creati mentre è mostrata una configurazione: si applicano a quella configurazione. Il loro campo Applies To non può ancora essere modificato in un progetto SysML v2.

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