SysML v2
SysML v2 專案入門
在 LML 與 SysML v2 專案之間做選擇、建立 SysML v2 專案或示範專案、撰寫第一個模型並熟悉操作環境。
本頁內容
概觀
Holarch 支援 SysML v2 專案。SysML v2 專案包含一個模型,以 SysML v2 文字表示法撰寫,並以 OMG SysML v2 規格為基礎。
您在編輯器中以文字撰寫模型。Holarch 會以元素保存同一個模型:套件、定義、用法與關係。瀏覽器、各檢視與生命週期頁面(需求、驗證、介面、風險、計畫)都顯示這些相同的元素。
本頁說明兩種專案類型、如何開始 SysML v2 專案,以及各項內容的位置。語言本身請參閱 SysML v2 文字表示法。編輯器與瀏覽器請參閱文字編輯器與瀏覽器。
概念
兩種專案類型
每個 Holarch 專案都是 LML 專案或 SysML v2 專案。您在建立專案時選擇類型。類型是固定的:專案只能透過轉換後的副本變更類型(請參閱在 LML 與 SysML v2 之間轉換)。
| LML | SysML v2 | |
|---|---|---|
| 用途 | 以生命週期建模語言建立系統模型:需求、功能、實體架構、介面、測試、風險與時程。Holarch 會在每個步驟檢查您的成果。 | 以 SysML v2 語言、以文字並使用標準 SysML v2 概念建立模型:套件、定義與用法、埠、連接、動作、狀態與需求。 |
| 建立模型的方式 | 資料庫、表單,以及 30 種以上的圖類型。 | 編輯器中的文字,加上寫入同一份文字的檢視與生命週期頁面。 |
| 可以交換的內容 | Word、Excel、CSV、ReqIF 與 XMI 匯入;Word、Excel 與圖匯出;專案檔案。 | SysML v2 文字(.sysml)與 SysML v2 JSON(請參閱交換 SysML v2 模型);從 XMI 及 Cameo 或 MagicDraw .mdzip 檔案匯入 SysML v1(請參閱匯入 SysML v1 模型);專案檔案。 |
如果不確定,請選擇 LML。它具備所有 Holarch 頁面與圖,適合剛接觸 MBSE 的人。當您的團隊已經以 SysML v2 建模,或要與 SysML v2 工具交換模型時,請選擇 SysML v2。
模型與文字是一體的
SysML v2 專案內沒有檔案。模型是一組元素,編輯器會為每個最上層套件顯示一份文字文件。文字可以解析時,Holarch 會將其套用至模型。當您在其他地方(檢視、表格、屬性面板)變更模型時,文字也會隨之變更。請參閱文字與檢視保持同步。
模型資料與 Holarch 資料
有些資訊是 SysML 文字的一部分;有些則由 Holarch 保存在模型旁。
- 在文字中:元素名稱、簡稱(需求編號)、文件說明、類型、多重性、值,以及
satisfy、verify、perform與connect等關係。 - 在模型旁(Holarch 資料):需求狀態與核准、驗證結果、標籤、指派對象、到期日、討論留言、檢視版面配置、模擬器設定、預算、風險、決策與任務。它們以識別碼關聯到模型元素,因此重新命名與移動後關聯仍會保留。
Holarch 資料不會寫入 SysML 文字,也不屬於 .sysml 匯出的一部分。
定義與用法
大多數 SysML v2 關鍵字都有兩種形式。定義(part def Wheel;)描述一種事物。用法(part frontWheel : Wheel;)是在另一個元素內對定義的一次使用。port def/port、action def/action 與 requirement def/requirement 也是相同的模式。SysML v2 文字表示法有完整的說明。
使用方式
選擇專案類型
建立專案之前請先決定類型。
- 若要使用完整的 Holarch 方法,請選擇 LML:資料庫、LML 圖,以及每個步驟的引導式檢查。
- 當模型必須是 SysML v2 文字時,例如要與另一個 SysML v2 工具交換,請選擇 SysML v2。
- 若要先試用 SysML v2,請開啟 Hybrid Car 示範專案(下下個工作流程),而不是空白專案。
建立 SysML v2 專案
- 開啟管理專案並按一下 + 新增專案。
- 在您要如何為此系統建模?下,選擇 SysML v2。
- 輸入名稱並按一下建立專案。
專案會在首頁開啟。頂端列與管理專案中的專案名稱旁會顯示 SysML v2 標籤。新模型是空的:首頁上的後續動作會顯示在編輯器中撰寫第一個套件。
開啟 Hybrid Car 示範專案
Hybrid Car 示範專案是一個完成的 SysML v2 模型,可供探索與編輯。
- 開啟管理專案。
- 按一下專案檔案 ▾ → 新增示範專案 → Hybrid Car (SysML v2)。
Holarch 會建立專案 Hybrid Car (SysML v2 demo) 並在首頁開啟。按一下導覽列中的編輯器即可閱讀文字。模型有六個最上層套件:Vehicles、VehicleRequirements、VehicleBehavior、VehicleViews、HolarchFrameworks 與 HybridCarArchitecture。每一個都是編輯器套件清單中的一份文件。
示範專案是您自己的副本。可以自由變更,或重新建立以從頭開始。
若要從連結開啟示範專案,請使用 https://app.holarch.app/#/?demo=hybrid。它會建立並開啟示範專案;在託管的應用程式上,會在您登入後開啟。
開啟 Hybrid Car Battery Pack 示範專案
Hybrid Car Battery Pack 示範專案是由供應商建模的汽車牽引電池組,位於獨立的專案中。若您的專案中也有 Hybrid Car 示範專案(無論在其之前或之後建立),三項電池組需求會關聯到汽車的電池需求(BP-1 到 VR-3、BP-2 到 VR-6、BP-3 到 VR-5),因此管理專案 → 計畫群地圖會顯示兩個專案如何連接。這些示範關聯在每個方案上都能運作。
- 開啟管理專案。
- 按一下專案檔案 ▾ → 新增示範專案 → Hybrid Car Battery Pack (SysML v2)。
可以嘗試的事:
- 計算值:在編輯器中,
Pack::mass會加總各模組(每個模組 12 個電芯與一個外殼)、電池管理系統、接線盒、冷卻系統與機殼:43 kg,對照 48 kg 的限制,因此massMargin為 5 kg。Pack::capacity會加總 120 個電芯:1.44 kWh,對照 1.4 kWh。選取屬性即可在屬性面板中查看其值。 - 參數檢視:開啟 packParametrics。容量、質量、充電時間與電芯平衡檢查都各自繫結到電池組的值,且都通過。
- RVTM:容量與質量為通過,充電接受度為未通過(高溫充電測試花了 34 分鐘,對照 30 分鐘),電芯平衡尚未執行。每個驗證案例都從模型計算其判定結果。
- 模擬器:模擬器會在 pack 上開啟,並與 Hot Day Charge 一起執行。按一下執行到結束,然後按一下狀態:電芯過熱時充電會降為半功率,冷卻後恢復。在一起執行下選擇 Cell Over Voltage Fault,即可查看保護性關機與維修重設。
開啟地球觀測衛星示範專案
地球觀測衛星示範專案是一個較大的模型:EO-2 任務,一顆 12U 成像衛星及其地面段,約 3,000 行,分布在 14 個套件中。Holarch 自己的資料已填在模型之上,因此每個頁面都有內容可顯示。
- 開啟管理專案。
- 按一下專案檔案 ▾ → 新增示範專案 → 地球觀測衛星 (SysML v2)。
Holarch 會建立專案 Earth Observation Satellite (SysML v2 demo) 並開啟首頁。此示範專案有 1,549 個項目,超過 Free 方案每個專案 1,000 個項目的限制:在 Free 方案上,其選單項目為停用,並顯示需要 Individual 方案(1,549 個項目)。連結 https://app.holarch.app/#/?demo=eosat 也會建立它。可以嘗試的事:
- 文件:開啟 EO-2 System Requirements Specification。其章節包含 EORequirements 的需求、即時值與驗證矩陣。
- 預算:成像儀的質量超過其 4.0 kg 的分配;TPM Imager Mass 會顯示趨勢。
- 待檢查的連結與 TBD/TBR:已變更的需求與待解決的未定值。
- 模擬器:從 imagingPassFlow 檢視執行成像過境。
- 基準線:將 PDR Data Freeze 基準線與目前的模型比較。
- 檢視:太空船模式、互連檢視與任務指派序列。
撰寫您的第一個模型
此工作流程會以下列文字建立一個小型無人機模型:
package Drone {
private import ISQ::*;
private import SI::*;
part def Battery {
attribute mass : MassValue = 0.4 [kg];
}
part def Quadcopter {
part battery : Battery;
}
}
- 開啟模型 → 編輯器,按一下 + 新增套件,輸入
Drone並確認。編輯器會開啟新套件的文字。 - 如上所示,在套件的大括號內輸入匯入與成員。
- 停止輸入。短暫停頓後,文字下方的狀態列會顯示已套用。模型現在包含該套件、兩個零件定義、屬性與零件,一次復原即可全部撤回。
- 開啟模型 → 瀏覽器並展開 Drone,即可以樹狀結構查看相同的元素。
若某一行有錯誤,狀態列會顯示未套用:請修正第 N 行。在文字再次可以解析之前,模型會保留其上一個正確狀態。請參閱錯誤與草稿。
熟悉操作環境
SysML v2 專案保留 Holarch 的生命週期導覽列。每個群組都在 SysML v2 模型上運作。
- 從首頁開始,查看需要處理的事項、生命週期群組與後續動作。
- 使用模型 → 編輯器撰寫文字,使用模型 → 瀏覽器查看樹狀結構。
- 使用需要與需求與驗證處理需求、驗證案例與可追溯性。
- 使用行為、架構與介面處理檢視與分析頁面。
- 開啟導覽列底部的圖工具,即可查看每個檢視。
- 按 ⌘K / Ctrl+K,可依名稱、簡稱、限定名稱(
Vehicles::Car)或文件說明文字尋找任何元素。 - 剛接觸 SysML v2?開啟簡易模式,即可優先查看最常用的元素。
實作範例:探索 Hybrid Car
此逐步說明使用 Hybrid Car 示範專案。
- 建立示範專案(請參閱開啟 Hybrid Car 示範專案)。它會在首頁開啟。開啟模型 → 編輯器,然後在套件清單中選擇 Vehicles。
- 找到
part def Car。它有零件body、powertrain、frontAxle、rearAxle與spare : Wheel [0..1]。 - 在
part powertrain : Powertrain;中按住 ⌘ / Ctrl 並按一下Powertrain。游標會跳到part def Powertrain,其零件為tank、engine、motor、battery、transmission與controller,並有interface fuel : FuelLine connect tank.fuelOut to engine.fuelIn;等介面。 - 將指標移到
attribute mass : MassValue;中的MassValue上。卡片會顯示其種類,以及來自標準庫的限定名稱。 - 開啟模型 → 瀏覽器。在依名稱篩選中輸入
sedan。樹狀結構會在 Vehicles 中的fleet下顯示sedan。選取它:屬性面板會顯示 Kind part、Typed by Car,以及限定名稱Vehicles::fleet::sedan。 - 開啟首頁。需要與需求的生命週期卡片會計算模型的需求數;需要處理會顯示模型的待審查關聯、逾期的 TBD 與高風險。
- 開啟需要與需求 → 需求。列中包含
VR-1.1sedanMass,這是一個需求用法,其編號就是其簡稱<'VR-1.1'>。 - 開啟圖工具並開啟 driveCycleFlow,這是
DriveCycle的動作流程檢視。在該處重新命名一個動作,然後回到編輯器:VehicleBehavior 會顯示新名稱。
提示與常見錯誤
- 從示範專案開始。從 Hybrid Car 文字中複製模式,是學習表示法最快的方式。
- 匯入單位。
5 [kg]需要SI(而MassValue需要ISQ)為可見。請在套件中加入private import ISQ::*;與private import SI::*;。 - 每個專案保持一個模型。將大型模型拆分為數個最上層套件;每個套件在編輯器中都是一份獨立的文件。
- 選錯類型。類型無法就地切換。請從管理專案製作轉換後的副本(⋯ → 建立 LML 副本…或建立 SysML v2 副本…)。
- 期望在文字中看到狀態。需求狀態、驗證結果與標籤屬於 Holarch 資料。它們不會出現在文字中,也不會出現在
.sysml匯出中。
SysML v2 專案中的導覽列
| 群組 | 頁面 |
|---|---|
| 首頁 | 需要處理、生命週期、後續動作與其他首頁面板 |
| 需要與需求 | 文件、需求、品質、TBD/TBR、待檢查的連結、核准、符合性矩陣* |
| 模型 | 編輯器、瀏覽器、匯入和匯出 |
| 行為 | 功能分析、動作流程、FFBD、狀態機、序列、模擬器 |
| 架構 | 零件、General View、Interconnection View、階層、預算與 TPM |
| 介面 | 介面登錄表、ICD、N² 圖、項目與輸入/輸出 |
| 驗證 | RVTM、驗證案例、偏離與特採*、可追溯性矩陣、計畫群涵蓋範圍、模型檢查 |
| 安全性與可靠度† | 危害記錄、FMECA、故障樹、可靠度方塊圖 |
| 風險、問題與決策 | 風險登錄表、Risk 圖、權衡研究、決策、問題與行動 |
| 方案 | 我的工作、SE 流程、專案管理、圖表、白板、簡報 |
| 控制與審查 | 變更請求、基準線和版本、庫、審查、活動 |
| 框架 | DoDAF、UAF |
* 需開啟正式計畫群。† 需開啟安全性與可靠度計畫群。兩者都在專案偏好設定 → 計畫群功能中切換。
底部的側欄工具與 LML 專案相同:資料庫、圖、垃圾桶、設定與說明。在 SysML v2 專案中,設定也會列出標準庫。不適用於 SysML v2 專案的頁面不會顯示。
這些頁面的說明請參閱 SysML v2 檢視、SysML v2 專案中的需求與驗證、SysML v2 專案中的評估、單位與分析以及 SysML v2 專案中的 Holarch 功能。
簡易模式
簡單模式適合剛接觸 SysML v2 的人。它會顯示大多數模型一開始使用的元素,以一句話說明每個元素,並在您要求之前隱藏其餘元素。它只改變您看到的內容:模型、其文字與每種匯出都維持不變。
開啟或關閉
- 偏好設定 → SysML v2 → 簡單模式。
- 模型 → 瀏覽器頁首中的簡單模式(開啟時呈按下狀態)。
- ⌘K / Ctrl+K → 開啟簡單模式或關閉簡單模式。
預設為關閉。此設定屬於您的帳戶:它會跟著您到任何您登入的電腦,並在您登入時套用帳戶的設定。重設偏好設定不會變更它。
第一次開啟 SysML v2 專案時,頂端列下方會出現一則提示:剛接觸 SysML v2?開啟簡單模式,先查看最常用的元素。按一下開啟即可開啟簡單模式,或按一下 × 關閉提示。無論選擇哪一個,答案都會保存在您的帳戶中,提示不會再出現。在您未回答之前,每次開啟 SysML v2 專案時都會顯示。簡單模式已開啟時不會顯示。
顯示的內容
十二個概念,也就是 Hybrid Car 示範專案與教學課程最常用的概念:套件、零件、屬性、埠、連接與介面、動作、流與接續、狀態、轉換、需求、satisfy 以及驗證。
| 位置 | 在簡單模式中 | 在「顯示全部」之前隱藏 |
|---|---|---|
| General View,新增面板 | 套件、零件定義、零件、埠定義、埠、屬性、介面定義、動作定義、動作、需求定義、需求、驗證案例 | 屬性定義、項定義、列舉定義 |
| Spider 圖,新增面板 | 套件、零件定義、零件、埠定義、埠、屬性、動作定義、動作、狀態、需求定義、需求、驗證案例 | 項定義、項、屬性定義、使用案例 |
| Interconnection View,新增面板 | 零件、埠 | 項目 |
| State Transition View,新增面板 | 初始狀態、最終狀態、狀態、進入動作、執行動作、離開動作 | 平行狀態、區域 |
| Action Flow View,新增面板與 + Action ▾ | 動作、分叉、匯合、決策、合併、泳道 | 接受、傳送、迴圈、終止 |
| 編輯器,插入 ▾ | 套件、零件定義、零件、屬性、埠定義、埠、介面、連接、動作定義、動作、接續、流、狀態定義、狀態、初始狀態、轉換、需求定義、需求、Satisfy、驗證定義、Verify | 所有其他適用於游標位置的程式碼片段 |
| 模型 → 瀏覽器 | 套件、定義、用法、連接、流、轉換、需求、satisfy 與 verify | 匯入、別名、expose、註解、說明文件、中繼資料、庫套件、繫結連接器、KerML 層級元素,以及轉換的觸發條件與效果列 |
將指標指向新增面板中的項目,或瀏覽器中某列的種類,即可閱讀該元素的一句話說明。
Requirement、Use Case、Parametric、Sequence、Package 與 Geometry 檢視,以及 Hierarchy、Tree、IDEF0 與 FFBD 面板會保留所有項目:每一個都以其新增的種類為主題。+ 新增圖、表格、搜尋、屬性面板以及在編輯器中輸入(含自動完成)都不會篩選。
全部顯示
- 新增面板:項目下方的顯示全部(另有 n 個);顯示較少會再次隱藏它們。
- + Action ▾:結尾的顯示全部…會重新開啟包含所有種類的選單。
- 插入 ▾:勾選其標題中的顯示全部。
- 瀏覽器:勾選篩選列中的顯示全部。
「顯示全部」會持續到您重新載入頁面或切換簡單模式為止,期間簡單模式維持開啟。在瀏覽器中,從其他地方開啟的元素(例如屬性面板中的在瀏覽器中顯示)一律會連同其擁有者一起顯示,即使其種類已隱藏。
首頁
首頁與 LML 專案中的頁面相同(請參閱首頁):需要處理(待審查的關聯、逾期的 TBD、失敗的測試、TPM 超限、高風險、模型檢查、儲存狀態)、每個側欄群組一張生命週期卡片,以及後續動作、SE 流程關卡與里程碑等面板。計數來自 SysML v2 模型及其旁的 Holarch 資料。SysML v2 專案不提供 ✦ 撰寫專案摘要。
- 側欄群組會顯示相同的問題徽章,每個群組的總覽頁面會列出需要處理的事項及其數量。
- + 新增面板 → 模型內容會顯示套件(含頂層套件數量)、定義、用法、關係與需求(n 個未滿足 · n 個未驗證)、元素失去擁有者時的錯置的元素,以及最近的變更:最新的模型變更(建立、變更、移動、刪除或還原),附元素的種類與時間。
詢問 AI
詢問 AI 會根據說明與 Docs 回答有關 SysML v2 語言與 Holarch 使用方式的問題。在 Individual 與 Team 方案中,以及使用您自己或您組織的 AI 金鑰時,它也會回答有關開啟中模型的問題並提議變更,這些變更會在套用前開啟供審查。請參閱詢問 AI。
尚未提供
- 透過 Systems Modeling API 提交至
main、標籤與合併:其他工具會提交到變更請求分支,再由核准者在 Holarch 中套用(請參閱 SysML v2 專案中的 API 與 MCP)。 - 編輯語言本身:標準庫為唯讀。
SysML v2 文字表示法詳細列出所支援的語言。
訊息
| 訊息 | 意義 |
|---|---|
| 模型是空的 | 專案沒有任何元素。按一下 + 新增套件,然後在編輯器中撰寫其成員。 |
| 未套用:請修正第 N 行。 | 文字在第 N 行有錯誤。在文字可以剖析之前,模型會維持最後一次正確的狀態。 |
| 僅供檢視:請向擁有者要求編輯權限。 | 您對此專案只有檢視權限。文字與頁面為唯讀。 |
| 此專案需要較新版本的 Holarch。 | 較新版本的 Holarch 儲存了此專案,而此頁面較舊。專案會以僅供檢視開啟,頂端的橫幅會說明原因。按一下橫幅中的重新載入即可取得新版本。 |
限制
- 專案類型在建立時即固定。
- 每個專案一個模型。
- 大於 8 MB 的文字文件不會檢查;請將其分成數個套件。
相關頁面
SysML® 與 OMG® 是 Object Management Group, Inc. 在美國及其他國家的註冊商標。