SysML v2
SysML v2 語言涵蓋範圍
Holarch 的 SysML v2 專案以 OMG SysML v2 規格為基礎,支援該語言的一個子集。本頁列出文字表示法的各個領域、Holarch 的支援程度,以及已知缺口。
各等級的意義
- 支援:編輯器會解析並檢查該構造,模型會保留它,使用它的檢視與頁面也能讀寫它。
- 部分支援:支援,但有該列所述的限制。
- 保留但不解譯:依原樣解析並保留在文字與匯出中,但不賦予其本身的意義。
- 尚未支援:無法使用。
編輯器、檢視與檢查都由同一個語言引擎執行,因此編輯器接受的構造在每個檢視中都相同。另請參閱 Holarch Language Engine。
語言構造
| 領域 | 層級 | 構造 | 限制 |
|---|---|---|---|
| 套件與命名空間 | 支援 | package、巢狀套件、library package、doc、comment … about、註記 // 與 //* */、alias … for …、public、private 與 protected、簡稱 <'1.2'>、引號名稱。 | 庫套件(包括標準庫)為唯讀。 |
| 匯入 | 支援 | 成員與命名空間匯入、::*、遞迴 ::**、帶可見性的匯入、篩選匯入 [@Kind]。 | 匯入篩選依中繼類別選取。 |
| 定義與用法 | 支援 | part、attribute、item、port、connection、interface、flow、action、state、requirement、constraint、calc、use case、analysis、verification、view、viewpoint、concern、enum、occurrence、allocation、metadata;ref、abstract、in、out、inout 與 end。 | 目前沒有已知問題。 |
| 特化、型別與重新定義 | 支援 | 特化 :> 與 specializes、型別 : 與 defined by、子集 :> 與 subsets、重新定義 :>> 與 redefines、共軛 ~、disjoint、特性鏈 a.b.c。 | 目前沒有已知問題。 |
| 多重性 | 支援 | [n]、[n..m]、[*]、[0..*]、ordered、nonunique、以運算式作為界限。 | 目前沒有已知問題。 |
| 值與單位 | 支援 | =、:=、default、5 [kg] 等量值、[m/s^2] 等單位運算式、標準庫的 ISQ 量種類與 SI 及美制單位、因次檢查。 | 目前沒有已知問題。 |
| 約束與計算 | 支援 | 約束與計算的定義與用法、return、assert constraint、呼叫、含算術、比較、邏輯、if ? else 與序列運算的 KerML 運算式,以及帶單位的求值。 | 目前沒有已知問題。 |
| 結構 | 支援 | 埠與共軛埠、connect、帶端點的介面、帶多重性的具名連接端點(connect [1] driver ::> a to [1] driven ::> b)、繫結連接器 bind、項流 flow of T from … to …、message。 | 目前沒有已知缺口。埠、流與 message 的方向都會檢查。Interconnection View 會以多重性標示具名端點,屬性面板也可編輯它們。 |
| 動作 | 部分 | 參數、perform、接續 first … then … 與 then、fork、join、decide、merge、防護條件、accept、send、assign、if、while、for、loop、start、done、terminate。 | 模擬器會執行動作流程(包括 蒙地卡羅執行),並使用模型中的持續時間、分支機率與迴圈次數。 |
| 狀態 | 部分 | entry、do 與 exit 動作、帶觸發條件、防護條件與效果的轉換(在狀態轉換檢視與屬性面板中編輯,並在 Browser 中顯示於轉換之下)、parallel 狀態、巢狀狀態、exhibit。 | 模擬器以 SysML 引擎執行狀態機,搭配刺激輸入,並在執行時點亮作用中的狀態。每種 do 效果都會檢查,觸發條件的酬載會對照其埠檢查,模型的其他部分也可以命名轉換的觸發條件與效果(plugIn.effect.sentMessage)。 |
| 需求 | 支援 | subject、actor、stakeholder、require constraint、assume constraint、frame concern、satisfy … by …、verify、以簡稱作為需求 id、以 doc 作為需求文字。 | 目前沒有已知問題。 |
| 使用案例 | 支援 | 使用案例定義與用法、subject、actor、objective、include use case。 | 目前沒有已知問題。 |
| 分析與驗證案例 | 部分 | 具有主體、目標與 return 結果的分析案例;具有 verify 與判定的驗證案例。 | 分析案例只有在每個輸入都有值時才會求值。標準庫中的權衡研究分析不會求值;Holarch 的權衡研究頁面改以模型中的值為替代方案評分。 |
| 檢視 | 部分 | view、view def、帶 ::*、::** 與篩選的 expose、filter、viewpoint、frame、render、標準檢視定義。 | 序列檢視繪製生命線之間的訊息,並將 if/else、迴圈、分叉與決策中的訊息繪製為帶防護條件的 alt、opt、loop 與 par 片段。 |
| 分配與相依性 | 支援 | allocate a to b、分配定義、dependency from … to …。 | 目前沒有已知問題。 |
| 中繼資料 | 部分 | @Name { … }、#Name 前綴、metadata Name about …、使用者定義的 metadata def、Holarch 用於 TBD 與 TBR 值以及 DoDAF 與 UAF 概念的中繼資料套件、使用者定義關鍵字(#safetyCritical part controller)、語意中繼資料(#fault def BatteryOverheat;),以及具有自身意義的中繼資料:每次使用時都會檢查必要值、宣告型別的值與定義的約束。 | 中繼資料定義的約束讀取的是其自身的值,而不是被註記的元素。以 about 撰寫的中繼資料不會加入基底型別。 |
| 變異性 | 支援 | variation 定義與用法、variant 成員與變體參照(variant plugInHybrid;)、依值選擇(part :>> pack = BatteryPack::largePack;)、標記為 @HolarchConfiguration 的組態。會檢查並求值:變體具有其變化的特性,選擇必須是該點的變體之一,而沒有選擇的點其值為未知,因此針對它的斷言既不算滿足也不算違反。 | 組態寫在文字中;Holarch 尚未在其頁面中搜尋有效的組合。 |
| 個體與時間片段 | 支援 | individual 定義與用法(individual part def Car_VIN1234 :> Car)、snapshot 與 timeslice(也可在 then 之後),以及它們的值與接續。會檢查並求值:快照或時間片段具有其所屬事件的特性,且會優先讀取其自身的值。屬性面板的事件欄位、Browser 的 Individuals 篩選與新增快照…/新增時間片段…,以及帶有 «individual»、«snapshot» 與 «timeslice» 和排列為時間軸的 General View。 | 只有事件可以是個體、快照或時間片段。 |
| 文字表示 | 部分 | rep language "…" /* … */;SysML 與 KerML 的內容會作為程式碼檢查並醒目標示,SysML 約束內容會求值。屬性面板可新增與編輯表示,Action Flow 檢視會為具有表示的動作標示其語言,例如 {Python}。 | 其他語言(例如 Python、OCL 或 MATLAB)的內容會保留為文字,永遠不會執行。內容不能包含 */。 |
| KerML | 部分 | 標準庫的 KerML 文字:核心庫以 KerML 讀取。文字表示的 KerML 內容會檢查。 | .kerml 檔案不會匯入專案,以 KerML 撰寫的模型也不會檢查。 |
| 語言擴充 | 部分 | 來自語意中繼資料的使用者定義關鍵字:#fault def BatteryOverheat; 會特化中繼資料的基底型別,因此具有基底的特性;可限制其註記對象的中繼資料(annotatedElement)。 | 基底型別以名稱讀取(faults meta SysML::Usage)。語言的其他擴充方式無法使用,標準庫也無法編輯。 |
檔案與交換
| 格式 | 層級 | 涵蓋範圍 | 限制 |
|---|---|---|---|
| SysML v2 文字(.sysml) | 支援 | 匯入與匯出,也可使用檔案的 .zip,匯入套用前會先預覽。 | 匯出時勾選包含元素 ID 會保留元素 id;若未勾選,重新匯入時會依名稱比對元素。 |
| SysML v2 JSON | 部分 | 匯入與匯出 Systems Modeling API 的元素格式,並保留元素 id。 | Holarch 不解讀的元素種類會依匯入時的樣子保留,並在匯出時原樣寫回;它們沒有文字,也無法編輯。 |
| SysML v1 模型(XMI、.mdzip) | 部分 | 從 Cameo 或 MagicDraw(.mdzip 或 XMI)、Enterprise Architect、Rhapsody 與 Papyrus(XMI、.uml、.xml)匯入 SysML v2 專案。模型會轉換為 SysML v2 文字並經過檢查,轉換報告會列出每個元素為已轉換、近似或省略,並說明原因,也可匯出為 CSV。匯入是一個復原步驟。 | 僅限匯入。沒有 SysML v2 對應元素的元素(例如流程終止節點、活動分區、使用案例擴充與實例規格)會被省略;圖及其配置不會轉換。單一檔案最大 64 MB 與 250,000 個元素;不讀取 Enterprise Architect 專案檔(.eap、.qea)。 |
| 模型儲存庫 | 支援 | 從提供 Systems Modeling API 的儲存庫中的一個分支提取與推送。 | 每個專案一個分支。 |
| Holarch 中的 Systems Modeling API | 部分 | 其他 SysML v2 工具會讀取專案目前的模型,並提交到變更請求分支。 | main 為唯讀:提交會進入變更請求,由核准者在 Holarch 中套用。 |
| KerML 檔案(.kerml) | 尚未支援 | 不匯入;匯入時會略過。 | 請使用 .sysml 檔案。 |
大小限制與所有其他格式列在匯入和匯出中。
檢查
編輯器會在您輸入時檢查文字,並就地標示每個問題。檢查涵蓋:
- 語法:字元、註解、字串、大括號、
;、預期的名稱與語彙單元。 - 名稱:無法解析、模稜兩可、重複與私有的名稱。
- 型別與特化:循環、正確的定義種類、繼承特性的子集與重新定義。
- 多重性與單位:有效的界限、相符的因次、缺少或未知的單位。
- 運算式:運算元型別、計算引數與布林條件。
- 結構、動作與狀態:連接端點、埠、流與
message的方向、接續目標、控制節點、for迴圈迭代的值、初始轉換、並行區域、轉換觸發條件(經由埠的酬載、at時間)以及do效果(包括send的去向)。 - 使用者定義關鍵字:
#Name命名中繼資料,中繼資料只標示其允許的種類,語意基底型別是適合其所標示元素的定義或用法。 - 中繼資料值:中繼資料定義的每次使用都提供其必要值,每個值都符合其特性的型別,且定義的約束成立。
- 變異性:變化只擁有同種類的變體,選擇是其點的變體,並會註明組態中尚未決定的點。
- 需求、案例與檢視:成員位於正確位置,以及
satisfy、verify、expose與frame的目標。 - 文字表示:SysML 與 KerML 內容可解析並宣告其所表示的元素;Holarch 不認得的語言會加以註明。
- 求值:在目前的值下不成立的約束、需求與目標。
每項檢查及範例訊息:檢查。
已知缺口
- 沒有分析案例求解器。分析案例在每個輸入都有值時才會求值。在參數檢視中,求解會為每個約束找出單一未知數。
- 頁面中沒有變體搜尋。變化、變體與組態會檢查並求值;Holarch 的頁面尚未列出所有有效組合。
- 不支援 KerML 檔案。KerML 僅用於讀取標準庫。
- 語言擴充僅限於使用者定義關鍵字與中繼資料。語意中繼資料會套用其基底型別;其他中繼資料的意義依其定義所述(必要值、值型別與約束),標準庫為唯讀。
- SysML 與 KerML 以外語言的文字表示會保留為文字;Holarch 永遠不會執行它們。
- Systems Modeling API:不支援提交到 main、標籤或合併。其他工具提交到變更請求分支;由核准者在 Holarch 中套用。
Holarch 實作本頁所列的規格子集。新功能列出對它的每項變更。