Holarch

SysML v2

SysML v2 變體與組態

在 SysML v2 專案中建立產品線模型:在瀏覽器與屬性面板中的變異點、變體、規則與組態,「新增組態…」,以單一組態呈現的檢視,以及組態的權衡研究。

使用方式 →

本頁內容
  1. 概觀
  2. 概念
    1. 變化點與變體
    2. 產品線
    3. 規則
    4. 組態
  3. 使用方式
    1. 使用時機與原因
    2. 標示變化點
    3. 新增規則
    4. 建立組態
    5. 變更組態的選擇
    6. 以單一組態顯示模型
    7. 在權衡研究中比較組態
    8. 實作範例:Hybrid Car 示範專案
    9. 提示與良好做法
    10. 常見錯誤
    11. 與其他功能的關聯
  4. 瀏覽器
  5. 屬性面板
    1. 產品線
    2. 組態
    3. 變化點與變體
  6. 以組態檢視
  7. 訊息
  8. 限制
  9. 相關頁面

概觀

產品線是一個設計,其中有幾個點讓各產品有所不同,例如電池大小或是否配備充電器。您只需為產品線建模一次,即可查看、檢查與比較任何一個產品,而不必複製模型。

SysML v2 在語言中內建了這項能力。Holarch 在整個應用程式中顯示它:

  • 瀏覽器會標示產品線、變化點、變體與組態,並列出每條產品線的組態。
  • 屬性面板會顯示產品線的點、規則與組態,以及每一項的判定,並讓您變更組態的選擇。
  • 新增組態…會從對話方塊建立組態,並在您選擇時檢查規則。
  • 頂端列中的檢視方式 ▾會將檢視、資料庫、屬性面板與產品線頁面以單一組態的方式顯示。
  • 權衡研究可以比較產品線的組態或某個點的變體。

文字中的變異性在每個方案中都可使用。在 Free 方案中,產品線頁面、新增組態…以及在屬性面板中變更組態的選擇為唯讀;編輯它們屬於 Individual 與 Team 方案。請參閱產品線:方案。

概念

變化點與變體

變化點是設計中各產品有所不同的位置。其變體是允許的選擇。

  • 變化用法是某個設計中的一個點: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 表示壁掛式充電器需要大型電池組:

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

當某個點尚未選擇時,針對它的規則既不算達成也不算違反:其判定為未知。

組態

組態是產品線中的一個產品。它是以產品線指定類型、為每個點繫結一個變體的用法。Holarch 以 @HolarchConfiguration(套件 HolarchVariability)標示它,因此編輯器會註明它尚未選擇的每個點:

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

每個組態都有一個判定:

判定意義
有效每個點都選擇了一個變體,且每條規則都已達成。
違反規則 …違反了某條規則;判定會指出該規則。
不完整某個點尚未選擇變體;判定會指出該點。
未知某條規則無法計算,例如因為其所讀取的數值缺失。

Holarch 也會計算變體的組合數,以及其中有多少是規則所允許的。對於非常大的產品線,它只會檢查最前面的組合,並說明檢查了多少個。

使用方式

使用時機與原因

當數個產品共用同一設計的大部分內容時,請使用變異性:車輛的不同等級、外銷版本、感測器套件、有無某項選配的產品。只需為共用設計建模一次,標示各產品不同之處的點,並為每個產品新增一個組態。如此一來,每個產品都會隨著共用設計的每次變更保持一致。

標示變化點

  1. 開啟編輯器以及包含該設計的套件。
  2. 在產品線的定義中,選擇插入 ▾ → 變化。填入該點的名稱與類型。
  3. 在變化中,為每個選擇各選擇一次插入 ▾ → 變體。
  4. 若要重複使用一組選擇,請在套件層級選擇插入 ▾ → 變化。它會撰寫一個變化定義;請以它為零件指定類型。

瀏覽器現在會以堆疊方塊圖示顯示產品線,並以菱形顯示該點。

新增規則

  1. 在產品線的定義中,撰寫針對其點的 assert constraint,例如 assert constraint r { charger == charger::wallbox implies pack == BatteryPack::largePack }。
  2. 在瀏覽器中選取產品線。

您會在屬性面板的產品線區段中的規則下看到該規則,以及它所排除的組合數。

建立組態

  1. 在瀏覽器中,開啟產品線或其組態群組的列選單(⋯、按右鍵或 Shift+F10)。
  2. 選擇新增組態…。
  3. 檢查組態對象:該組態所屬的產品線。
  4. 輸入名稱,例如 longRangeHybrid。
  5. 在變體選擇下,為每個變化點選擇一個變體。您會立即在選擇下方看到判定,例如有效:符合每條規則或違反規則 wallboxNeedsLargePack。
  6. 按一下建立。

組態會寫入文字中產品線最後一個組態之後,標示為 @HolarchConfiguration,一次復原即可全部撤回。瀏覽器會在產品線的組態群組中選取它。

您也可以從屬性面板產品線區段中的新增組態…,或從 ⌘K / Ctrl+K 開啟此對話方塊。

變更組態的選擇

  1. 在瀏覽器(或檢視)中選取組態。
  2. 在屬性面板的組態區段中,在某個點的清單中選擇另一個變體。

文字中的繫結會被重寫(part :>> pack = BatteryPack::standardPack;),判定也會更新;一次復原即可全部撤回。選擇未選擇即可移除該選擇。會為模型增加錯誤的選擇會被拒絕並說明原因。

以單一組態顯示模型

  1. 在頂端列中按一下檢視方式 ▾(在您選擇之前顯示為所有組態 ▾),並選擇一個組態。頂端列下方的橫幅會顯示,例如正在檢視組態 plugInHybrid。以及適用的元素數量。在 General、Interconnection 與 Grid View 中,未被選擇的變體與其他組態會被隱藏,每個變化點則顯示其選擇,例如 pack : BatteryPack = largePack。資料庫、屬性面板與產品線頁面也會依循相同的選擇。
  2. 若要返回,請選擇檢視方式 ▾ → 所有組態,或按一下橫幅中的離開。

在 Individual 與 Team 方案中,您可以在顯示組態時進行編輯;每次編輯都是一次 SysML v2 文字編輯,在套用前會先檢查,且每次都能以一次復原撤回:

  • 選擇變體會在組態中寫入繫結(part :>> pack = BatteryPack::largePack;)。
  • 變更後的屬性值會成為組態自己的數值;定義會保留其原本的數值。
  • 新的零件與動作屬於該組態。
  • 刪除可以省略的繼承元素,會在組態中寫入 part :>> roofBox[0];。必要的繼承元素無法在那裡刪除;請在編輯器中變更它。
  • 您建立的風險、任務或其他 Holarch 項目會套用到該組態。

在 Free 方案中,組態檢視為唯讀。從組態的屬性面板中,在檢視中顯示 ▾會開啟其產品線的檢視,並以該組態的方式顯示。

在權衡研究中比較組態

  1. 開啟風險、問題與決策 → 權衡研究以及一個研究(或按一下 + 新增權衡研究)。
  2. 在替代方案下,按一下 + 從產品線…。
  3. 在來源下,選擇… 的組態(產品線)或… 的變體(變化點)。
  4. 取消勾選任何不需要的項目,然後按一下新增。

每個組態或變體都會成為一個替代方案,並關聯到模型元素。如同在任何權衡研究中一樣新增準則與數值,或使用從模型擷取值。

實作範例:Hybrid Car 示範專案

在管理專案上使用專案檔案 ▾ → 新增示範專案 → Hybrid Car (SysML v2)建立示範專案。

  1. 開啟模型 → 瀏覽器並展開 Vehicles。BatteryPack 與 CarLine 帶有產品線圖示;CarLine 有一個組態群組,其中包含 longRangeHybrid、plugInHybrid 與 selfChargingHybrid。
  2. 選取 CarLine。產品線區段會列出點 pack(standardPack、largePack)與 charger(noCharger、wallbox)、規則 wallboxNeedsLargePack,以及三個組態,全部為有效。它回報 4 種組合:3 種為規則所允許,1 種被排除(壁掛式充電器搭配標準電池組)。
  3. 選取 selfChargingHybrid,並將 charger 改為 wallbox。判定會變成違反規則 wallboxNeedsLargePack。按 ⌘Z / Ctrl+Z 復原。
  4. 開啟檢視 carLineVariants(圖)。選擇檢視方式 ▾ → plugInHybrid。BatteryPack 方塊只保留 largePack,CarLine 方塊則顯示 pack : BatteryPack = largePack 與 variation charger : Component = wallbox。
  5. 開啟權衡研究 → Configuration Line-up(TR-2)。其替代方案是這三個組態,依價格、電動續航里程與充電便利性評分。

提示與良好做法

  • 將共用設計保留在產品線中,只將差異放在變體中。變體會重新定義其所變更的內容(attribute :>> capacity = 12 [kW*h];)。
  • 一旦知道某個組合不被允許,就立即撰寫規則。判定接著就能立即抓出不良的組態。
  • 以產品而非選擇來命名組態(plugInHybrid,而不是 largePackWallbox)。
  • 每條產品線使用一個檢視,並在組態之間切換,而不是每個組態一個檢視。

常見錯誤

  • 組態未列在其產品線之下。它必須以產品線指定類型(part x : CarLine)。請在屬性面板中檢查其類型。
  • 判定一直是未知。某條規則讀取的數值在此組態中沒有值。請為每個點選擇一個變體,或為該數值提供預設值。
  • 選擇被拒絕。該變體不是該點的變體之一。請從屬性面板的清單中選擇,或修正文字中的名稱。

與其他功能的關聯

  • 編輯器:插入 ▾可撰寫變化、變體、組態與變體選擇。這裡的一切都是一般的 SysML v2 文字,因此匯入、匯出與其他 SysML v2 工具都能讀取。
  • 權衡研究:以組態與變體作為替代方案。
  • 可靠度方塊圖:變化點的變體是替代方案,因此圖只會計算檢視方式 ▾中所選組態選擇的變體。顯示所有組態時,該點是一個具有自己數值的方塊,窗格會提示您選擇一個組態。
  • 模型檢查:驗證 → 模型檢查會回報每個違反規則或讓變化點沒有變體的組態(ProductLine.3,錯誤)。附註即為判定,例如違反規則 wallboxNeedsLargePack,被違反的規則會列為相關元素。修正 → 開啟項目會開啟該組態。API 與 MCP 會回報相同的發現事項(run_model_checks、GET …/model-checks)。
  • 變更請求與歷程記錄:每個變更都是一般的模型變更,每項都能以一次復原撤回。

瀏覽器

  • 圖示:堆疊方塊代表產品線,菱形代表變化點,實心菱形代表變體,滑桿代表組態。每個圖示都有工具提示。
  • 組態群組:產品線列的第一個成員。它會列出產品線的組態,不論其宣告於何處;其中每一列都代表該組態本身。其列選單有新增組態…。
  • 列選單:產品線及其每個組態上都有新增組態…。
  • 螢幕閱讀器:列的名稱會說明它是什麼,例如 CarLine,part def,產品線或 plugInHybrid,part,CarLine 的組態。

屬性面板

產品線

  • 變化點:每個點以及其可選擇的變體。
  • 規則:產品線的 assert constraint,或沒有規則:允許所有變體組合。
  • 組態:組態及其判定的表格。
  • 組合:有多少種變體組合,以及其中有多少是規則所允許、排除或未知的。
  • 新增組態…

組態

  • 組態對象:產品線。
  • 狀態:判定,變更時會向螢幕閱讀器宣告。
  • 每個變化點一個清單:所選的變體,或未選擇。按一次復原即可撤回變更。
  • 規則:每條規則標示為已達成、已違反或未知。
  • 在檢視中顯示 ▾:顯示該產品線的 General、Interconnection 與 Grid View,以此組態的方式開啟。

變化點與變體

  • 變化點會列出其變體,並在選擇者下列出每個組態選擇了什麼。
  • 變體會顯示它是哪一個的變體所屬,以及哪些組態選擇了它。

以組態檢視

  • 位置:模型有組態之後的頂端列。每個瀏覽器分頁一個選擇:General、Interconnection 與 Grid View、資料庫、屬性面板與產品線頁面都會依循它。
  • 控制項:檢視方式 ▾(在您選擇之前顯示為所有組態 ▾)。選單會列出所有組態、每條產品線的組態及其判定、適用性 ▸(依序號、製造日期或兩者顯示模型:序號和日期…代表在該日期製造、具有該序號的單元)以及管理產品線。頂端列下方的橫幅有變更 ▾與離開。
  • 變化內容:組態未選擇的變體以及同一產品線的其他組態會連同其擁有的內容一起隱藏。變化點會顯示其選擇。版面配置不會重新排列,並由每個組態共用。
  • 編輯:Individual 與 Team 方案。編輯遵循以單一組態顯示模型中的規則。在 Free 方案中,以及對於擁有檢視權限的人,該檢視為唯讀,橫幅會說明原因。
  • 格線:表格會略過隱藏的元素,並在表格上方列出所做的選擇。矩陣會顯示整條產品線。
  • 每個分頁:選擇會保留在該瀏覽器分頁中,直到您變更它為止。圖清單中的檢視圖片會顯示整條產品線。
  • 螢幕閱讀器:切換時會宣告組態以及適用的元素數量,例如正在檢視組態 plugInHybrid。… 個元素適用。,無法編輯時另加唯讀。

訊息

訊息處理方式
模型還沒有變化點。請在編輯器中新增變化(插入 ▾ → 變化),然後再試一次。請先標示變化點。
模型還沒有組態或變體。…(+ 從產品線…)請先新增變化點或組態。
請輸入組態的名稱。在名稱中輸入名稱。
… 已在 … 中使用。請選擇其他名稱。同一個套件中的另一個元素已使用該名稱。
名稱長度為 1 到 1,000 個字元,且不含換行。請變更名稱。縮短名稱或移除換行。
被拒絕的選擇或組態它會為模型增加錯誤;訊息會指出該錯誤。請修正文字,或選擇另一個變體。
SysML 檢查器無法使用,因此無法讀取變化點。請重新載入頁面,或在編輯器中以插入 ▾ → 組態建立組態。

限制

  • 對於非常大的產品線,組合計數只會檢查最前面的組合;組態則一律完整檢查。
  • 在 Free 方案中,以單一組態方式顯示的檢視為唯讀。
  • 尚未支援:發行或淘汰 SysML v2 組態。每個 SysML v2 組態都是草稿,因此組態控制不會鎖定任何組態。
  • 變異性涵蓋 SysML v2 模型。模型旁的 Holarch 項目(風險、測試、任務、文件章節)適用於每個組態,但在顯示某個組態時建立的項目除外:它們適用於該組態。在 SysML v2 專案中,它們的「適用於」目前還無法編輯。

SysML® 與 OMG® 是 Object Management Group, Inc. 在美國及其他國家的註冊商標。