Holarch

SysML v2

匯入 SysML v1 模型

將來自 Cameo、MagicDraw、Enterprise Architect、Rhapsody 或 Papyrus 的 SysML 1.x 模型轉換為 SysML v2 文字、檢閱哪些內容改變了形式,並將其匯入 SysML v2 專案。

使用方式 →

本頁內容
  1. 概觀
  2. 概念
    1. 已轉換、已近似與已省略
    2. SysMLv1Library 套件
    3. Opaque 主體成為文字表示
  3. 使用方式
    1. 使用時機與原因
    2. 將 SysML v1 模型匯入專案
    3. 匯入同一模型的較新版本
    4. 保留報告與文字
    5. 從您的 SysML v1 工具匯出模型
  4. 實例演練:CubeSat EO-1 模型
  5. 提示與常見錯誤
  6. 會轉換的內容
  7. 限制
  8. 訊息
  9. 相關頁面

概觀

您可以將 SysML 1.x 模型帶入 SysML v2 專案。Holarch 會讀取模型的 XMI 檔案,將其轉換為 SysML v2 文字並檢查文字,在任何內容變更之前顯示轉換報告。

  • 輸入:XMI 格式的 SysML 1.x 模型(.xmi、.uml、.xml),或 Cameo 或 MagicDraw 專案(.mdzip)。
  • 輸出:專案中的 SysML v2 文字(一次復原即可全部撤回),或一個新的 SysML v2 專案。
  • 報告:每個 v1 元素及其結果:已轉換、已近似或已省略,以及原因。

轉換遵循 OMG SysML 2.0 規格中從 SysML v1 到 SysML v2 的轉換規則,前提是以 XMI 交換的模型帶有足夠的細節。

概念

已轉換、已近似與已省略

v1 模型的每個元素都會得到一個結果:

  • 已轉換:該元素在 SysML v2 中有直接的對應,例如變成 part def 的區塊。
  • 已近似:元素以變更後的形式保留。例如,以介面區塊為型別的完整埠會成為埠,而經過選擇虛擬狀態的轉移會成為每條路徑各一個轉移。
  • 已省略:SysML v2 沒有對應項,或元素指向檔案中不存在的內容。例如流程終止節點、活動分割區、使用案例擴充與實例規格。

報告會以文字說明每個已近似與已省略元素的原因。

SysMLv1Library 套件

某些 SysML v1 屬性沒有 SysML v2 關鍵字,例如區塊的 isEncapsulated 或 refine 關係。轉換器會將它們保留為 SysMLv1Library 套件中的中繼資料,例如 @SysMLv1Library::RefineData { isRefine = true; }。此套件是 Holarch 庫的一部分,因此這些名稱在每個 SysML v2 專案中都能解析。

Opaque 主體成為文字表示

Opaque 行為、opaque 動作、防護條件與約束規格帶有 OCL 或英文等語言的文字。轉換器會將每個主體保留為文字表示:language "OCL" /* … */。以 SysML 或 KerML 撰寫的主體會像其餘文字一樣接受檢查。請參閱文字表示。

使用方式

使用時機與原因

當團隊要將現有的 SysML 1.x 模型移到 SysML v2,或想重複使用其中部分內容時,請使用此匯入。轉換後的文字是一個起點:報告會告訴您哪些內容需要人工審查。

將 SysML v1 模型匯入專案

  1. 開啟 SysML v2 專案,然後按一下模型 → 匯入和匯出。
  2. 在匯入下,選擇匯入到此專案或匯入到新的 SysML v2 專案。
  3. 將 .xmi、.uml、.xml 或 .mdzip 檔案拖放到方框上,或按一下方框以選擇檔案。您會看到一張進度卡片,其階段為正在讀取 XMI 檔案…、正在轉換為 SysML v2…與正在檢查結果…。
  4. 閱讀預覽頂端的從 SysML v1 轉換。它會說明已轉換、已近似與已省略的元素數量,以及 SysML v2 文字是否檢查無誤。
  5. 使用顯示可列出已近似與已省略的元素、只列其中一類,或列出所有元素。每一列會提供元素、其 SysML v1 種類、結果(含 SysML v2 關鍵字與限定名稱)以及原因。
  6. 開啟顯示 SysML v2 文字,在匯入之前閱讀結果。
  7. 在下方表格中清除您不想要的套件,然後按一下匯入 N 個套件(或建立專案)。模型會被匯入,一次復原即可全部撤回。復原會再次將其移除。

匯入同一模型的較新版本

當 SysML v1 模型變更時,請再次匯出,並將新檔案匯入到同一個專案(匯入到此專案)。每個轉換後的元素都會從 XMI 檔案中該元素的 ID(xmi:id)取得其 ID,因此匯入會就地更新元素:在 SysML v1 工具中重新命名或移到另一個套件的元素仍是同一個元素,並保留其圖版面配置、留言、關聯與歷程記錄。報告會說明有多少元素從 SysML v1 模型取得 ID。沒有名稱的元素(連接器、接續)會依其在模型中的位置比對。

在 Holarch 開始從 XMI 檔案衍生 ID 之前就從 SysML v1 模型匯入的專案,會保留其 ID:較新的匯出會依名稱更新其元素,而 SysML v1 模型中新增的元素則從模型取得 ID。

保留報告與文字

  • 按一下下載報告以取得 CSV 檔案,內含每個元素、其結果、其 SysML v2 路徑與原因。
  • 按一下下載 SysML v2 文字以取得轉換後的 .sysml 檔案。

從您的 SysML v1 工具匯出模型

  • Cameo Systems Modeler 與 MagicDraw:直接匯入 .mdzip 專案,或使用 File → Export To → Eclipse UML2 (v5.x) XMI File,然後匯入 .xmi 檔案。
  • Enterprise Architect:選取套件,選擇 Publish → Export XML,選取 XMI 2.1,然後匯入 .xml 檔案。無法直接讀取 Enterprise Architect 專案檔案(.eap、.qea)。
  • IBM Rhapsody:以 XMI toolkit(XMI 2.x)匯出模型,然後匯入該檔案。
  • Eclipse Papyrus:匯入模型的 .uml 檔案。

實例演練:CubeSat EO-1 模型

CubeSat EO-1 示範是一個 LML 專案。其 SysML v1 匯出可作為貼近實際的測試模型。

  1. 開啟 CubeSat EO-1 示範,並以 OMG XMI 2.5.1 格式將其匯出為 UML/SysML XMI(請參閱匯出 UML/SysML 模型(XMI))。
  2. 開啟 SysML v2 專案,按一下模型 → 匯入和匯出,選擇匯入到新的 SysML v2 專案,然後拖放 .xmi 檔案。報告顯示:1,042 個元素,1,007 個已轉換,32 個已近似,3 個已省略。SysML v2 文字檢查無誤。
  3. 將顯示設為已省略。這三列分別是一個使用案例擴充(SysML v2 沒有此元素),以及兩個指向無名稱元素的追溯關係(SysML v2 文字無法參照這類元素)。
  4. 按一下建立專案。新的 SysML v2 專案會在編輯器中開啟,內含衛星的結構、功能、需求與追溯。

提示與常見錯誤

  • 一次匯入一個 XMI 檔案,且不要同時包含其他檔案。一次匯入一個 SysML v1 XMI 檔案,且不要同時包含其他檔案。
  • 為您要追溯的元素命名。指向無名稱元素的關係會被省略,因為 SysML v2 文字是依名稱參照元素。
  • 重新匯入,而不是重新建立。將較新的匯出匯入到同一個專案,而非新專案:元素只在擁有它們的專案內保留其 ID。
  • 先檢查近似項目。這些是意義可能與 v1 模型不同之處,例如以區塊為型別的埠,或零件內部的連接器端點。
  • 同一位置中同名的元素會以 _2 等字尾重新命名。報告會列出每次重新命名。
  • 保存在需求工具中的需求(DOORS、Polarion、Jama、codebeamer)是以 ReqIF 而非 XMI 傳送。請在同一頁面上匯入 .reqif 檔案:它會成為 SysML v2 需求,並附有同類報告(匯入和匯出 ReqIF 需求)。

會轉換的內容

SysML v1SysML v2
模型、套件package
區塊、參與者part def
值型別、資料型別、列舉attribute def、enum def(具有已知 SI 單位的值型別會特化 ISQ 量)
訊號item def
介面區塊port def
零件、參考與值屬性part、ref part、attribute,含多重性與預設值
代理埠、流程屬性port、in/out item 或 attribute
完整埠帶有 @SysMLv1Library::PortData 的 part
連接器、繫結連接器、項流connect, bind, flow
一般化:>
活動、呼叫行為動作、針腳action def、action、參數
控制流程與物件流程、防護條件帶有 if 防護條件與 else 的接續,以及參數之間的流程
初始、終止、決策、合併、分叉、結合start, done, decide, merge, fork, join
狀態機、狀態、區域state def、state、平行狀態
轉移、訊號與時間觸發帶有 accept、accept after、防護條件與效果的 transition
互動帶有生命線與訊息的 occurrence def
使用案例、主體、includeuse case def, subject, include
需求(ID 與文字)requirement <'id'> Name { doc /* text */ }
Satisfy、verify、derive requirement驗證目標中的 satisfy、verify,衍生連接
Refine、trace帶有 SysMLv1Library 中繼資料的 dependency
Allocate、相依性allocate, dependency
約束區塊、約束constraint def, assert constraint
構造型與標記值每個構造型一個 metadata def,並套用其標記
註解、文件說明doc, comment

限制

  • 一個檔案,最大 64 MB。
  • 最多 250,000 個元素,巢狀最多 512 層。巢狀更深或有擁有權循環的模型不會匯入。
  • 在轉換後的模型中,巢狀超過 128 層的元素會以巢狀為原因省略。
  • 轉換後的文字最大 8 MB。
  • 圖及其版面配置不會轉換。請在 SysML v2 專案中建立檢視。

訊息

訊息處理方式
一次匯入一個 SysML v1 XMI 檔案,且不要同時包含其他檔案。單獨匯入 XMI 檔案。
<file> 中沒有 UML 或 SysML 元素。請將模型匯出為 XMI 2.x 後再次匯入。再次將模型匯出為 XMI 2.x。
在 <file> 中找不到 UML 模型。請在 Cameo 或 MagicDraw 中將模型匯出為 Eclipse UML2 XMI,然後匯入 .xmi 檔案。將專案匯出為 XMI。
SysML v1 模型超過 250,000 個元素。請匯出模型中較小的部分。一次匯出一個套件。
轉換後的 SysML v2 文字會大於 8 MB。請匯出模型中較小的部分。一次匯出一個套件。

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