Holarch

SysML v2

SysML v2 のバリアントと構成

SysML v2 プロジェクトでプロダクトラインをモデル化します。ブラウザーとインスペクターでの可変点、バリアント、ルール、構成、新しい構成…、1 つの構成として表示されるビュー、構成のトレードスタディについて説明します。

使い方 →

このページの内容
  1. 概要
  2. 概念
    1. 可変点とバリアント
    2. プロダクトライン
    3. ルール
    4. 構成
  3. 使い方
    1. 使う場面と理由
    2. 可変点を指定する
    3. ルールを追加する
    4. 構成を作成する
    5. 構成の選択を変更する
    6. モデルを 1 つの構成として表示する
    7. トレードスタディで構成を比較する
    8. 作業例:Hybrid Car デモ
    9. ヒントとよい進め方
    10. よくある間違い
    11. 他の機能との関係
  4. ブラウザー
  5. インスペクター
    1. プロダクトライン
    2. 構成
    3. 可変点とバリアント
  6. 構成として表示
  7. メッセージ
  8. 制限事項
  9. 関連ページ

概要

プロダクトラインは、バッテリーのサイズや充電器の有無など、製品間で異なる点がいくつかある 1 つの設計です。ラインを一度モデル化すれば、モデルをコピーせずに、任意の 1 つの製品を確認、チェック、比較できます。

SysML v2 では、これが言語に組み込まれています。Holarch はアプリ全体でこれを表示します。

  • ブラウザーは、プロダクトライン、可変点、バリアント、構成に印を付け、各プロダクトラインの構成を一覧表示します。
  • インスペクターは、プロダクトラインの可変点、ルール、構成をそれぞれの判定とともに表示し、構成の選択を変更できます。
  • 新しい構成…は、選択に応じてルールをチェックするダイアログから構成を作成します。
  • トップバーのView as ▾は、ビュー、データベース、インスペクター、プロダクトラインページを 1 つの構成として表示します。
  • トレードスタディでは、プロダクトラインの構成または可変点のバリアントを比較できます。

テキストでの可変性は、すべてのプランで利用できます。Free プランでは、プロダクトラインページ、新しい構成…、インスペクターでの構成の選択の変更は読み取り専用です。これらの編集は Individual プランと Team プランに含まれます。プロダクトライン:プランを参照してください。

概念

可変点とバリアント

可変点は、設計の中で製品が異なる箇所です。そのバリアントは許可された選択肢です。

  • バリエーション使用は、1 つの設計内の可変点です:variation part charger : Component { variant part noCharger; variant part wallbox; }。
  • バリエーション定義は、再利用できる選択肢の集合です:variation part def BatteryPack { variant part standardPack; variant part largePack; }。part pack : BatteryPack; のように、それを型とする使用も可変点です。

プロダクトライン

プロダクトラインは、可変点を所有または継承する定義または使用です。Hybrid Car デモでは、CarLine がプロダクトラインです:Car を特化し、可変点 pack と charger を追加しています。プロダクトラインを特化する定義もプロダクトラインです。

ルール

ルールは、プロダクトラインの assert constraint です。バリアントの組み合わせを除外します。デモでは、wallboxNeedsLargePack が、wallbox 充電器には大容量パックが必要であることを示しています。

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

可変点に選択がない間、それに関するルールは満たされても破られてもいません:判定は不明です。

構成

構成はラインの 1 つの製品です。プロダクトラインを型とし、各可変点に 1 つのバリアントをバインドする使用です。Holarch はこれに @HolarchConfiguration(パッケージ HolarchVariability)で印を付けるため、エディターはまだ選択されていない各可変点を指摘します。

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

各構成には判定があります。

判定意味
有効すべての可変点で 1 つのバリアントが選択され、すべてのルールが満たされています。
ルール … に違反ルールが破られています。判定にそのルールの名前が示されます。
未完了可変点でまだバリアントが選択されていません。判定にその可変点の名前が示されます。
不明ルールを評価できませんでした。例えば、ルールが読み取る値がありません。

Holarch は、バリアントの組み合わせの数と、そのうちルールで許可される数も数えます。非常に大きなプロダクトラインでは最初の組み合わせだけをチェックし、チェックした数を示します。

使い方

使う場面と理由

複数の製品が 1 つの設計の大部分を共有する場合は、可変性を使います:車両のグレード、輸出仕様、センサー構成、オプションの有無がある製品など。共有する設計を一度モデル化し、製品が異なる箇所に印を付け、製品ごとに構成を追加します。こうすれば、各製品は共有設計へのすべての変更と同期したままになります。

可変点を指定する

  1. エディターと、設計を含むパッケージを開きます。
  2. プロダクトラインの定義の中で、挿入 ▾ → Variationを選択します。可変点の名前と型を入力します。
  3. バリエーションの中で、選択肢ごとに挿入 ▾ → Variantを選択します。
  4. 選択肢の集合を再利用するには、パッケージレベルで挿入 ▾ → Variationを選択します。バリエーション定義が書き込まれるので、パートにその型を与えます。

ブラウザーに、プロダクトラインが積み重なったボックスのアイコンで、可変点がひし形で表示されるようになります。

ルールを追加する

  1. プロダクトラインの定義の中で、その可変点に関する assert constraint を書きます(例:assert constraint r { charger == charger::wallbox implies pack == BatteryPack::largePack })。
  2. ブラウザーでプロダクトラインを選択します。

インスペクターのプロダクトラインセクションのルールの下に、ルールと、それが除外する組み合わせの数が表示されます。

構成を作成する

  1. ブラウザーで、プロダクトライン、またはその構成グループの行メニュー(⋯、右クリック、または Shift+F10)を開きます。
  2. 新しい構成…を選択します。
  3. 構成対象を確認します:構成が属するプロダクトラインです。
  4. longRangeHybrid のような名前を入力します。
  5. バリアントの選択で、各可変点に 1 つのバリアントを選択します。選択の下にすぐ判定が表示されます(例:Valid: meets every rule や Breaks the rule wallboxNeedsLargePack)。
  6. 作成をクリックします。

構成は、@HolarchConfiguration の印付きで、プロダクトラインの最後の構成の後に、テキストに書き込まれます。1 回の元に戻すですべて取り消せます。ブラウザーは、プロダクトラインの構成グループでそれを選択します。

インスペクターのプロダクトラインセクションの新しい構成…や、⌘K / Ctrl+K からもダイアログを開けます。

構成の選択を変更する

  1. ブラウザー(またはビュー)で構成を選択します。
  2. インスペクターの構成セクションで、可変点のリストから別のバリアントを選択します。

テキストのバインディングが書き換えられ(part :>> pack = BatteryPack::standardPack;)、判定が更新されます。1 回の元に戻すですべて取り消せます。選択を除去するには未選択を選択します。モデルにエラーが増える選択は、理由とともに拒否されます。

モデルを 1 つの構成として表示する

  1. トップバーでView as ▾(構成を選択するまではAll configurations ▾と表示されます)をクリックし、構成を選択します。トップバーの下に、例えば Viewing configuration plugInHybrid. というバナーと、当てはまる要素の数が表示されます。General View、Interconnection View、Grid ビューでは、選択されていないバリアントと他の構成は非表示になり、各可変点は pack : BatteryPack = largePack のようにその選択を表示します。データベース、インスペクター、プロダクトラインページも同じ選択に従います。
  2. 元に戻るには、View as ▾ → All configurationsを選択するか、バナーのLeaveをクリックします。

Individual プランと Team プランでは、構成を表示したまま編集できます。各編集は SysML v2 のテキスト編集で、適用前にチェックされ、それぞれ 1 回の元に戻すで取り消せます。

  • バリアントを選択すると、構成にバインディングが書き込まれます(part :>> pack = BatteryPack::largePack;)。
  • 変更した属性値は構成自身の値になります。定義は元の値を保持します。
  • 新しいパートとアクションは構成に属します。
  • 省略できる継承された要素を削除すると、構成に part :>> roofBox[0]; が書き込まれます。必須の継承された要素はそこでは削除できません。エディターで変更してください。
  • 作成したリスク、タスク、その他の Holarch 項目は、その構成に適用されます。

Free プランでは、構成の表示は読み取り専用です。構成のインスペクターでビューで表示 ▾を使うと、そのプロダクトラインのビューがその構成として表示されて開きます。

トレードスタディで構成を比較する

  1. リスク、課題、判断 → トレードスタディと、スタディを開きます(または+ 新しいトレードスタディをクリックします)。
  2. 代替案で、+ プロダクトラインから…をクリックします。
  3. Fromで、Configurations of …(プロダクトライン)またはVariants of …(可変点)を選択します。
  4. 不要な項目のチェックを外し、追加をクリックします。

各構成またはバリアントが、モデル要素にリンクされた代替案になります。他のトレードスタディと同様に評価基準と値を追加するか、モデルから値を取得を使います。

作業例:Hybrid Car デモ

プロジェクトを管理で、プロジェクトファイル ▾ → 新しいデモプロジェクト → Hybrid Car (SysML v2)でデモを作成します。

  1. モデル → ブラウザーを開き、Vehiclesを展開します。BatteryPack と CarLine にはプロダクトラインのアイコンが付いています。CarLine には、longRangeHybrid、plugInHybrid、selfChargingHybrid を含む構成グループがあります。
  2. CarLine を選択します。プロダクトラインセクションに、可変点 pack(standardPack、largePack)と charger(noCharger、wallbox)、ルール wallboxNeedsLargePack、3 つの構成が一覧表示され、すべて有効です。組み合わせは 4 つで、ルールで許可されるのは 3 つ、除外されるのは 1 つ(標準パックと wallbox の組み合わせ)と報告されます。
  3. selfChargingHybrid を選択し、chargerをwallboxに変更します。判定が Breaks the rule wallboxNeedsLargePack になります。⌘Z / Ctrl+Z を押して元に戻します。
  4. ビュー carLineVariants(ダイアグラム)を開きます。View as ▾ → plugInHybridを選択します。BatteryPack のボックスには largePack だけが残り、CarLine のボックスには pack : BatteryPack = largePack と variation charger : Component = wallbox が表示されます。
  5. トレードスタディ → Configuration Line-up(TR-2)を開きます。その代替案は 3 つの構成で、価格、電気走行距離、充電の利便性で採点されています。

ヒントとよい進め方

  • 共有する設計はプロダクトラインに、違いだけをバリアントに置きます。バリアントは変更するものを再定義します(attribute :>> capacity = 12 [kW*h];)。
  • 組み合わせが許可されないとわかったら、すぐにルールを書きます。そうすれば、判定が不適切な構成をすぐに見つけます。
  • 構成には、選択の内容ではなく製品にちなんだ名前を付けます(largePackWallbox ではなく plugInHybrid)。
  • 構成ごとに 1 つのビューを作る代わりに、プロダクトラインごとに 1 つのビューを使い、構成を切り替えます。

よくある間違い

  • 構成がプロダクトラインの下に表示されない。構成はプロダクトラインを型とする必要があります(part x : CarLine)。インスペクターでそのTypeを確認してください。
  • 判定が不明のままになる。ルールが、この構成では値を持たない値を読み取っています。すべての可変点でバリアントを選択するか、値に既定値を与えてください。
  • 選択が拒否される。そのバリアントは、その可変点のバリアントではありません。インスペクターのリストから選択するか、テキストで名前を修正してください。

他の機能との関係

  • エディター:挿入 ▾で Variation、Variant、Configuration、Variant Choice を書けます。ここにあるものはすべて通常の SysML v2 テキストなので、インポート、エクスポート、他の SysML v2 ツールで読み取れます。
  • トレードスタディ:代替案としての構成とバリアント。
  • 信頼性ブロック図:可変点のバリアントは代替であるため、ダイアグラムはView as ▾の構成で選択されたバリアントだけを数えます。すべての構成を表示している場合、可変点は独自の値を持つ 1 つのブロックになり、ペインに構成を選択するよう表示されます。
  • モデルチェック:検証 → モデルチェックは、ルールに違反する構成や、可変点にバリアントを選択していない構成をそれぞれ報告します(ProductLine.3、エラー)。メモは判定(例:Breaks the rule wallboxNeedsLargePack)で、違反したルールは関連要素として一覧表示されます。修正 → Open Itemで構成を開きます。API と MCP も同じ指摘事項を報告します(run_model_checks、GET …/model-checks)。
  • 変更要求と履歴:すべての変更は通常のモデル変更で、それぞれ 1 回の元に戻すで取り消せます。

ブラウザー

  • アイコン:プロダクトラインは積み重なったボックス、可変点はひし形、バリアントは塗りつぶしたひし形、構成はスライダーです。各アイコンにはツールチップがあります。
  • 構成グループ:プロダクトラインの行の最初のメンバーです。プロダクトラインの構成を、宣言された場所にかかわらず一覧表示します。そこにある各行は構成そのものを表します。その行メニューには新しい構成…があります。
  • 行メニュー:プロダクトラインとその各構成に新しい構成…があります。
  • スクリーンリーダー:行の名前で、それが何であるかが読み上げられます(例:CarLine, part def, product line や plugInHybrid, part, configuration of CarLine)。

インスペクター

プロダクトライン

  • バリエーションポイント:各可変点と、その選択肢となるバリアント。
  • ルール:プロダクトラインの assert constraint、または No rules: every combination of variants is allowed.
  • 構成:構成とその判定の表。
  • 組み合わせ:バリアントの組み合わせがいくつあり、そのうちいくつがルールで許可、除外、または不明とされるか。
  • 新しい構成…

構成

  • 構成対象:プロダクトライン。
  • 状態:判定。変化するとスクリーンリーダーに読み上げられます。
  • 可変点ごとに 1 つのリスト:選択したバリアント、または未選択。変更は 1 回の元に戻すで取り消せます。
  • ルール:各ルールを Met、Broken、Unknown で表示します。
  • ビューで表示 ▾:プロダクトラインを表示する General View、Interconnection View、Grid ビューを、この構成として開きます。

可変点とバリアント

  • 可変点は、そのバリアントと、選択元の下に各構成が何を選択しているかを一覧表示します。
  • バリアントは、何のバリアント元であるかと、どの構成がそれを選択しているかを表示します。

構成として表示

  • 場所:モデルに構成があるときのトップバー。ブラウザーのタブごとに 1 つの選択です:General View、Interconnection View、Grid ビュー、データベース、インスペクター、プロダクトラインページがそれに従います。
  • コントロール:View as ▾(構成を選択するまではAll configurations ▾と表示されます)。メニューには、すべての構成、各プロダクトラインの構成とその判定、Effectivity ▸(シリアル番号、製造日、またはその両方でモデルを表示します。シリアル番号と日付…は、そのシリアルでその日に製造されたユニットです)、プロダクトラインを管理が一覧表示されます。トップバーの下のバナーには変更 ▾とLeaveがあります。
  • 変わるもの:構成が選択していないバリアントと同じプロダクトラインの他の構成は、それらが所有するものと一緒に非表示になります。可変点はその選択を表示します。レイアウトは配置し直されず、すべての構成で共有されます。
  • 編集:Individual プランと Team プラン。編集はモデルを 1 つの構成として表示するのルールに従います。Free プランや閲覧権限を持つ人の場合、表示は読み取り専用で、バナーにその理由が表示されます。
  • グリッド:Table は非表示の要素を除外し、表の上に選択を示します。Matrix はプロダクトライン全体を表示します。
  • タブごと:選択は、変更するまでブラウザーのタブに保持されます。ダイアグラムリストのビューの画像は、プロダクトライン全体を表示します。
  • スクリーンリーダー:切り替えると、構成と当てはまる要素の数が読み上げられます(例:Viewing configuration plugInHybrid. … elements apply.)。編集できない場合は Read only. が加わります。

メッセージ

メッセージすること
モデルにはまだ可変点がありません。エディターでバリエーションを追加して(挿入 ▾ → Variation)、もう一度お試しください。先に可変点を指定してください。
The model has no configurations or variants yet. …(+ プロダクトラインから…)先に可変点または構成を追加してください。
構成の名前を入力してください。名前に名前を入力します。
… はすでに … で使われています。別の名前を選択してください。同じパッケージ内の別の要素がその名前を持っています。
名前は 1~1,000 文字で、改行を含めることはできません。名前を変更してください。名前を短くするか、改行を除去してください。
拒否される選択または構成モデルにエラーが増えます。メッセージにそのエラーが示されます。テキストを修正するか、別のバリアントを選択してください。
SysML チェッカーが利用できないため、可変点を読み取れません。ページを再読み込みするか、エディターで挿入 ▾ → Configurationを使って構成を作成してください。

制限事項

  • 非常に大きなプロダクトラインでは、組み合わせの数は最初の組み合わせだけをチェックします。構成は常にすべてチェックされます。
  • Free プランでは、1 つの構成として表示したビューは読み取り専用です。
  • まだ対応していません:SysML v2 の構成のリリースまたは廃止。SysML v2 の構成はすべて下書きであるため、構成管理で構成がロックされることはありません。
  • 可変性は SysML v2 モデルを対象とします。その隣にある Holarch 項目(リスク、テスト、タスク、ドキュメントのセクション)はすべての構成に適用されます。ただし、構成を表示している間に作成したものはその構成に適用されます。SysML v2 プロジェクトでは、それらの Applies To はまだ編集できません。

SysML® および OMG® は、米国およびその他の国における Object Management Group, Inc. の登録商標です。