SysML v2
在 LML 與 SysML v2 之間轉換
製作 LML 專案的 SysML v2 副本,或 SysML v2 專案的 LML 副本,並附上哪些內容可轉換、哪些不可轉換的報告。
本頁內容
概觀
專案的類型(LML 或 SysML v2)在您建立時就已固定。若要在 SysML v2 中處理 LML 模型,或以 LML 頁面處理 SysML v2 模型,請建立轉換後的副本:
- LML 專案上的建立 SysML v2 副本…會將其模型以 SysML v2 文字寫入一個新的 SysML v2 專案。
- SysML v2 專案上的建立 LML 副本…會將其模型轉為新 LML 專案中的 LML 實體與關係。
原始專案絕不會變更。在建立副本之前,報告會列出會轉換的內容(附數量)以及不會轉換的內容(附原因)。同一份報告也會儲存在新專案中。
概念
是副本,而非變更類型
轉換一律會建立新專案。您可以繼續在原始專案中工作,之後再次轉換;每次轉換都會建立另一個新專案。副本與原始專案之間沒有任何連結。
兩種語言如何對應
LML 與 SysML v2 以不同方式描述許多相同的事物。轉換在兩個方向上都使用此對應:
| LML | SysML v2 |
|---|---|
| Asset | 零件定義,並在每個使用處有一個零件用法 |
| Asset 的分解(decomposed by) | 父項定義中的零件用法 |
| Port | 埠用法 |
| Asset 的 Characteristic | 屬性用法 |
| Conduit | 連接用法;兩端都是埠時為介面用法 |
| Input/Output | 項定義,帶有 in 與 out 項參數與流程 |
| Requirement(Number、Name、Description) | 需求用法(簡短名稱、名稱、doc) |
| satisfied by | satisfy |
| Test Case | 帶有 verify 目標的驗證用法 |
| Test Suite | 驗證案例的套件 |
| Action 及其流程 | 帶有接續的動作用法 |
| SYNC 與平行區塊 | 分叉與結合 |
| OR | 決策與合併 |
| LOOP | 迴圈動作 |
| performed by | perform |
| 狀態特性與轉移 | 帶有轉移的狀態定義,由零件展現(exhibit) |
| Equation 及其變數 | 帶有參數的約束定義 |
Holarch 資料會一併帶過去
有些資料在兩種語言中都沒有對應位置。它們是 Holarch 資料,會連同其關聯一起複製:
- 風險、決策、任務、成本、時程、問題、文件與白板都會被複製,並保持與轉換後元素的關聯。
- 需求狀態與驗證方法會留在每個需求上;測試結果會留在每個測試案例上。類別工作流程的自訂狀態也會保留。
- 結構描述的變更會雙向帶過去,包括類別工作流程及其狀態、已淘汰狀態、轉移與核准者。
- 討論留言會跟隨其元素。
- 決策的分支機率會留在其分支上,供模擬器使用。
- 從 SysML v2 副本建立的 LML 副本,會取回第一次轉換所保留的 LML 屬性與標籤。
不會轉換的內容
- 圖版面配置。檢視與圖會在副本中重新繪製。
- 歷程記錄、基準線與變更請求。副本開始時不含這些內容。
- 其中一種語言沒有對應位置的元素,例如 LML 的 Measure 與 Resource,或 SysML v2 的列舉、計算與分析案例。
報告會列出每個這類項目並說明原因。請參閱報告參考。
使用方式
使用時機與原因
當專案的語言不再適合工作時,請進行轉換:
- LML 轉 SysML v2:您的團隊或客戶現在使用 SysML v2,或模型必須與 SysML v2 工具交換。先轉換,再匯出
.sysml或 JSON(請參閱交換 SysML v2 模型)。 - SysML v2 轉 LML:您需要 SysML v2 專案所沒有的 LML 頁面或圖,或您希望以 Holarch 的生命週期形式呈現模型以供審查。
在模型穩定後再轉換,並在依賴副本之前閱讀報告。
建立轉換後的副本
- 在管理專案上,按一下專案列上的 ⋯。
- 選擇建立 SysML v2 副本…(適用於 LML 專案)或建立 LML 副本…(適用於 SysML v2 專案)。
Holarch 會檢查轉換;在大型專案上,視窗底部的進度列會顯示「正在檢查轉換…」。接著對話方塊會連同報告開啟。
- 閱讀報告:
- 已轉換會列出每種項目、其數量以及它會變成什麼,例如「Requirements 24 個需求用法」。
- 未轉換會列出每種不會轉換的項目、其數量與原因。
- 若您需要在 Holarch 之外使用報告,請按一下下載報告 (CSV),以每個項目一列的方式儲存報告。
- 輸入新專案名稱。預設為原始專案名稱後加上「(SysML v2)」或「(LML)」。
- 按一下建立副本。
通知會顯示「已建立「<name>」」。副本會在其首頁開啟。
- 在副本中開啟文件轉換報告。它會依編號與名稱列出每個未轉換的項目。
檢查副本
- 在 SysML v2 副本中,開啟模型 → 編輯器。
模型是一個以專案命名的頂層套件。其中包含 Architecture、System、Items、Requirements、Verification、Behavior、Constraints 與 Views 等套件(只包含有內容的套件)。
- 查看邊欄中的問題標記。若轉換後的文字有問題,對話方塊在您建立副本之前就已說明:「轉換後的文字有 N 個問題。副本會在其編輯器中顯示這些問題。」
- 開啟檢視中的檢視(Architecture Overview、System Connections),查看重新繪製的結構。
- 在 LML 副本中,開啟資料庫與圖,檢查 Asset、Requirement 與動作流程。
實例演練:將 Hybrid Car 示範轉成 LML 副本
請先建立示範專案:在管理專案上按一下專案檔案 ▾ → 新增示範專案 → Hybrid Car (SysML v2)。
- 在管理專案上,按一下 Hybrid Car (SysML v2 demo) 上的 ⋯,然後選擇建立 LML 副本…。副本會命名為「Hybrid Car (SysML v2 demo) (LML)」。
- 閱讀報告。
在已轉換下:零件用法成為 Asset,埠用法成為 Port,屬性成為 Characteristic,連接與介面用法成為 Conduit,需求用法與定義成為 Requirement,驗證用法成為 Test Case,動作成為 Action,狀態與轉移則成為其 LML 對應項。
在未轉換下,其中包括:
- 特化:LML 沒有特化;零件會複製其一般定義的特徵。
SportCar :> Car就是其中之一。 - 重新定義:在每個複製的零件中,重新定義的特徵會取代繼承的特徵。轎車的電池會以 48 kg 複製。
- 列舉(
DriveMode、FuelKind):屬性值以文字保留。 - 計算(
PowerToWeight、ElectricRange)與分析案例(PowerToWeightAnalysis)。 - 繫結連接器(
bind output = transmission.output;):LML 沒有特徵之間的繫結。 - 屬性值:以文字保留在每個 Characteristic 的 Value 中;單位與運算式不會求值。
- 檢視:圖會在 LML 副本中重新繪製。
- 特化:LML 沒有特化;零件會複製其一般定義的特徵。
- 按一下建立副本。
LML 副本會開啟。
fleet.sedan及其零件都是 Asset;需求 Sedan Mass(VR-1.1)是由轎車之 Asset 所滿足的 Requirement。示範的風險、決策與任務也會被複製,並與轉換後的元素關聯。
若要嘗試另一個方向,請建立 CubeSat EO-1 示範(LML 專案),並在其上選擇建立 SysML v2 副本…。
提示與良好做法
- 轉換之前請先整理 LML 專案:將每個 Conduit 連接到恰好兩個 Asset 或 Port,將每個 Characteristic 附加到一個 Asset 或 Equation,並移除空的 Test Suite。否則它們會被回報為未轉換。
- 在 LML 中,若您希望 OR 分支標籤成為防護條件,請將其寫成以模型值構成的布林運算式(例如
speed > 3)。其他標籤會成為接續上的 doc 註解。 - 在 SysML v2 中,請為參與者指定零件定義型別,並為項參數指定項定義型別。未指定型別者不會轉換。
- 保留原始專案。在較大的變更之後,從原始專案再次轉換,而不要同時編輯兩個專案。
常見錯誤
- 預期原始專案會變更。它不會。副本是一個獨立的專案。
- 預期圖會保留其版面配置。版面配置不會轉換;請重新排列新的檢視或圖。
- LML 副本中缺少零件。沒有任何零件使用的零件定義在 LML 中沒有 Asset,因為 LML 只有實例。請在零件中使用該定義,然後再次轉換。
- 報告中有「無法解析」的項目。SysML v2 文字中的某個名稱沒有指向任何對象。請在編輯器中修正該名稱,然後再次轉換。
報告參考
LML 轉 SysML v2
已轉換的項目包括 Asset(零件定義及其零件用法)、Characteristic(屬性)、Port、Conduit(連接或介面)、Input/Output(項定義)、Requirement、Action 與使用案例、動作之間的項流、State、Transition、Equation(約束定義)、Perform、Test Suite、Test Case、Verify、Satisfy,以及 Holarch 項目(連同其關聯複製):成品、陳述、任務、風險、時程項目、成本、問題、決策、危害與失效模式。類別工作流程(專案的結構描述變更)會連同其自訂狀態、轉移與核准者一併帶過去,因此需求與測試案例會保留其自訂的 Status 值。副本會保留專案的正式計畫群與安全性與可靠度開關。
| 未轉換 | 原因 |
|---|---|
| 處於分解迴圈中的 Asset | 包含自身的 Asset 在零件樹中沒有位置。其零件定義會轉換;但不會作為零件使用。 |
| 沒有恰好兩個端點的 Conduit | SysML 連接會結合兩個端點。請將 Conduit 連接到兩個 Asset 或 Port,然後再次轉換。 |
| Conduit 所傳輸的項目 | 此轉換中的連接不攜帶項目。這些項目會轉換為項定義以及動作之間的流程。 |
| 分解為其他 Conduit 的 Conduit | 此處的 SysML 連接不會巢狀;每個 Conduit 都會成為其各自的連接。 |
| 迴圈次數與迴圈指令碼 | 此處的 SysML 迴圈會重複直到某個條件成立;次數會作為 Holarch 資料保留,並由「建立 LML 副本」還原。 |
| 決策分支標籤與機率 | 當決策的每個標籤都是以模型值構成的布林運算式時,這些標籤會成為其防護條件;否則會成為接續上的 doc 註解。機率會作為 Holarch 資料保留供模擬器使用,兩者都會由「建立 LML 副本」還原。 |
| OR、SYNC 與 LOOP 項目 | 這些結構會轉換為 decide/merge、fork/join 與 loop 節點;命名它們的項目不會保留。 |
| 狀態的 entry、do 與 exit 動作 | 這些動作會轉換為動作;此轉換不會填入 SysML 狀態主體。 |
| 不是連接同一狀態機中兩個狀態的轉移 | SysML 轉移會連接同一狀態定義中的兩個狀態。 |
| 轉移的防護條件與觸發 | 它們在 LML 中以自由文字撰寫;會作為 Holarch 資料保留,而非作為 SysML 運算式,並由「建立 LML 副本」還原。 |
| 未由 Asset 指定的狀態 | 狀態需要一個 Asset,也就是其所描述行為的擁有者。 |
| Equation 運算式 | 這些運算式使用的名稱不是 SysML 特徵;每個運算式都會以註解保留在其約束定義中。 |
| 沒有測試案例的 Test Suite | 套件會成為其驗證案例的套件;空的套件沒有內容可容納。 |
| 驗證需求以外對象的測試案例 | SysML 驗證案例只驗證需求。 |
| 測試週期 | 記錄在套件上的測試執行不屬於模型;每個案例的最新結果會保留。 |
| 由其他種類項目滿足的需求 | 例如,在 SysML 中,需求不會滿足另一個需求;請在文字中使用衍生。 |
| 其他關係 | 此轉換沒有對應的 SysML 關係;報告會逐一列出。 |
| Measure | 效能指標在此轉換中沒有 SysML 元素。 |
| Resource | 資源數量(consumes、produces)屬於 LML 模擬器,在此沒有 SysML 元素。 |
| 未附加到 Asset 或 Equation 的 Characteristic | 屬性需要一個擁有者:請由某個 Asset 指定它,或將它設為 Equation 變數。 |
| 其他類別的項目 | 此類別在 SysML v2 專案中沒有 SysML 元素,也沒有 Holarch 位置。 |
| 特性與組態 | 尚未支援:產品線的特性與組態不會成為 SysML v2 的變化點、變體與組態。報告會將它們列為 Feature 項目與 Configuration 項目;請在副本中重新建模變體(請參閱SysML v2 變體與組態)。 |
| 基準線 | LML 專案的基準線不適用於新模型;副本開始時沒有基準線。 |
| 歷程記錄 | 變更歷程會在副本中重新開始。 |
| 變更請求 | LML 變更請求提議變更 LML 項目,而副本中沒有這些項目。 |
| 圖版面配置 | 圖會重新繪製為 SysML v2 檢視;位置不會帶過去。 |
| 文件大綱中已轉換的項目 | 文件會被複製;其大綱中的需求與其他模型項目現在是 SysML 元素,會出現在模型中,而不在大綱中。 |
SysML v2 轉 LML
每個零件用法都會成為一個 Asset,並複製其定義(以及其所特化之定義)的零件、埠與屬性。重新定義會取代其所重新定義的內容。連接與介面會成為這些 Asset 之間的 Conduit。需求、驗證案例、satisfy、verify、perform、項參數、狀態與轉移會如上表所示反向對應。接續會成為動作流程;決策的防護條件(或其接續的 doc 註解)會成為 OR 分支標籤,並附上其機率。專案的結構描述變更會帶過去,包括類別工作流程及其自訂狀態、轉移與核准者,因此需求與測試案例會保留其自訂的 Status 值。
| 未轉換 | 原因 |
|---|---|
| 端點無法解析的連接 | 請在文字中修正端點的名稱,然後再次轉換。 |
| 沒有零件使用之定義內的連接 | 每個連接都會成為具有該連接之每個零件的子零件之間的 Conduit;但沒有任何對象使用此定義。 |
| 繫結連接器 | LML 沒有特徵之間的繫結(相等)。 |
| 無法解析的 Verify 關係 | 請修正驗證目標中的需求名稱,然後再次轉換。 |
| 沒有項定義的項參數 | 請以 item def 為參數指定型別以轉換它。 |
| 模型中沒有零件定義的參與者 | 請以 part def 為參與者指定型別以轉換它。 |
| 無法解析為動作與零件的 Perform 用法 | 請從零件定義或零件用法執行(perform)動作,然後再次轉換。 |
| 無法解析的 Satisfy 關係 | 請修正 satisfy 陳述中的名稱,然後再次轉換。 |
| 不是結構化流程的接續 | LML 動作流程是帶有平行、決策與迴圈區塊的序列;其他接續圖會被線性化。 |
| 沒有零件展現的狀態定義 | 這些狀態會在沒有其所描述行為之 Asset 的情況下轉換。 |
| 無法解析為兩個狀態的轉移 | 請修正狀態名稱,然後再次轉換。 |
| 轉移觸發(accept) | LML 轉移只以自由文字保留觸發;接受的訊號不會建立關聯。 |
| 埠、介面與連接定義 | 在零件使用它們之處,會轉換為 Port 與 Conduit;LML 沒有埠、介面或連接類型。 |
| 屬性定義(值型別) | LML 特性沒有型別。 |
| 列舉與列舉值 | LML 沒有列舉;屬性值以文字保留。 |
| 計算、分析案例、關注點 | LML 沒有計算、分析案例或利害關係人關注點。 |
| 檢視與觀點 | 圖會在 LML 副本中重新繪製。 |
| Assignment、if、send 與 accept 動作 | LML 動作沒有陳述式。 |
| 相依性 | LML 沒有通用的相依性。 |
| 配置(Allocation) | 對於由零件執行的動作,請在文字中使用 perform。 |
| 中繼資料 | LML 沒有中繼資料。 |
| 發生項(Occurrence) | LML 沒有發生項。 |
| 被包含的使用案例 | 使用案例之間的 include 關係不會轉換。 |
| 別名 | LML 實體各只有一個名稱。 |
| 參照用法(計算與案例的參數) | 除了 Equation 變數外,LML 沒有參數。 |
| 特化 | LML 沒有特化;零件會複製其一般定義的特徵。 |
| 重新定義 | 在每個複製的零件中,重新定義的特徵會取代繼承的特徵。 |
| 子集化 | LML 沒有子集化。 |
| 匯入 | LML 沒有命名空間;每個實體在專案中都可見。 |
| 與用法有別的定義 | LML 只有實例:零件定義會成為使用它之零件的 Asset,其文字會放入這些 Asset 的描述中。 |
| 零件以外的多重性 | 只有零件的多重性在 LML 中有位置(decomposed by 的 Multiplicity)。 |
| 屬性值 | 值以文字保留在每個特性的 Value 中;單位與運算式不會求值。 |
| 基準線 | SysML v2 專案的基準線不適用於 LML 副本;副本開始時沒有基準線。 |
| 歷程記錄 | 變更歷程會在副本中重新開始。 |
| 變更請求 | SysML 變更請求提議的是文字變更,不適用於 LML 實體。 |
報告 CSV
下載報告 (CSV)會為每種已轉換的項目寫入一列,並為每個未轉換的項目寫入一列。其欄位為結果(已轉換或未轉換)、內容、計數、變成或原因、編號與名稱。
訊息
| 訊息 | 意義與修正方式 |
|---|---|
| 正在檢查轉換…(進度列) | 報告正在準備中。 |
| 這已經是 SysML v2 專案。請改為選擇「建立 LML 副本…」。 | 選擇了錯誤的方向。 |
| 這已經是 LML 專案。請改為選擇「建立 SysML v2 副本…」。 | 選擇了錯誤的方向。 |
| 轉換後的文字有 N 個問題。副本會在其編輯器中顯示這些問題。 | 可以建立副本;請在其編輯器中修正問題。 |
| 轉換後的文字無法剖析(…)。專案未被複製;請連同專案檔案回報此問題。 | 轉換失敗。請攜帶專案檔案聯絡支援。 |
| SysML 檢查器未啟動。請重新載入頁面後再試一次。 | 重新載入後再試一次。 |
| 無法讀取專案。請重新載入頁面後再試一次。 | 重新載入後再試一次。 |
| 未建立副本:… 請重新載入頁面後再試一次。 | 重新載入後再試一次。 |
| 已建立「<name>」 | 副本已建立並開啟。 |
限制
- 圖版面配置、歷程記錄、基準線與變更請求不會轉換。
- 尚未支援:將 LML 產品線(特性與組態)轉換為 SysML v2 變體。
- 報告文件每種最多列出 500 個項目。
相關頁面
SysML® 與 OMG® 是 Object Management Group, Inc. 在美國及其他國家的註冊商標。