Holarch

SysML v2

在 LML 與 SysML v2 之間轉換

製作 LML 專案的 SysML v2 副本,或 SysML v2 專案的 LML 副本,並附上哪些內容可轉換、哪些不可轉換的報告。

使用方式 →

本頁內容
  1. 概觀
  2. 概念
    1. 是副本,而非變更類型
    2. 兩種語言如何對應
    3. Holarch 資料會一併帶過去
    4. 不會轉換的內容
  3. 使用方式
    1. 使用時機與原因
    2. 建立轉換後的副本
    3. 檢查副本
    4. 實例演練:將 Hybrid Car 示範轉成 LML 副本
    5. 提示與良好做法
    6. 常見錯誤
  4. 報告參考
    1. LML 轉 SysML v2
    2. SysML v2 轉 LML
    3. 報告 CSV
  5. 訊息
  6. 限制
  7. 相關頁面

概觀

專案的類型(LML 或 SysML v2)在您建立時就已固定。若要在 SysML v2 中處理 LML 模型,或以 LML 頁面處理 SysML v2 模型,請建立轉換後的副本:

  • LML 專案上的建立 SysML v2 副本…會將其模型以 SysML v2 文字寫入一個新的 SysML v2 專案。
  • SysML v2 專案上的建立 LML 副本…會將其模型轉為新 LML 專案中的 LML 實體與關係。

原始專案絕不會變更。在建立副本之前,報告會列出會轉換的內容(附數量)以及不會轉換的內容(附原因)。同一份報告也會儲存在新專案中。

概念

是副本,而非變更類型

轉換一律會建立新專案。您可以繼續在原始專案中工作,之後再次轉換;每次轉換都會建立另一個新專案。副本與原始專案之間沒有任何連結。

兩種語言如何對應

LML 與 SysML v2 以不同方式描述許多相同的事物。轉換在兩個方向上都使用此對應:

LMLSysML v2
Asset零件定義,並在每個使用處有一個零件用法
Asset 的分解(decomposed by)父項定義中的零件用法
Port埠用法
Asset 的 Characteristic屬性用法
Conduit連接用法;兩端都是埠時為介面用法
Input/Output項定義,帶有 in 與 out 項參數與流程
Requirement(Number、Name、Description)需求用法(簡短名稱、名稱、doc)
satisfied bysatisfy
Test Case帶有 verify 目標的驗證用法
Test Suite驗證案例的套件
Action 及其流程帶有接續的動作用法
SYNC 與平行區塊分叉與結合
OR決策與合併
LOOP迴圈動作
performed byperform
狀態特性與轉移帶有轉移的狀態定義,由零件展現(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 的生命週期形式呈現模型以供審查。

在模型穩定後再轉換,並在依賴副本之前閱讀報告。

建立轉換後的副本

  1. 在管理專案上,按一下專案列上的 ⋯。
  2. 選擇建立 SysML v2 副本…(適用於 LML 專案)或建立 LML 副本…(適用於 SysML v2 專案)。

    Holarch 會檢查轉換;在大型專案上,視窗底部的進度列會顯示「正在檢查轉換…」。接著對話方塊會連同報告開啟。

  3. 閱讀報告:
    • 已轉換會列出每種項目、其數量以及它會變成什麼,例如「Requirements 24 個需求用法」。
    • 未轉換會列出每種不會轉換的項目、其數量與原因。
  4. 若您需要在 Holarch 之外使用報告,請按一下下載報告 (CSV),以每個項目一列的方式儲存報告。
  5. 輸入新專案名稱。預設為原始專案名稱後加上「(SysML v2)」或「(LML)」。
  6. 按一下建立副本。

    通知會顯示「已建立「<name>」」。副本會在其首頁開啟。

  7. 在副本中開啟文件轉換報告。它會依編號與名稱列出每個未轉換的項目。

檢查副本

  1. 在 SysML v2 副本中,開啟模型 → 編輯器。

    模型是一個以專案命名的頂層套件。其中包含 Architecture、System、Items、Requirements、Verification、Behavior、Constraints 與 Views 等套件(只包含有內容的套件)。

  2. 查看邊欄中的問題標記。若轉換後的文字有問題,對話方塊在您建立副本之前就已說明:「轉換後的文字有 N 個問題。副本會在其編輯器中顯示這些問題。」
  3. 開啟檢視中的檢視(Architecture Overview、System Connections),查看重新繪製的結構。
  4. 在 LML 副本中,開啟資料庫與圖,檢查 Asset、Requirement 與動作流程。

實例演練:將 Hybrid Car 示範轉成 LML 副本

請先建立示範專案:在管理專案上按一下專案檔案 ▾ → 新增示範專案 → Hybrid Car (SysML v2)。

  1. 在管理專案上,按一下 Hybrid Car (SysML v2 demo) 上的 ⋯,然後選擇建立 LML 副本…。副本會命名為「Hybrid Car (SysML v2 demo) (LML)」。
  2. 閱讀報告。

    在已轉換下:零件用法成為 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 副本中重新繪製。
  3. 按一下建立副本。

    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 在零件樹中沒有位置。其零件定義會轉換;但不會作為零件使用。
沒有恰好兩個端點的 ConduitSysML 連接會結合兩個端點。請將 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. 在美國及其他國家的註冊商標。