Holarch

SysML v2

SysML v2-Varianten und -Konfigurationen

Modellieren Sie eine Produktlinie in einem SysML v2-Projekt: Variationspunkte, Varianten, Regeln und Konfigurationen im Browser und im Inspektor, Neue Konfiguration…, als eine Konfiguration angezeigte Ansichten und Trade-Studien von Konfigurationen.

So gehen Sie vor →

Auf dieser Seite
  1. Überblick
  2. Konzepte
    1. Variationspunkte und Varianten
    2. Produktlinien
    3. Regeln
    4. Konfigurationen
  3. So setzen Sie es ein
    1. Wann und warum
    2. Einen Variationspunkt kennzeichnen
    3. Eine Regel hinzufügen
    4. Eine Konfiguration erstellen
    5. Die Wahlen einer Konfiguration ändern
    6. Das Modell als eine Konfiguration anzeigen
    7. Konfigurationen in einer Trade-Studie vergleichen
    8. Ausgeführtes Beispiel: die Hybrid-Car-Demo
    9. Tipps und bewährte Vorgehensweisen
    10. Häufige Fehler
    11. Zusammenhang mit anderen Funktionen
  4. Browser
  5. Inspektor
    1. Produktlinie
    2. Konfiguration
    3. Variationspunkt und Variante
  6. Als Konfiguration anzeigen
  7. Meldungen
  8. Grenzen
  9. Verwandte Seiten

Überblick

Eine Produktlinie ist ein Entwurf mit einigen Stellen, an denen sich seine Produkte unterscheiden, etwa die Batteriegröße oder ob ein Ladegerät eingebaut ist. Sie modellieren die Linie einmal und betrachten, prüfen und vergleichen dann jedes einzelne Produkt, ohne das Modell zu kopieren.

SysML v2 hat dies in die Sprache eingebaut. Holarch zeigt es in der gesamten App:

  • Der Browser kennzeichnet Produktlinien, Variationspunkte, Varianten und Konfigurationen und listet die Konfigurationen jeder Produktlinie auf.
  • Der Inspektor zeigt die Punkte, Regeln und Konfigurationen einer Produktlinie mit einem Ergebnis für jede und lässt Sie die Wahlen einer Konfiguration ändern.
  • Neue Konfiguration… erstellt eine Konfiguration über einen Dialog, der die Regeln bereits während der Auswahl prüft.
  • Anzeigen als ▾ in der oberen Leiste zeigt die Ansichten, die Datenbank, den Inspektor und die Seite Produktlinie als eine Konfiguration.
  • Trade-Studien können die Konfigurationen einer Produktlinie oder die Varianten eines Punkts vergleichen.

Variabilität im Text ist in jedem Tarif verfügbar. Im Tarif Free sind die Seite Produktlinie, Neue Konfiguration… und das Ändern der Wahlen einer Konfiguration im Inspektor schreibgeschützt; ihre Bearbeitung gehört zu den Tarifen Individual und Team. Siehe Produktlinien: Tarife.

Konzepte

Variationspunkte und Varianten

Ein Variationspunkt ist eine Stelle im Entwurf, an der sich Produkte unterscheiden. Seine Varianten sind die zulässigen Wahlen.

  • Eine Variation-Verwendung ist ein Punkt innerhalb eines Entwurfs: variation part charger : Component { variant part noCharger; variant part wallbox; }.
  • Eine Variation-Definition ist ein wiederverwendbarer Satz von Wahlen: variation part def BatteryPack { variant part standardPack; variant part largePack; }. Eine durch sie typisierte Verwendung wie part pack : BatteryPack; ist ebenfalls ein Punkt.

Produktlinien

Eine Produktlinie ist eine Definition oder Verwendung, die Variationspunkte besitzt oder erbt. In der Hybrid-Car-Demo ist CarLine die Produktlinie: Sie spezialisiert Car und fügt die Punkte pack und charger hinzu. Eine Definition, die eine Produktlinie spezialisiert, ist ebenfalls eine Produktlinie.

Regeln

Eine Regel ist ein assert constraint der Produktlinie. Sie schließt Kombinationen von Varianten aus. In der Demo besagt wallboxNeedsLargePack, dass das Wallbox-Ladegerät das große Pack benötigt:

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

Solange ein Punkt keine Wahl hat, ist eine Regel darüber weder erfüllt noch verletzt: Ihr Ergebnis ist unbekannt.

Konfigurationen

Eine Konfiguration ist ein Produkt der Linie. Sie ist eine durch die Produktlinie typisierte Verwendung, die jedem Punkt eine Variante zuordnet. Holarch kennzeichnet sie mit @HolarchConfiguration (Package HolarchVariability), sodass der Editor jeden Punkt vermerkt, den sie noch nicht gewählt hat:

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

Jede Konfiguration hat ein Ergebnis:

UrteilBedeutung
GültigFür jeden Punkt ist eine Variante gewählt, und jede Regel ist erfüllt.
Verletzt die Regel …Eine Regel ist verletzt; das Ergebnis nennt sie.
UnvollständigFür einen Punkt ist noch keine Variante gewählt; das Ergebnis nennt ihn.
UnbekanntEine Regel konnte nicht ausgewertet werden, zum Beispiel weil ein Wert fehlt, den sie liest.

Holarch zählt außerdem die Kombinationen von Varianten und wie viele davon die Regeln zulassen. Bei einer sehr großen Produktlinie prüft es nur die ersten Kombinationen und nennt, wie viele es geprüft hat.

So setzen Sie es ein

Wann und warum

Verwenden Sie Variabilität, wenn mehrere Produkte den größten Teil eines Entwurfs teilen: Ausstattungslinien eines Fahrzeugs, Exportversionen, Sensorpakete, ein Produkt mit und ohne eine Option. Modellieren Sie den gemeinsamen Entwurf einmal, kennzeichnen Sie die Punkte, an denen sich Produkte unterscheiden, und fügen Sie eine Konfiguration pro Produkt hinzu. Jedes Produkt bleibt dann bei jeder Änderung am gemeinsamen Entwurf auf dem aktuellen Stand.

Einen Variationspunkt kennzeichnen

  1. Öffnen Sie den Editor und das Package, das den Entwurf enthält.
  2. Wählen Sie innerhalb der Definition der Produktlinie Einfügen ▾ → Variation. Füllen Sie Name und Typ des Punkts aus.
  3. Wählen Sie innerhalb der Variation für jede Wahl einmal Einfügen ▾ → Variante.
  4. Um einen Satz von Wahlen wiederzuverwenden, wählen Sie Einfügen ▾ → Variation auf Package-Ebene. Das schreibt eine Variation-Definition; typisieren Sie einen Part damit.

Der Browser zeigt die Produktlinie nun mit dem Symbol gestapelter Kästen und den Punkt mit einer Raute.

Eine Regel hinzufügen

  1. Schreiben Sie innerhalb der Definition der Produktlinie einen Assert-Constraint über ihre Punkte, zum Beispiel assert constraint r { charger == charger::wallbox implies pack == BatteryPack::largePack }.
  2. Wählen Sie die Produktlinie im Browser aus.

Sie sehen die Regel unter Regeln im Abschnitt Produktlinie des Inspektors sowie die Anzahl der Kombinationen, die sie ausschließt.

Eine Konfiguration erstellen

  1. Öffnen Sie im Browser das Zeilenmenü (⋯, Rechtsklick oder Shift+F10) der Produktlinie oder ihrer Gruppe Konfigurationen.
  2. Wählen Sie Neue Konfiguration….
  3. Prüfen Sie Konfiguriert: die Produktlinie, zu der die Konfiguration gehört.
  4. Geben Sie einen Name ein, etwa longRangeHybrid.
  5. Wählen Sie unter Variantenwahlen eine Variante für jeden Variationspunkt. Sie sehen das Ergebnis sofort unter den Wahlen, zum Beispiel Valid: meets every rule oder Breaks the rule wallboxNeedsLargePack.
  6. Klicken Sie auf Erstellen.

Die Konfiguration wird nach der letzten Konfiguration der Produktlinie in den Text geschrieben, gekennzeichnet mit @HolarchConfiguration, und ein einziges Rückgängigmachen nimmt alles zurück. Der Browser wählt sie in der Gruppe Konfigurationen der Produktlinie aus.

Sie können den Dialog auch mit Neue Konfiguration… im Abschnitt Produktlinie des Inspektors oder über ⌘K / Ctrl+K öffnen.

Die Wahlen einer Konfiguration ändern

  1. Wählen Sie die Konfiguration im Browser (oder in einer Ansicht) aus.
  2. Wählen Sie im Abschnitt Konfiguration des Inspektors in der Liste eines Punkts eine andere Variante.

Die Zuordnung im Text wird neu geschrieben (part :>> pack = BatteryPack::standardPack;), und das Ergebnis wird aktualisiert; ein einziges Rückgängigmachen nimmt alles zurück. Wählen Sie Nicht gewählt, um die Wahl zu entfernen. Eine Wahl, die dem Modell einen Fehler hinzufügen würde, wird mit Begründung abgelehnt.

Das Modell als eine Konfiguration anzeigen

  1. Klicken Sie in der oberen Leiste auf Anzeigen als ▾ (dort steht Alle Konfigurationen ▾, bis Sie eine wählen) und wählen Sie eine Konfiguration. Ein Banner unter der oberen Leiste lautet zum Beispiel Konfiguration plugInHybrid wird angezeigt. und nennt, wie viele Elemente gelten. In General, Interconnection und Grid Views werden die nicht gewählten Varianten und die anderen Konfigurationen ausgeblendet, und jeder Variationspunkt zeigt seine Wahl, etwa pack : BatteryPack = largePack. Die Datenbank, der Inspektor und die Seite Produktlinie folgen derselben Wahl.
  2. Um zurückzukehren, wählen Sie Anzeigen als ▾ → Alle Konfigurationen oder klicken Sie im Banner auf Verlassen.

In den Tarifen Individual und Team können Sie bearbeiten, während eine Konfiguration angezeigt wird; jede Bearbeitung ist eine SysML v2-Textbearbeitung, die vor dem Anwenden geprüft wird, und ein einziges Rückgängigmachen nimmt jede zurück:

  • Das Wählen einer Variante schreibt die Zuordnung in die Konfiguration (part :>> pack = BatteryPack::largePack;).
  • Ein geänderter Attributwert wird zum eigenen Wert der Konfiguration; die Definition behält ihren Wert.
  • Neue Parts und Actions gehören zur Konfiguration.
  • Das Löschen eines geerbten Elements, das weggelassen werden darf, schreibt part :>> roofBox[0]; in die Konfiguration. Ein erforderliches geerbtes Element lässt sich dort nicht löschen; ändern Sie es im Editor.
  • Ein Risiko, eine Aufgabe oder ein anderes Holarch-Element, das Sie erstellen, gilt für die Konfiguration.

Im Tarif Free ist die Konfigurationsansicht schreibgeschützt. Im Inspektor einer Konfiguration öffnet In Ansicht anzeigen ▾ eine Ansicht ihrer Produktlinie, dargestellt als diese Konfiguration.

Konfigurationen in einer Trade-Studie vergleichen

  1. Öffnen Sie Risiken, Issues & Entscheidungen → Trade-Studien und eine Studie (oder klicken Sie auf + Neue Trade-Studie).
  2. Klicken Sie unter Alternativen auf + Aus Produktlinie….
  3. Wählen Sie unter Von Konfigurationen von … (einer Produktlinie) oder Varianten von … (eines Variationspunkts).
  4. Entfernen Sie das Häkchen bei jedem Eintrag, den Sie nicht möchten, und klicken Sie auf Hinzufügen.

Jede Konfiguration oder Variante wird zu einer Alternative, die mit dem Modellelement verknüpft ist. Fügen Sie Kriterien und Werte wie in jeder Trade-Studie hinzu, oder verwenden Sie Werte aus Modell übernehmen.

Ausgeführtes Beispiel: die Hybrid-Car-Demo

Erstellen Sie die Demo unter Projekte verwalten mit Projektdateien ▾ → Neues Demoprojekt → Hybrid Car (SysML v2).

  1. Öffnen Sie Modell → Browser und klappen Sie Vehicles auf. BatteryPack und CarLine tragen die Produktliniensymbole; CarLine hat eine Gruppe Konfigurationen mit longRangeHybrid, plugInHybrid und selfChargingHybrid.
  2. Wählen Sie CarLine aus. Der Abschnitt Produktlinie listet die Punkte pack (standardPack, largePack) und charger (noCharger, wallbox), die Regel wallboxNeedsLargePack und die drei Konfigurationen auf, alle Gültig. Er meldet 4 Kombinationen: 3 von den Regeln zugelassen, 1 ausgeschlossen (die Wallbox mit dem Standard-Pack).
  3. Wählen Sie selfChargingHybrid aus und ändern Sie charger in wallbox. Das Ergebnis wird zu Breaks the rule wallboxNeedsLargePack. Drücken Sie ⌘Z / Ctrl+Z, um es rückgängig zu machen.
  4. Öffnen Sie die Ansicht carLineVariants (Diagramme). Wählen Sie Anzeigen als ▾ → plugInHybrid. Der Kasten BatteryPack behält nur largePack, und der Kasten CarLine zeigt pack : BatteryPack = largePack und variation charger : Component = wallbox.
  5. Öffnen Sie Trade-Studien → Configuration Line-up (TR-2). Ihre Alternativen sind die drei Konfigurationen, bewertet nach Preis, elektrischer Reichweite und Ladekomfort.

Tipps und bewährte Vorgehensweisen

  • Halten Sie den gemeinsamen Entwurf in der Produktlinie und nur die Unterschiede in Varianten. Eine Variante redefiniert, was sie ändert (attribute :>> capacity = 12 [kW*h];).
  • Schreiben Sie Regeln, sobald Sie wissen, dass eine Kombination nicht zulässig ist. Die Ergebnisse erkennen eine fehlerhafte Konfiguration dann sofort.
  • Benennen Sie Konfigurationen nach dem Produkt, nicht nach den Wahlen (plugInHybrid, nicht largePackWallbox).
  • Verwenden Sie eine Ansicht pro Produktlinie und schalten Sie sie zwischen Konfigurationen um, statt einer Ansicht pro Konfiguration.

Häufige Fehler

  • Eine Konfiguration wird nicht unter ihrer Produktlinie aufgeführt. Sie muss durch die Produktlinie typisiert sein (part x : CarLine). Prüfen Sie ihren Typ im Inspektor.
  • Ein Ergebnis bleibt Unbekannt. Eine Regel liest einen Wert, der in dieser Konfiguration keinen hat. Wählen Sie eine Variante für jeden Punkt, oder geben Sie dem Wert einen Standardwert.
  • Eine Wahl wird abgelehnt. Die Variante gehört nicht zu den Varianten dieses Punkts. Wählen Sie aus der Liste im Inspektor, oder korrigieren Sie den Namen im Text.

Zusammenhang mit anderen Funktionen

  • Editor: Einfügen ▾ schreibt Variation, Variante, Konfiguration und Variantenwahl. Alles hier ist gewöhnlicher SysML v2-Text, sodass Importe, Exporte und andere SysML v2-Werkzeuge ihn lesen.
  • Trade-Studien: Konfigurationen und Varianten als Alternativen.
  • Zuverlässigkeits-Blockdiagramme: Die Varianten eines Variationspunkts sind Alternativen, daher zählt das Diagramm nur die Variante, die die Konfiguration in Anzeigen als ▾ gewählt hat. Werden alle Konfigurationen angezeigt, ist der Punkt ein Block mit eigenen Werten, und der Bereich fordert dazu auf, eine Konfiguration zu wählen.
  • Modellprüfungen: Verifikation → Modellprüfungen meldet jede Konfiguration, die eine Regel verletzt oder einen Variationspunkt ohne Variante lässt (ProductLine.3, ein Fehler). Der Hinweis ist das Ergebnis, etwa Breaks the rule wallboxNeedsLargePack, und die verletzten Regeln werden als zugehörige Elemente aufgeführt. Beheben → Element öffnen öffnet die Konfiguration. API und MCP melden denselben Befund (run_model_checks, GET …/model-checks).
  • Änderungsanträge und Verlauf: Jede Änderung ist eine gewöhnliche Modelländerung, und ein einziges Rückgängigmachen nimmt jede davon zurück.

Browser

  • Symbole: gestapelte Kästen für eine Produktlinie, eine Raute für einen Variationspunkt, eine gefüllte Raute für eine Variante, Schieberegler für eine Konfiguration. Jedes Symbol hat einen Tooltip.
  • Gruppe Konfigurationen: das erste Mitglied in der Zeile einer Produktlinie. Sie listet die Konfigurationen der Produktlinie auf, wo immer sie deklariert sind; jede Zeile dort steht für die Konfiguration selbst. Ihr Zeilenmenü enthält Neue Konfiguration….
  • Zeilenmenü: Neue Konfiguration… bei einer Produktlinie und bei jeder ihrer Konfigurationen.
  • Screenreader: Der Name einer Zeile sagt, was sie ist, zum Beispiel CarLine, part def, product line oder plugInHybrid, part, configuration of CarLine.

Inspektor

Produktlinie

  • Variationspunkte: jeder Punkt mit den Varianten, aus denen er wählt.
  • Regeln: die Assert-Constraints der Produktlinie oder No rules: every combination of variants is allowed.
  • Konfigurationen: eine Tabelle der Konfigurationen und ihrer Ergebnisse.
  • Kombinationen: wie viele Kombinationen von Varianten es gibt und wie viele die Regeln zulassen, ausschließen oder offen lassen.
  • Neue Konfiguration…

Konfiguration

  • Konfiguriert: die Produktlinie.
  • Status: das Ergebnis, das Screenreadern bei einer Änderung angesagt wird.
  • Eine Liste pro Variationspunkt: die gewählte Variante oder Nicht gewählt. Ein einziges Rückgängigmachen nimmt eine Änderung zurück.
  • Regeln: jede Regel als Erfüllt, Broken oder Unbekannt.
  • In Ansicht anzeigen ▾: die General, Interconnection und Grid Views, die die Produktlinie zeigen, geöffnet als diese Konfiguration.

Variationspunkt und Variante

  • Ein Variationspunkt listet seine Varianten auf und unter Gewählt von, was jede Konfiguration wählt.
  • Eine Variante zeigt unter Variante von, zu welchem Punkt sie gehört, und welche Konfigurationen sie wählen.

Als Konfiguration anzeigen

  • Wo: die obere Leiste, sobald das Modell eine Konfiguration hat. Eine Wahl pro Browser-Tab: General, Interconnection und Grid Views, die Datenbank, der Inspektor und die Seite Produktlinie folgen ihr.
  • Steuerelement: Anzeigen als ▾ (dort steht Alle Konfigurationen ▾, bis Sie eine wählen). Das Menü listet Alle Konfigurationen, die Konfigurationen jeder Produktlinie mit ihren Ergebnissen, Gültigkeit ▸ (das Modell bei einer Seriennummer, einem Baudatum oder beidem anzeigen: Seriennummer und Datum… ist eine Einheit mit dieser Seriennummer, gebaut an diesem Datum) und Produktlinie verwalten auf. Das Banner unter der oberen Leiste hat Ändern ▾ und Verlassen.
  • Was sich ändert: Varianten, die die Konfiguration nicht wählt, und die anderen Konfigurationen derselben Produktlinie werden mit allem, was sie besitzen, ausgeblendet. Variationspunkte zeigen ihre Wahl. Layouts werden nicht umgeordnet und von jeder Konfiguration geteilt.
  • Bearbeiten: Tarife Individual und Team. Bearbeitungen folgen den Regeln unter Das Modell als eine Konfiguration anzeigen. Im Tarif Free und für Personen mit Lesezugriff ist die Ansicht schreibgeschützt, und das Banner nennt den Grund.
  • Raster: Die Tabelle lässt die ausgeblendeten Elemente weg und nennt die Wahlen über der Tabelle. Die Matrix zeigt die ganze Produktlinie.
  • Pro Tab: Die Wahl bleibt für den Browser-Tab erhalten, bis Sie sie ändern. Bilder der Ansicht in der Liste Diagramme zeigen die ganze Produktlinie.
  • Screenreader: Beim Umschalten werden die Konfiguration und die Anzahl der geltenden Elemente angesagt, zum Beispiel Konfiguration plugInHybrid wird angezeigt. … Elemente gelten., ergänzt um Nur lesen., wenn Sie nicht bearbeiten können.

Meldungen

NachrichtWas zu tun ist
Das Modell hat noch keine Variationspunkte. Fügen Sie im Editor eine Variation hinzu (Einfügen ▾ → Variation) und versuchen Sie es dann erneut.Kennzeichnen Sie zuerst einen Variationspunkt.
The model has no configurations or variants yet. … (+ Aus Produktlinie…)Fügen Sie zuerst einen Variationspunkt oder eine Konfiguration hinzu.
Geben Sie einen Namen für die Konfiguration ein.Tippen Sie einen Namen in Name.
… wird bereits in … verwendet. Wählen Sie einen anderen Namen.Ein anderes Element im selben Package hat diesen Namen.
Namen haben 1 bis 1.000 Zeichen und keine Zeilenumbrüche. Ändern Sie den Namen.Kürzen Sie den Namen oder entfernen Sie den Zeilenumbruch.
Eine Wahl oder Konfiguration, die abgelehnt wirdSie würde dem Modell einen Fehler hinzufügen; die Meldung nennt den Fehler. Korrigieren Sie den Text, oder wählen Sie eine andere Variante.
Der SysML-Checker ist nicht verfügbar, daher können die Variationspunkte nicht gelesen werden.Laden Sie die Seite neu, oder erstellen Sie die Konfiguration im Editor mit Einfügen ▾ → Konfiguration.

Grenzen

  • Bei einer sehr großen Produktlinie prüft die Kombinationszählung nur die ersten Kombinationen; Konfigurationen werden immer vollständig geprüft.
  • Im Tarif Free ist eine als eine Konfiguration angezeigte Ansicht schreibgeschützt.
  • Noch nicht: das Freigeben oder Ausmustern einer SysML v2-Konfiguration. Jede SysML v2-Konfiguration ist ein Entwurf, daher sperrt die Konfigurationssteuerung keine.
  • Variabilität umfasst das SysML v2-Modell. Holarch-Elemente daneben (Risiken, Tests, Aufgaben, Dokumentabschnitte) gelten für jede Konfiguration, außer denen, die erstellt werden, während eine Konfiguration angezeigt wird: Sie gelten für diese Konfiguration. Ihr Feld Applies To lässt sich in einem SysML v2-Projekt noch nicht bearbeiten.

SysML® und OMG® sind eingetragene Marken der Object Management Group, Inc. in den Vereinigten Staaten und anderen Ländern.