SysML v2
交換 SysML v2 模型
透過預覽將 .sysml 檔案、zip 封存檔和 SysML v2 JSON 匯入 SysML v2 專案,並將模型或套件匯出為 .sysml 文字或 SysML v2 JSON。
本頁內容
概觀
SysML v2 專案以檔案與其他 SysML v2 工具交換模型。匯入和匯出頁面(模型 → 匯入和匯出)可同時處理兩者:
- 匯入會讀取
.sysml檔案、含.sysml檔案的.zip,或 SysML v2 JSON 檔案。它會顯示變更內容的預覽,然後將其套用到此專案(一次復原即可全部撤回),或建立新的 SysML v2 專案。 - 匯出會將整個模型或一個套件寫成 SysML v2 文字(
.sysml)或 SysML v2 JSON(.json)。 - 來自需求工具的 ReqIF 檔案(
.reqif、.reqifz)會匯入為 SysML v2 需求,而需求也可以匯出為 ReqIF:請參閱匯入與匯出 ReqIF 需求。
您也可以直接從檔案建立專案:在管理專案上按一下專案檔案 ▾ → 匯入 SysML v2 檔案…。
提示:若要讓模型與提供 Systems Modeling API 的 SysML v2 模型存放庫保持同步,請使用同一頁面的存放庫區段:請參閱從存放庫提取與推送至存放庫。
概念
檔案格式
| 格式 | 內容 | 匯入 | 匯出 |
|---|---|---|---|
SysML v2 文字(.sysml) | 文字表示法,每個頂層套件一個檔案。 | 是 | 是 |
Zip 封存檔(.zip) | 多個 .sysml 檔案。資料夾會成為套件。 | 是 | 是,匯出多個檔案時 |
SysML v2 JSON(.json) | 元素的扁平清單,每個元素都有 @id 與 @type,與 Systems Modeling API 所使用的相同。 | 是 | 是 |
ReqIF(.reqif、.reqifz) | 來自 DOORS、Polarion、Jama、codebeamer 與其他需求工具的需求,含其屬性、階層與關係。 | 是,轉換為需求 | 是,需求 |
目前尚不支援匯入 KerML 檔案(.kerml)。
ID 與比對
SysML v2 專案中的每個元素都有一個 ID。兩種格式保存 ID 的方式不同:
- JSON 會保留 ID。再次從 JSON 匯入的元素會與具有相同 ID 的元素相符。
- 能理解標準庫參考。來自 Systems Modeling API、SysML v2 Pilot Implementation 或其他存放庫的 JSON,會以標準 ID 指名標準庫元素(如
ISQ::mass、ScalarValues::Real、Parts::Part等單位與類型)。匯入會將它們讀取為相同的庫元素,因此單位與類型仍能解析。 - 要求時,文字也會保留 ID。匯出
.sysml文字時勾選包含元素 ID。每個具名的定義、用法與套件接著都會在其本體的第一行攜帶其 ID:@HolarchMetadata::ElementId { id = "…"; }。再次匯入該文字時,每個具有 ID 的元素都會與具有相同 ID 的元素相符,即使它已被重新命名、移至另一個擁有者或另一個頂層套件,或重新排序。其圖位置、留言、追溯與關聯都會保留。 - 沒有 ID 的文字會依名稱比對。Holarch 依名稱比對頂層套件,並依名稱與位置比對其中的元素。元素相符之處會保留 ID。重新命名的元素若保持原位仍會相符;同時被重新命名並移動的元素會成為新元素。
匯出會在匯出控制項下方註明:「元素 ID 會保留在 JSON 中。在 .sysml 文字中,勾選『包含元素 ID』即可保留:再次匯入編輯過的文字時,元素即使經過重新命名或移動,仍會保留其圖位置、留言與追溯。沒有 ID 時,元素會依名稱比對。」
文字中的元素 ID
@HolarchMetadata::ElementId { id = "…"; } 是一般的 SysML v2 中繼資料:ElementId 是 Holarch 自己的庫套件 HolarchMetadata(位於標準庫的 Holarch 下)中的中繼資料定義,與 TBD 及 TBR 並列。其他 SysML v2 工具會將這一行讀取為中繼資料註記;若要解析其名稱,它們需要該庫中的 HolarchMetadata.sysml。
- ID 屬於本體中包含這一行的元素。未命名的元素(連接、接續、註解)不攜帶 ID,仍依其內容比對。
- Holarch 不會將這一行保留為元素。編輯器顯示的模型不含這些行,而本體中只有這一行的元素會顯示為
part engine : Engine;。 - ID 必須是唯一的。當同一個 ID 出現兩次時(例如在文字中複製區塊之後),第一個元素會保留它,副本則成為新元素。
- 不是 UUID 的 ID(例如
"R-17")會轉換為固定的 UUID,因此同一個字串一律對應同一個元素,與 JSON 匯入相同。 - 專案中沒有的 ID 會保留給新元素。在 Holarch 中刪除元素並再次匯入文字,會以其舊 ID 將其找回。
- 在編輯器中,貼上的這一行只在您正在編輯的套件中有效:屬於另一個套件之元素的 ID 在那裡會被忽略,元素會依名稱比對。若要在套件之間移動元素並保留其 ID,請以含 ID 的方式匯出並匯入編輯過的檔案。
Hybrid Car 示範專案的零件定義 Car 在其來源檔案中帶有這樣一行,因此其 ID 在示範專案的每個副本中都相同。
資料夾會成為套件
在 zip 封存檔中,每個資料夾都會成為包含其檔案與子資料夾的套件。封存檔中的檔案 powertrain/engine.sysml 會被讀取為如同寫在 package powertrain { … } 之中。位於封存檔頂層的檔案會依原樣讀取。資料夾與檔案依名稱順序讀取。
預覽比較的內容
預覽中每個頂層套件一列(若為新專案,則每個頂層元素一列)。每一列都有一個結果:
| 結果 | 意義 | 預設匯入 |
|---|---|---|
| 新增 | 專案中沒有該名稱(或 ID)的套件。它會被新增。 | 是 |
| 變更 | 專案中有該套件;匯入會在其中新增、變更或移除元素。詳細資訊會說明數量,例如「新增 3 個,變更 1 個(元素相符之處保留 ID)」。 | 是 |
| 未變更 | 該套件與此專案中的相同。 | 否(無需處理) |
| 衝突 | 該套件無法合併。詳細資訊會說明原因與處理方式。 | 否 |
使用方式
使用時機與原因
當模型在 Holarch 與其他 SysML v2 工具之間,或在 Holarch 專案之間移動時,請使用匯入和匯出:
- 從在其他地方撰寫的模型開始一個 Holarch 專案。
- 引入另一個團隊維護的套件(例如元件庫),並在他們送來新版本時更新它。
- 將套件交給供應商,或交給能讀取 SysML v2 文字或 JSON 的工具。
- 將
.sysml檔案保存在您自己的版本控制中,與 Holarch 專案並列。
將檔案匯入此專案
- 開啟模型 → 匯入和匯出。
- 在匯入下選擇匯入到此專案。
- 將檔案放到放置區域上,或按一下該區域並選擇檔案。
您會看到「正在讀取檔案…」,接著是預覽:頂層套件與檔案的數量、任何問題,以及含匯入、套件、元素與結果的表格。
- 如有問題清單,請閱讀它。清單會列出每個無法剖析的檔案與行,以及每個被略過的檔案。
- 取消勾選您不想匯入的套件。若要取代名稱衝突的套件,請勾選它。
在有項目上限的方案中,預覽會計算匯入後專案將有的項目數(關係不計入)。若超過上限,預覽會說明,例如「此匯入會使專案達到 1,804 個項目;Free 方案允許 1,000 個。」,且在您取消勾選足夠的套件之前,匯入 N 個套件會保持停用。不會套用任何內容,也不會傳送到伺服器。匯入到新專案時,也會以相同方式依您方案的每專案上限檢查。
- 按一下匯入 N 個套件。
通知會顯示「已匯入 N 個套件。」頁面會顯示「已匯入 N 個套件(M 個元素)。復原會以一個步驟還原此匯入。」按一下開啟文字即可查看。
將檔案匯入新專案
- 開啟模型 → 匯入和匯出,並選擇匯入到新的 SysML v2 專案。
- 拖放或選擇檔案。
預覽會列出所有頂層元素,且全部已勾選。
- 取消勾選您不想要的元素,並編輯專案名稱。預設為單一檔案的名稱,或第一個套件的名稱。
- 按一下建立專案。
新專案會在編輯器中開啟。
在管理專案中,專案檔案 ▾ → 匯入 SysML v2 檔案…可一步完成相同的操作。若檔案的部分內容無法讀取,它會先詢問:「發現 N 個問題:檔案的部分內容會被省略。要以其餘內容建立專案嗎?若要先查看問題,請開啟 SysML v2 專案並使用匯入和匯出。」按一下建立專案以繼續。
以新版本更新套件
- 將新版本匯出或接收為
.sysml檔案或 JSON。 - 將其匯入到此專案。
該套件會顯示已變更,並附上新增、變更與移除的元素數量。
- 按一下匯入 1 個套件。
相符的元素會保留其 ID,因此指向它們的關聯(需求關聯、風險、檢視版面配置、留言)會保留。已不在檔案中的元素會移到垃圾桶。
在文字中重新命名與移動元素並保留其 ID
- 將套件匯出為 SysML v2 文字,並勾選包含元素 ID。
- 編輯檔案:重新命名元素、將其移到其他擁有者或另一個套件檔案、重新排序。將每一行
@HolarchMetadata::ElementId保留在其元素的主體內。 - 將編輯後的檔案匯入到此專案。
這些套件會顯示已變更。重新命名與移動的元素計為已變更,而非新增與移除。
- 按一下匯入 N 個套件。
元素會保留其 ID:其圖中位置、留言、追溯與關聯都會保留。移到另一個套件的元素會離開原本所在的套件。
託管服務上的大型匯入
在託管服務上,5,000 個元素以上的匯入由伺服器套用,而非由您的瀏覽器套用。當每個已勾選的套件都是新增或取代衝突時,伺服器會自行讀取檔案(下列步驟)。當某個已勾選的套件為已變更時,您的瀏覽器會照常計算合併,並將變更上傳一次;伺服器接著以一個步驟寫入,並有相同的進度卡片、取消匯入與復原匯入。
- 如同任何匯入一樣,選擇檔案並檢查預覽。
- 按一下匯入 N 個套件(或建立專案)。
檔案只會上傳一次。伺服器以與預覽相同的檢查與相同的元素 ID 讀取它們,並以一個步驟寫入結果。
- 查看視窗底部的進度卡片:它會顯示階段(上傳、讀取、檢查、套用、更新專案索引)與剩餘時間。
您可以離開頁面或關閉分頁。匯入會在伺服器上繼續進行,當您再次開啟專案時,結果就在那裡。匯入套用時,專案的每個開啟副本都會重新載入;尚未送出的編輯會在重新載入後再次送出。
- 其他成員會在同一張卡片以及匯入和匯出頁面上看到「Name 正在匯入 file…」。
- 一次一個匯入:對同一專案的第二個大型匯入會等到第一個完成後才進行。
- 取消匯入(由啟動匯入的人或擁有者執行)會在匯入套用之前停止它。不會變更任何內容。
- 復原匯入:瀏覽器中的 ⌘Z / Ctrl+Z 無法撤回伺服器匯入。按一下匯入和匯出頁面上的復原匯入,可將專案還原到最近一次匯入之前的狀態。復原前的狀態會保留在歷程記錄中,因此匯入後所做的編輯可從那裡復原。
- 專案活動與歷程記錄會將匯入列為一筆由啟動者所做的條目。
匯出模型或套件
- 開啟模型 → 匯入和匯出。
- 在匯出下選擇要匯出的內容:整個模型,或依限定名稱選擇一個套件。
- 選擇格式:SysML v2 文字(.sysml;多個套件用 .zip)或SysML v2 JSON(.json)。
- 若是您會編輯後再匯入的文字,請勾選包含元素 ID。
- 按一下匯出。
會下載一個檔案;當匯出包含多個檔案時則下載一個 zip。通知會顯示「已匯出 <file>。」或「已將 N 個檔案匯出為 zip。」
若要快速匯出一個套件,請使用瀏覽器:套件的列選單有匯出為 .sysml與匯出為 JSON。
匯入與匯出 ReqIF 需求
ReqIF 是需求工具的交換格式。ReqIF 檔案會匯入為一個由 SysML v2 需求組成的套件,而需求也能匯出回 ReqIF,因此需求工具與 SysML v2 專案可以雙向交換相同的需求。
匯入 ReqIF 檔案:
- 開啟模型 → 匯入和匯出(或按一下需求頁面上的匯入…,或在 ⌘K / Ctrl+K 中選擇匯入 ReqIF…)。
- 將
.reqif或.reqifz檔案拖放到方框上,或按一下方框以選擇檔案。每次匯入一個 ReqIF 檔案。 - ReqIF 面板會顯示需求、章節與關係的數量,有多少已轉換、已近似或已省略,以及 SysML v2 文字是否檢查無誤。
- 在簡短名稱來源下,選擇外部 ID(使用者在來源工具中看到的編號,例如
SRS-12)或ReqIF 識別碼(該工具的內部 ID)。沒有外部 ID 的需求會使用識別碼。 - 在關係類型下,選擇每種關係類型要變成什麼:衍生、細化、相依性或省略。預覽會重新計算,且此選擇會保留到下次匯入同一檔案時使用。
- 按一下匯入 1 個套件。按一次復原即可撤回整個匯入。通知會顯示「已從 <title> 匯入 N 個需求。」
匯入會產生的內容:
| ReqIF | SysML v2 |
|---|---|
| 需求(規格物件) | requirement,以外部 ID 或識別碼為簡短名稱,並包含名稱,文字則作為 doc |
| 需求類型 | requirement def,每個 ReqIF 屬性對應一個 attribute |
| 列舉資料型別 | enum def |
| 狀態屬性(草稿、提議、已核准等) | 需求在 Holarch 中的狀態 |
| 章節標題 | 以章節編號為簡短名稱的 package |
| 巢狀需求 | 巢狀 requirement |
| derived from 關係 | 衍生連接 |
| refines 關係 | 附 Refinement 註記的相依性 |
| satisfies、verified by 與其他關係 | 相依性(報告會說明原因) |
| 規格 | 檔案套件內的 package |
表格會變成儲存格之間以 | 分隔的文字行,清單會變成以破折號開頭的行,格式與連結只保留其文字;這些需求會標示為已近似。圖片與內嵌物件不會匯入;含有這類內容的需求會連同原因列出,以便您將檔案附加到它。下載報告會將每個需求與關係及其結果儲存為 CSV;下載 SysML v2 文字會儲存文字。
匯入檔案的較新副本:將其匯入到同一個專案。Holarch 會找到先前匯入的套件,並逐一比較需求:
- 需求會保留其元素 ID,因此圖、satisfy 與 verify 關聯、審查與歷程記錄都會保持連結。重新命名與移動的需求會就地更新。
- 新檔案中缺少的需求會保留。勾選移除此檔案中缺少的 N 個需求可將它們移到垃圾桶。
- 您在 Holarch 中新增的零件、驗證案例與關聯都會保留。
- 只在 Holarch 中變更的需求會保留您的變更。在此處與檔案中都有變更的需求會採用檔案的文字;先前的文字保留在歷程記錄中。預覽會將這些需求列在此處與檔案中皆已變更之下。
匯出為 ReqIF:
- 在匯出下選擇一個套件或整個模型,以及ReqIF(.reqif)或ReqIF 封存檔(.reqifz)。
- 按一下匯出。通知會顯示「已將 N 個需求匯出為 <file>。」
資料庫或需求頁面上的匯出… → 需求 (ReqIF)會以相同方式匯出列出的(或所選的)需求。
檔案包含每個需求的簡短名稱(作為 ReqIF.ForeignID)、名稱、doc(作為 XHTML)、狀態與屬性值,以套件階層作為規格,以及 derive、refine 與 dependency 關係。從 ReqIF 匯入的需求會保留其原始識別碼、類型與關係類型,因此來源工具會更新其需求而非新增副本;再次匯出並匯入該檔案時,每個套件都會顯示為未變更。計算出的屬性值會寫成文字。Satisfy 與 verify 關聯留在 Holarch 中:ReqIF 沒有零件或驗證案例。
從存放庫提取與推送至存放庫
將專案連線到 SysML v2 模型存放庫的一個分支,以讀取其最新提交並將您的變更送回。
- 開啟模型 → 匯入和匯出,找到存放庫區段。
- 輸入存放庫位址(其 Systems Modeling API 的 https 位址),若存放庫需要,也輸入存取權杖。
- 按一下載入專案,然後選擇專案與分支。若要從此模型開始新的存放庫專案,請改為按一下新增存放庫專案。
- 按一下提取…。Holarch 會讀取該分支的最新提交,並列出每項差異:新增、已變更、已移除或衝突。沒有可提取的內容時,您會看到「已是最新:存放庫中沒有變更。」
- 取消勾選您不想要的差異,然後按一下套用提取。按一次復原即可撤回整個提取。
- 變更模型後,按一下推送。自上次同步提交以來的變更會作為一個新提交送到分支。例如您會看到「已推送 3 項變更,提交為 1a2b3c4d。」
衝突是指自上次同步以來,在此處與存放庫中都有變更的元素。未勾選的衝突會保留此專案的版本。
注意:當分支有此專案尚未提取的提交時,推送會被拒絕:「存放庫分支有此專案尚未提取的提交。請先提取,再推送一次。」
實作範例:Hybrid Car 示範專案
請先建立示範專案:在管理專案上按一下專案檔案 ▾ → 新增示範專案 → Hybrid Car (SysML v2)。
- 開啟模型 → 匯入和匯出。在匯出下選擇整個模型與SysML v2 文字,然後按一下匯出。
會下載一個 zip,每個頂層套件一個檔案,例如
Vehicles.sysml、VehicleRequirements.sysml、VehicleBehavior.sysml與VehicleViews.sysml。 - 在文字編輯器中開啟
VehicleRequirements.sysml。將attribute maxCurbMass : MassValue = 1650 [kg];改為1600 [kg]並儲存。 - 回到匯入和匯出,選擇匯入到此專案並拖放
VehicleRequirements.sysml。預覽會將 VehicleRequirements 顯示為已變更,並附上已變更的元素數量。其他套件不在檔案中,因此不會列出。
- 按一下匯入 1 個套件。
該值會在模型中變更。需求 Sedan Mass(VR-1.1)提及
maxCurbMass,因此其關聯會標示為待審查(請參閱SysML v2 專案中的需求與驗證)。按 ⌘Z / Ctrl+Z 可復原匯入。 - 若要從相同檔案開始第二個專案,請選擇匯入到新的 SysML v2 專案,拖放 zip 並按一下建立專案。
提示與良好做法
- 當 ID 很重要時(例如另一個工具依 ID 保留關聯),請使用 JSON 在 SysML v2 工具之間移動模型。當有人要閱讀或審查檔案時,請使用文字;若文字在編輯後會回到 Holarch,請勾選包含元素 ID。
- 交給只閱讀文字的人時,請省略 ID:這些行會為每個元素多出一行。
- 每個檔案保持一個頂層套件。匯出就是以這種方式寫入檔案,之後的匯入便能逐一比對套件。
- 將來自另一個團隊的套件匯入到其專屬的頂層套件中。之後的更新就只會影響該套件。
- 匯入前請檢查問題清單。無法剖析的成員會被省略。
常見錯誤
- 套件顯示衝突:「已存在名為 X 但 ID 不同的套件。」專案中有一個同名套件,但並非從此 JSON 匯入。勾選該列以取代它(舊套件會移到垃圾桶),或匯入到新專案。
- 「此匯入包含兩個名為 X 的頂層套件;只會匯入第一個。」兩個檔案宣告了相同的頂層套件。請將它們合併為一個檔案,或重新命名其中一個。
- 重新命名的元素被匯入為新元素。文字中沒有元素 ID,且該元素同時被重新命名與移動(或其種類與名稱同時變更)。請勾選包含元素 ID匯出,進行變更後再次匯入。
- 匯入後元素遺失。無法剖析的成員會被省略:「此成員無法剖析,已省略。」請修正問題清單所指出的行,然後再次匯入。
- JSON 匯入被拒絕。一次匯入一個 SysML v2 JSON 檔案,且不要同時包含
.sysml檔案。
與其他功能的關聯
- 編輯器:匯入的套件會在此開啟;匯出的檔案就是您在此看到的文字。
- 復原與垃圾桶:按一次復原即可撤回匯入到此專案的整個匯入;它所移除或取代的元素會移到垃圾桶。
- 變更控制:透過匯入而變更的值與文件說明,會像其他任何編輯一樣,將需求關聯標示為待審查。
- Holarch 專案檔案:管理專案上的匯出此專案…會儲存整個 Holarch 專案,包括風險、文件與其他 Holarch 資料。
.sysml與 JSON 只包含模型。 - 轉換:若要在 LML 與 SysML v2 之間移動模型,請建立轉換後的副本(請參閱在 LML 與 SysML v2 之間轉換)。
匯入和匯出頁面
匯入
| 控制項 | 用途 |
|---|---|
| 匯入到此專案 | 將檔案合併到開啟的專案中。只能檢視專案的人無法使用;對他們而言,匯入會建立新專案。 |
| 匯入到新的 SysML v2 專案 | 從檔案建立新專案。 |
| 拖放區 | 「將檔案拖放到此處或按一下以選擇」。接受 .sysml 檔案、由 .sysml 檔案組成的 .zip,或一個 SysML v2 JSON 檔案。 |
| 預覽表格 | 匯入(勾選方塊)、套件(名稱與種類)、元素(數量)、結果(新增、已變更、未變更或衝突,並附詳細資訊)。 |
| 專案名稱 | (僅限新專案)新專案的名稱,最多 200 個字元。 |
| 匯入 N 個套件 / 建立專案 | 套用匯入。 |
| 取消 | 關閉預覽而不匯入。 |
.sysml 文字中位於任何套件之外的元素會一起列在同一列:套件外。
預覽開啟期間若模型變更(另一個分頁、協作者或復原),預覽會重新計算。
匯出
| 控制項 | 用途 |
|---|---|
| 匯出(範圍) | 整個模型,或依限定名稱選擇任何套件。 |
| 作為(格式) | SysML v2 文字(.sysml;多個套件用 .zip)或SysML v2 JSON(.json)。 |
| 包含元素 ID | (僅限文字;預設為關閉)將每個具名元素的 ID 以 @HolarchMetadata::ElementId { id = "…"; } 寫入文字中,讓編輯後再次匯入的副本在重新命名與移動時仍保留 ID。 |
| 匯出 | 下載檔案。 |
文字匯出會為每個頂層套件寫入一個以其命名的檔案(Vehicles.sysml)。套件外的元素會寫入 Outside packages.sysml。JSON 匯出會寫入一個以專案或套件命名的檔案。
存放庫
存放庫區段會將專案連結到提供 Systems Modeling API 之存放庫的一個分支。
- 存放庫位址:存放庫 API 的 https 位址。Holarch 只會連線到公開主機上的 https 位址;網站管理員可限制主機與連接埠。
- 存取權杖:針對您的帳戶與此專案加密儲存,且只會傳送到該位址。它不會再次顯示;將欄位留空即可保留已儲存的權杖。
- 載入專案、專案與分支:選擇要同步的位置。新增存放庫專案會在存放庫中為此模型建立專案。
- 提取…、套用提取:讀取最新提交、審查差異並套用,一次復原即可全部撤回。Holarch 會與上次同步的提交進行比較,因此能分辨您的變更與存放庫的變更。
- 推送:將自上次同步提交以來的變更作為一個提交送出。「沒有可推送的內容:模型與上次同步的提交相符。」表示沒有新內容。
- 設定…可變更連線。中斷連線會移除已儲存的權杖與同步狀態;模型會保留。
- 存放庫操作需要編輯者角色。檢視者無法提取或推送。
- 具有受管制資料機密等級標示的專案會拒絕推送。
檔案的讀取方式
- 在讀取任何內容之前會先檢查檔案:其大小、數量、巢狀層級與文字長度。
- 在 zip 中,隱藏檔案與
__MACOSX資料夾會被忽略。連結、非.sysml的檔案,以及同一路徑的第二份副本會被略過,問題清單會說明原因。 - 文字必須是 UTF-8。允許位元組順序標記。
- 每個匯入的元素在寫入之前都會經過檢查。被拒絕的元素會連同其擁有的成員一起被拒絕;問題清單會計算它們。
- 在 JSON 中,Holarch 不解譯的元素種類會依匯入時的原樣保留:請參閱Holarch 不解譯的元素。
Holarch 不解譯的元素
SysML v2 JSON 可能包含 Holarch 不建模的元素種類,例如 KerML 的 behavior、step 或 interaction。Holarch 會保留它們,而不是省略:
- 每個這類元素都會連同其 ID、名稱、擁有者與原始 JSON(包括其關係,例如 typing、specialization 等,以及它們所擁有的內容)保留在模型中。其成員仍以它為擁有者。
- 瀏覽器會以未解譯標籤顯示其原始種類;將指標移到標籤上可查看說明。屬性面板會顯示其種類、在檔案中的 ID,以及其關係所指向的對象。
- 它無法在 Holarch 中重新命名或編輯。請在其來源工具中變更後再次匯入。您可以移動或刪除它。
- 它沒有 SysML 文字。編輯器會將它及其擁有的一切排除在文字之外,文字上方的附註會說明有多少元素未顯示。編輯文字絕不會移除它們。
.sysml匯出也會將它們排除。 - JSON 匯出會將它原封不動地寫回。只會調整模型中有變更的部分:您刪除或新增的成員、您重新命名的成員,或新的擁有者。
- 匯入預覽會將每個保留的種類以附註列出一次,例如2 個 Behavior 元素依匯入原樣保留。附註不是問題。
不保留的內容:某些工具包住整個匯出的未命名根命名空間(其成員會成為頂層元素),以及值中不支援的元素,這些會列為問題。JSON 大於 256 KB 的元素只會保留其種類與 ID。
訊息
| 訊息 | 意義與修正方式 |
|---|---|
| 請選擇 .sysml 檔案、由 .sysml 檔案組成的 .zip,或 SysML v2 JSON 檔案。 | 未選擇任何檔案。 |
| 找不到 .sysml 檔案。請選擇 .sysml 檔案、由 .sysml 檔案組成的 .zip,或 SysML v2 JSON 檔案。 | 封存檔或所選內容中沒有 .sysml 檔案。 |
| 一次匯入一個 SysML v2 JSON 檔案,且不要同時包含 .sysml 檔案。 | 選擇了多個 JSON 檔案,或 JSON 與文字混在一起。 |
| <file> 不是 ReqIF 檔案(…)。請從來源工具將其匯出為 ReqIF 1.0 或更新版本,然後再次匯入。 | 該檔案不是 ReqIF XML,或其中包含 Holarch 不讀取的 DOCTYPE。 |
| <file> 中沒有需求(沒有 SPEC-OBJECT 元素)。請將規格連同其物件一起匯出,然後再次匯入該檔案。 | 該 ReqIF 檔案有類型但沒有需求。 |
| <title> 有 N 個需求,超過單次匯入可接受的數量(約 M 個)。請將規格匯出為個別的 ReqIF 檔案。 | SysML v2 文字會超過 8 MB 上限。請一次匯入一個規格檔案。 |
| <file> 不是 UTF-8 文字。請將其儲存為 UTF-8 後再次匯入。 | 轉換檔案的編碼。 |
| <file> 不是有效的 ZIP 封存檔。請重新建立封存檔。 | 封存檔已損毀。 |
| <file> 包含加密的檔案。請在不設密碼的情況下建立封存檔。 | 不會讀取受密碼保護的封存檔。 |
| <path> 的壓縮比超過 200:1,這是 zip 炸彈的典型特徵。請重新建立封存檔。 | 基於安全考量,封存檔已被拒絕。 |
| 封存檔使用不支援的壓縮方式。請以標準 ZIP 壓縮建立。 | 使用標準(deflate)壓縮。 |
| 尚不支援匯入 KerML 檔案。 | .kerml 檔案會被略過。 |
| 從封存檔中只會匯入 .sysml 檔案。 | zip 中的其他檔案會被略過。 |
| 不會匯入連結。 | zip 中的符號連結會被略過。 |
| 封存檔中此檔案出現兩次;會匯入第一份副本。 | 兩個項目具有相同路徑。 |
| <file> 不是有效的 JSON。請再次匯出模型。 | JSON 檔案已損毀。 |
| <file> 不是 SysML v2 JSON(具有 @id 與 @type 的元素清單)。請選擇 SysML v2 JSON 匯出檔。 | 該 JSON 是其他格式。 |
| <file> 的第 N 行超過 64 KB。請將該行斷開,然後再次匯入檔案。 | 過長的行會被拒絕。 |
| 此成員無法剖析,已省略。 | 修正問題清單中指出的行。 |
| 具有此 ID 的元素位於此專案的 <element> 內。請先將它移到頂層,或匯入到新專案。 | (衝突)JSON 的頂層套件已存在於模型中較深的層級。 |
| 其中 N 個元素 ID 已在此專案的其他地方使用。請改為匯入到新專案。 | (衝突)JSON 重複使用了其他元素的 ID。 |
| 套件文字在重新產生後無法剖析。請將其匯入到新專案。 | (衝突)無法合併此套件。 |
| N 個 <kind> 元素依匯入原樣保留(未解譯):… | (附註)Holarch 不解譯之種類的元素會原封不動地保留。請參閱Holarch 不解譯的元素。 |
| 值中 <kind> 種類的元素不受支援,已省略。 | 某個值(運算式)包含 Holarch 無法讀取的元素。該值的其餘部分會以文字保留。 |
| <kind> 種類的元素過大,無法完整保留;只保留其種類與 ID。 | 其 JSON 大於 256 KB。 |
| 未套用匯入:… 未變更任何內容。 | 匯入失敗;專案未變更。 |
| 模型是空的。請新增一個套件,然後再次匯出。 | 沒有可匯出的內容。 |
| 要匯出的套件已不存在。請選擇另一個。 | 該套件在頁面開啟期間被刪除。 |
限制
| 限制 | 值 |
|---|---|
| 每次匯入的檔案數 | 2,000 |
每次匯入的 .sysml 文字(解壓縮後) | 8 MB |
| Zip 封存檔 | 16 MB,10,000 個項目 |
| zip 中的資料夾巢狀層級 | 32 層資料夾 |
| 每次匯入的元素數(文字或 JSON) | 100,000 |
| JSON 檔案 | 24 MB,巢狀 64 層 |
| 一個 Holarch 不解譯之元素的 JSON | 256 KB,巢狀 12 層 |
| 行長度 | 64 KB |
ReqIF 檔案(.reqif,或 .reqifz 內的 .reqif) | 64 MB;其產生的 SysML v2 文字必須符合 8 MB 文字上限(約 8,000 到 20,000 個需求) |
- 整個提取的存放庫回應上限為 64 MB,每項存放庫操作在 120 秒後停止。
- 每個帳戶每小時最多可執行 300 項存放庫操作。
- 尚不支援匯入 KerML(
.kerml)檔案。 - 在託管應用程式上,伺服器會讀取最多 1.5 MB
.sysml文字的匯入。較大的匯入會在您的瀏覽器中讀取,結果相同。 - 模型之外的 Holarch 資料(需求狀態、風險、預算、模擬器設定、檢視版面配置)不屬於
.sysml或 JSON 檔案。請使用管理專案上的匯出此專案…來保留它們。
相關頁面
- 文字編輯器與瀏覽器
- 在 LML 與 SysML v2 之間轉換
- SysML v2 專案入門
- 匯入 SysML v1 模型:來自 SysML 1.x 工具的 XMI,轉換為 SysML v2。
- LML 專案(包括將 ReqIF 匯入 LML)與 Holarch 專案檔案的匯入和匯出。
SysML® 與 OMG® 是 Object Management Group, Inc. 在美國及其他國家的註冊商標。