從 SysML v1 到 SysML v2
不需重繪即可將您的 SysML v1 模型移轉到 SysML v2。
將儲存為 XMI(.xmi、.xml、.uml)或 .mdzip 專案封存檔的 SysML v1 模型拖放到 SysML v2 專案中。Holarch 會將其轉換為 SysML v2 文字、檢查文字,並在匯入任何內容之前,回報每個元素為已轉換、近似或省略,並說明原因。
轉換器包含在每個方案中,Free 也不例外。新帳戶在首次登入時會開始 30 天的 Individual 試用:每個專案 10,000 個項目,無需信用卡,結束後回到 Free。已有帳戶?開始試用。
實證:CubeSat EO-1 模型
| 結果 | 元素 |
|---|---|
| 已轉換 | 1,007 |
| 近似 | 32 |
| 省略 | 3 |
| 讀取的元素 | 1,042 |
| SysML v2 文字中的問題 | 0 |
轉換後的文字檢查結果沒有錯誤、沒有警告,且同一模型每次都會轉換為相同的文字。哪些內容被近似與省略
匯入 SysML v1 模型
將 SysML v1 模型的 XMI 檔案或 .mdzip 專案匯入 SysML v2 專案。在建立任何內容之前,轉換報告會列出每個元素為已轉換、近似或省略,並說明原因,且可儲存為 CSV 檔案。範例是 CubeSat EO-1 模型:1,042 個元素,匯入時沒有任何問題。
轉換器為您帶來什麼
一個可以著手工作的 SysML v2 模型,以及一份清楚的待審查清單。
無需重繪
區塊會變成 part def,埠、連接器與項流會一併轉入,需求保留其 id 與文字,滿足、驗證與分配關係仍保持追溯。
涵蓋每個元素的報告
v1 模型的每個元素都會列出其 v1 種類、結果、轉換後的 SysML v2 名稱,以及任何近似或省略之元素的文字原因。可在畫面上篩選,或下載為 CSV。
匯入前先檢查
在 SysML v2 編輯器中隨輸入即時檢查的引擎,也會檢查轉換後的文字。您會先看到結果、文字與報告;匯入是一個復原步驟。
隨 v1 模型的變更重新匯入
元素的 id 取自 v1 模型的 XMI id。將較新的匯出匯入同一專案,元素就會就地更新(即使已重新命名或移動也一樣),並保留其圖配置、留言、關聯與歷程。
可以著手工作的模型
SysML v2 專案的編輯器、檢視、需求、驗證與其他頁面,讀取轉換後的模型就像讀取任何其他模型一樣。
您的 v1 模型保持不變
Holarch 讀取其匯出檔,永遠不會寫回,因此在團隊審查 SysML v2 版本期間,v1 模型仍是參考依據。
運作方式
- 拖放檔案。在 SysML v2 專案中,按一下模型 → 匯入和匯出,選擇匯入到此專案或匯入到新的 SysML v2 專案,然後拖放
.mdzip、.xmi、.uml或.xml檔案。進度卡會顯示讀取、轉換與檢查的過程。 - 審查報告。從 SysML v1 轉換會顯示數量、說明文字檢查是否沒有問題,並列出近似與省略的元素及各自的原因。顯示 SysML v2 文字會開啟結果;下載報告或
.sysml檔案即可保留它們。 - 匯入。取消勾選不需要的套件,然後匯入。一次復原即可再次移除整個匯入。
逐步說明及各工具的匯出設定:請參閱文件中的匯入 SysML v1 模型,規劃整個計畫的移轉則請參閱移轉指南。
轉換後的區塊
part def Rover {
@SysMLv1Library::BlockData { isEncapsulated = true; }
part battery : Battery;
part computer : Computer;
attribute 'power budget' : Types::Power = 120 [SI::W];
connection 'power bus' connect battery.'out' to computer.'in';
satisfy Requirements::'Power Margin' by battery;
flow 'power flow' of Types::Charge from battery.'out' to computer.'in';
}一個封裝區塊的轉換器輸出,含兩個零件、一個以瓦特為單位的值屬性、一個在代理埠之間帶有項流的連接器,以及一個滿足關係。移轉指南展示整個小型模型轉換前後的樣貌。
可讀取的內容
- XMI 2.x 格式的 SysML v1:含 SysML 1.x 設定檔的 UML 2.5。
.xmi:XMI 檔案。.xml:以.xml副檔名儲存的 XMI。.uml:XMI 模型檔案。.mdzip:以 XMI 包含模型的壓縮專案封存檔;Holarch 會讀取其中的 XMI。- 其他專案格式:以自有專案格式保存模型的工具,需先將模型匯出為 XMI。
每次匯入一個檔案,最大 64 MB、250,000 個元素與 512 層巢狀。
產出的內容
- SysML v2 文字,匯入到開啟中的專案或新的 SysML v2 專案,作為一個復原步驟。
- 文字檢查,在您匯入之前顯示。
- 轉換報告,涵蓋每個元素,可在畫面上篩選,也可下載為 CSV。
.sysml檔案可供下載,用於審查或其他 SysML v2 工具。
轉換以 OMG SysML 2.0 規格中的 SysML v1 至 SysML v2 轉換為基礎。
已轉換、近似或省略
v1 模型的每個元素都會得到三種結果之一,讓您確切知道該檢查哪裡。
已轉換
該元素有直接對應的 SysML v2 元素。區塊會變成 part def,介面區塊會變成 port def,需求保留其 id 與文字。
近似
該元素以變更後的形式保留。以介面區塊為型別的完整埠會變成埠;經過選擇節點的轉換會變成每條路徑各一個轉換;不屬於已對應 SI 單位的單位會變成實數,並將單位寫在其文件說明中。
省略
SysML v2 沒有對應元素,或該元素指向檔案中不存在的內容。例如流程終止節點、活動分區、使用案例擴充,以及指向未命名元素的關係。
沒有 SysML v2 關鍵字的 SysML v1 特性(例如封裝區塊、完整埠或精化關係),會以 SysMLv1Library 套件的中繼資料保留,Holarch 會在每個 SysML v2 專案中載入此套件。您自己的構造型會變成帶有標記值的中繼資料定義,而不透明行為、防護條件與約束會將其內容保留為文字表示,例如 language "OCL" /* … */。
對應關係
主要的對應關係。文件中列出全部。
| SysML v1 | SysML v2 |
|---|---|
| 套件 | package,巢狀方式與 v1 相同 |
| 區塊、參與者 | part def |
| 值型別、列舉 | attribute def、enum def;具有已知 SI 單位的值型別會特化 ISQ 量 |
| 零件、參考與值屬性 | part、ref part、attribute,含多重性與預設值 |
| 介面區塊、代理埠、流屬性 | port def、port、有方向的 item 或 attribute |
| 連接器、繫結連接器、項流 | connect, bind, flow |
| 活動、動作、控制流與物件流 | action def、動作、帶防護條件的接續、參數之間的流 |
| 狀態機、狀態、轉換 | state def、狀態,以及帶 accept、防護條件與效果的轉換 |
| 需求、滿足、驗證、衍生 | 帶 id 與文字的 requirement、satisfy、verify、衍生連接 |
| 分配、精化、追蹤 | allocate;帶 SysMLv1Library 中繼資料的 dependency |
| 使用案例、互動、約束區塊 | use case def、帶訊息的 occurrence def、constraint def |
| 構造型與標記值 | 每個構造型一個 metadata def,並套用其標記 |
實例:CubeSat EO-1 模型
CubeSat EO-1 示範匯出為 SysML 1.6 XMI 並匯入新的 SysML v2 專案:讀取 1,042 個元素,轉換 1,007 個,近似 32 個,省略 3 個。SysML v2 文字檢查結果沒有錯誤、沒有警告,新專案開啟時即包含衛星的結構、功能、需求與追溯。每個近似與省略的元素,依原因列出:
| 元素 | 結果 | 原因 |
|---|---|---|
| 10 個連接器 | 近似 | 連接器端點位於零件內部;通往它的路徑是根據零件型別推算出來的。 |
| 8 個轉換 | 近似 | 4 個變化與時間觸發條件(例如 when Undervoltage)保留為文件說明;4 個沒有訊號的事件(例如 Contact Start)各得到一個同名的項定義。 |
| 6 個項流 | 近似 | 名稱在同一處使用了兩次;該流已加上後綴重新命名。 |
| 5 個值型別 | 近似 | 該單位(%、GB、Mbps、mNms、W/m^2)不是 Holarch 對應的 SI 單位;值型別為實數,單位寫在其文件說明中。 |
| 2 個控制流 | 近似 | 與帶防護條件的分支並列、但本身沒有防護條件的分支;已為其加上防護條件 true。 |
| 1 個終止狀態 | 近似 | 終止狀態變成一般狀態。 |
| 1 個使用案例擴充 | 省略 | SysML v2 沒有使用案例擴充。 |
| 2 個追蹤關係 | 省略 | 它們指向沒有名稱的元素,而 SysML v2 文字無法參照這些元素。 |
EO-1 檔案是 Holarch 自己的 SysML 1.6 匯出,因此只使用 Holarch 會寫出的那部分 SysML v1。來自其他工具的模型通常會用到更多語言內容,數字也會不同:真正重要的是您自己模型的報告,而且您會在匯入任何內容之前看到它。Holarch 的測試模型以多種 SysML v1 工具的 XMI 形式撰寫,同樣能轉換為檢查無問題的文字,且同一模型每次都會轉換為相同的文字。
常見問題
轉換中會失去什麼?
圖及其配置不會轉換:請在 SysML v2 專案中為重要的圖建立檢視。SysML v2 沒有對應的元素會被省略,例如使用案例擴充、流程終止節點與活動分區;指向未命名元素的關係也會被省略,因為 SysML v2 文字以名稱參照元素(匯出前請先為您要追溯的元素命名)。近似的元素以變更後的形式保留;這些正是意義可能與 v1 模型不同之處,因此請優先審查。報告會列出每一個這類元素及其原因。
轉換後的模型可以直接使用嗎?
它檢查無問題,SysML v2 專案的每個頁面也都能使用它,但請將它視為起點。某些語言之間的差異值得做出建模決策,而不只是翻譯。SysML v2 專案支援的內容與已知缺口:SysML v2 語言涵蓋範圍。
可以轉換多大的模型?
單一檔案最大 64 MB,最多 250,000 個元素、巢狀最多 512 層,轉換後的文字最多 8 MB。較大的模型請逐一套件匯出。您方案的每專案項目數適用於轉換後的模型:Free 為 1,000、Individual 為 10,000、Team 為 50,000。請參閱什麼算作一個項目。超過 10,000 個項目的模型,請申請 Team 評估。
我可以繼續在 SysML v1 工具中工作嗎?
可以。Holarch 讀取匯出檔,永遠不會變更 v1 模型。v1 模型變更時,再次匯出並將新檔案匯入同一專案:元素的 id 取自 XMI 檔案,因此會就地更新,即使經過重新命名或移動也一樣。同一處名稱相同的元素會加上 _2 等後綴重新命名,報告會列出每次重新命名。
我的檔案會送到哪裡?
Holarch 在您的瀏覽器中讀取並轉換 XMI 或 .mdzip 檔案;檔案本身不會上傳。在 app.holarch.app 上,轉換後的 SysML v2 文字會傳送給 Holarch 以準備預覽,且只有在您匯入時才會儲存到您的專案中。託管服務不接受 CUI 或出口管制資料;這類資料請在您自己的環境中執行 Holarch(Enterprise)。詳情請參閱安全性。
保存在需求管理工具中的需求怎麼辦?
它們以 ReqIF(.reqif、.reqifz)這種標準需求交換格式傳遞。Holarch 在 LML 與 SysML v2 專案中都能匯入與匯出 ReqIF。在 SysML v2 專案中,ReqIF 檔案會變成需求、需求定義與套件,並附上轉換內容的報告,需求匯出時會帶回其原始識別碼。在我們將 CubeSat EO-1 示範從 Holarch 匯出為 ReqIF 再匯回的往返測試中,全部 407 個項目與 979 個屬性值都原封不動地回來了。LML 專案中的 ReqIF · SysML v2 專案中的 ReqIF
轉換器的費用是多少?
不另收費:它包含在每個方案中,Free 也不例外。各方案的差異在於每專案項目數,以及建模之外所包含的功能;請參閱定價。
要在您自己的工具中建置移轉功能嗎?
轉換器是 Holarch Language Engine 的一部分,也就是 Holarch 的 SysML v2 專案背後的引擎,並以移轉附加元件的形式授權給工具廠商與整合商。它與在 Holarch 中執行的轉換器相同。
- 由您的產品讀取 XMI 檔案,引擎負責轉換:以文件所述的中立形式將 v1 模型以 JSON 傳送,即可取回 SysML v2 文字、引擎對其的檢查結果,以及涵蓋每個元素的報告(含穩定的原因代碼與轉換後的 SysML v2 名稱),格式為 JSON。
- 在您的產品執行之處執行:在瀏覽器中以 WebAssembly 於 Web Worker 執行,或在您的伺服器上透過 Node.js 或 Python 擴充功能搭配伺服器使用執行。
- 可重現且有上限:同一模型每次都會轉換為相同的文字;支援最多 250,000 個元素的模型,更大的模型會得到錯誤回應,絕不會停滯。
- 由您的授權權杖啟用,無需重新建置,也無需變更程式碼。免費的 60 天評估在您自己的電腦上執行,並附有文件與範例。
一個請求及其回應
// Request (the model shortened)
{ "op": "v1_convert",
"model": { "format": "holarch-xmi-model", … } }
// Answer (shortened)
{ "text": "package 'Rover Model' { … }",
"diagnostics": [],
"report": {
"summary": { "elements": 31, "converted": 27,
"approximated": 2, "dropped": 2 },
"items": [ { "kind": "Association",
"status": "dropped",
"reason": "association" }, … ] } }
引擎 API 參考中的 v1_convert 請求。引擎也提供模擬與伺服器使用附加元件。
在 SysML v2 中查看您自己的模型。
轉換它、閱讀報告,滿意後再匯入。
新帳戶在首次登入時會開始 30 天的 Individual 試用:每個專案 10,000 個項目,無需信用卡,結束後回到 Free。已有帳戶?請在帳戶設定 → 方案與帳單中開始試用。