Holarch

SysML v2

交換 SysML v2 模型

透過預覽將 .sysml 檔案、zip 封存檔和 SysML v2 JSON 匯入 SysML v2 專案,並將模型或套件匯出為 .sysml 文字或 SysML v2 JSON。

使用方式 →

本頁內容
  1. 概觀
  2. 概念
    1. 檔案格式
    2. ID 與比對
    3. 文字中的元素 ID
    4. 資料夾會成為套件
    5. 預覽比較的內容
  3. 使用方式
    1. 使用時機與原因
    2. 將檔案匯入此專案
    3. 將檔案匯入新專案
    4. 以新版本更新套件
    5. 在文字中重新命名與移動元素並保留其 ID
    6. 託管服務上的大型匯入
    7. 匯出模型或套件
    8. 匯入與匯出 ReqIF 需求
    9. 從存放庫提取與推送至存放庫
    10. 實作範例:Hybrid Car 示範專案
    11. 提示與良好做法
    12. 常見錯誤
    13. 與其他功能的關聯
  4. 匯入和匯出頁面
    1. 匯入
    2. 匯出
  5. 存放庫
  6. 檔案的讀取方式
    1. Holarch 不解譯的元素
  7. 訊息
  8. 限制
  9. 相關頁面

概觀

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. 開啟模型 → 匯入和匯出。
  2. 在匯入下選擇匯入到此專案。
  3. 將檔案放到放置區域上,或按一下該區域並選擇檔案。

    您會看到「正在讀取檔案…」,接著是預覽:頂層套件與檔案的數量、任何問題,以及含匯入、套件、元素與結果的表格。

  4. 如有問題清單,請閱讀它。清單會列出每個無法剖析的檔案與行,以及每個被略過的檔案。
  5. 取消勾選您不想匯入的套件。若要取代名稱衝突的套件,請勾選它。

    在有項目上限的方案中,預覽會計算匯入後專案將有的項目數(關係不計入)。若超過上限,預覽會說明,例如「此匯入會使專案達到 1,804 個項目;Free 方案允許 1,000 個。」,且在您取消勾選足夠的套件之前,匯入 N 個套件會保持停用。不會套用任何內容,也不會傳送到伺服器。匯入到新專案時,也會以相同方式依您方案的每專案上限檢查。

  6. 按一下匯入 N 個套件。

    通知會顯示「已匯入 N 個套件。」頁面會顯示「已匯入 N 個套件(M 個元素)。復原會以一個步驟還原此匯入。」按一下開啟文字即可查看。

將檔案匯入新專案

  1. 開啟模型 → 匯入和匯出,並選擇匯入到新的 SysML v2 專案。
  2. 拖放或選擇檔案。

    預覽會列出所有頂層元素,且全部已勾選。

  3. 取消勾選您不想要的元素,並編輯專案名稱。預設為單一檔案的名稱,或第一個套件的名稱。
  4. 按一下建立專案。

    新專案會在編輯器中開啟。

在管理專案中,專案檔案 ▾ → 匯入 SysML v2 檔案…可一步完成相同的操作。若檔案的部分內容無法讀取,它會先詢問:「發現 N 個問題:檔案的部分內容會被省略。要以其餘內容建立專案嗎?若要先查看問題,請開啟 SysML v2 專案並使用匯入和匯出。」按一下建立專案以繼續。

以新版本更新套件

  1. 將新版本匯出或接收為 .sysml 檔案或 JSON。
  2. 將其匯入到此專案。

    該套件會顯示已變更,並附上新增、變更與移除的元素數量。

  3. 按一下匯入 1 個套件。

    相符的元素會保留其 ID,因此指向它們的關聯(需求關聯、風險、檢視版面配置、留言)會保留。已不在檔案中的元素會移到垃圾桶。

在文字中重新命名與移動元素並保留其 ID

  1. 將套件匯出為 SysML v2 文字,並勾選包含元素 ID。
  2. 編輯檔案:重新命名元素、將其移到其他擁有者或另一個套件檔案、重新排序。將每一行 @HolarchMetadata::ElementId 保留在其元素的主體內。
  3. 將編輯後的檔案匯入到此專案。

    這些套件會顯示已變更。重新命名與移動的元素計為已變更,而非新增與移除。

  4. 按一下匯入 N 個套件。

    元素會保留其 ID:其圖中位置、留言、追溯與關聯都會保留。移到另一個套件的元素會離開原本所在的套件。

託管服務上的大型匯入

在託管服務上,5,000 個元素以上的匯入由伺服器套用,而非由您的瀏覽器套用。當每個已勾選的套件都是新增或取代衝突時,伺服器會自行讀取檔案(下列步驟)。當某個已勾選的套件為已變更時,您的瀏覽器會照常計算合併,並將變更上傳一次;伺服器接著以一個步驟寫入,並有相同的進度卡片、取消匯入與復原匯入。

  1. 如同任何匯入一樣,選擇檔案並檢查預覽。
  2. 按一下匯入 N 個套件(或建立專案)。

    檔案只會上傳一次。伺服器以與預覽相同的檢查與相同的元素 ID 讀取它們,並以一個步驟寫入結果。

  3. 查看視窗底部的進度卡片:它會顯示階段(上傳、讀取、檢查、套用、更新專案索引)與剩餘時間。

    您可以離開頁面或關閉分頁。匯入會在伺服器上繼續進行,當您再次開啟專案時,結果就在那裡。匯入套用時,專案的每個開啟副本都會重新載入;尚未送出的編輯會在重新載入後再次送出。

  • 其他成員會在同一張卡片以及匯入和匯出頁面上看到「Name 正在匯入 file…」。
  • 一次一個匯入:對同一專案的第二個大型匯入會等到第一個完成後才進行。
  • 取消匯入(由啟動匯入的人或擁有者執行)會在匯入套用之前停止它。不會變更任何內容。
  • 復原匯入:瀏覽器中的 ⌘Z / Ctrl+Z 無法撤回伺服器匯入。按一下匯入和匯出頁面上的復原匯入,可將專案還原到最近一次匯入之前的狀態。復原前的狀態會保留在歷程記錄中,因此匯入後所做的編輯可從那裡復原。
  • 專案活動與歷程記錄會將匯入列為一筆由啟動者所做的條目。

匯出模型或套件

  1. 開啟模型 → 匯入和匯出。
  2. 在匯出下選擇要匯出的內容:整個模型,或依限定名稱選擇一個套件。
  3. 選擇格式:SysML v2 文字(.sysml;多個套件用 .zip)或SysML v2 JSON(.json)。
  4. 若是您會編輯後再匯入的文字,請勾選包含元素 ID。
  5. 按一下匯出。

    會下載一個檔案;當匯出包含多個檔案時則下載一個 zip。通知會顯示「已匯出 <file>。」或「已將 N 個檔案匯出為 zip。」

若要快速匯出一個套件,請使用瀏覽器:套件的列選單有匯出為 .sysml與匯出為 JSON。

匯入與匯出 ReqIF 需求

ReqIF 是需求工具的交換格式。ReqIF 檔案會匯入為一個由 SysML v2 需求組成的套件,而需求也能匯出回 ReqIF,因此需求工具與 SysML v2 專案可以雙向交換相同的需求。

匯入 ReqIF 檔案:

  1. 開啟模型 → 匯入和匯出(或按一下需求頁面上的匯入…,或在 ⌘K / Ctrl+K 中選擇匯入 ReqIF…)。
  2. 將 .reqif 或 .reqifz 檔案拖放到方框上,或按一下方框以選擇檔案。每次匯入一個 ReqIF 檔案。
  3. ReqIF 面板會顯示需求、章節與關係的數量,有多少已轉換、已近似或已省略,以及 SysML v2 文字是否檢查無誤。
  4. 在簡短名稱來源下,選擇外部 ID(使用者在來源工具中看到的編號,例如 SRS-12)或ReqIF 識別碼(該工具的內部 ID)。沒有外部 ID 的需求會使用識別碼。
  5. 在關係類型下,選擇每種關係類型要變成什麼:衍生、細化、相依性或省略。預覽會重新計算,且此選擇會保留到下次匯入同一檔案時使用。
  6. 按一下匯入 1 個套件。按一次復原即可撤回整個匯入。通知會顯示「已從 <title> 匯入 N 個需求。」

匯入會產生的內容:

ReqIFSysML 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:

  1. 在匯出下選擇一個套件或整個模型,以及ReqIF(.reqif)或ReqIF 封存檔(.reqifz)。
  2. 按一下匯出。通知會顯示「已將 N 個需求匯出為 <file>。」

資料庫或需求頁面上的匯出… → 需求 (ReqIF)會以相同方式匯出列出的(或所選的)需求。

檔案包含每個需求的簡短名稱(作為 ReqIF.ForeignID)、名稱、doc(作為 XHTML)、狀態與屬性值,以套件階層作為規格,以及 derive、refine 與 dependency 關係。從 ReqIF 匯入的需求會保留其原始識別碼、類型與關係類型,因此來源工具會更新其需求而非新增副本;再次匯出並匯入該檔案時,每個套件都會顯示為未變更。計算出的屬性值會寫成文字。Satisfy 與 verify 關聯留在 Holarch 中:ReqIF 沒有零件或驗證案例。

從存放庫提取與推送至存放庫

將專案連線到 SysML v2 模型存放庫的一個分支,以讀取其最新提交並將您的變更送回。

  1. 開啟模型 → 匯入和匯出,找到存放庫區段。
  2. 輸入存放庫位址(其 Systems Modeling API 的 https 位址),若存放庫需要,也輸入存取權杖。
  3. 按一下載入專案,然後選擇專案與分支。若要從此模型開始新的存放庫專案,請改為按一下新增存放庫專案。
  4. 按一下提取…。Holarch 會讀取該分支的最新提交,並列出每項差異:新增、已變更、已移除或衝突。沒有可提取的內容時,您會看到「已是最新:存放庫中沒有變更。」
  5. 取消勾選您不想要的差異,然後按一下套用提取。按一次復原即可撤回整個提取。
  6. 變更模型後,按一下推送。自上次同步提交以來的變更會作為一個新提交送到分支。例如您會看到「已推送 3 項變更,提交為 1a2b3c4d。」

衝突是指自上次同步以來,在此處與存放庫中都有變更的元素。未勾選的衝突會保留此專案的版本。

注意:當分支有此專案尚未提取的提交時,推送會被拒絕:「存放庫分支有此專案尚未提取的提交。請先提取,再推送一次。」

實作範例:Hybrid Car 示範專案

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

  1. 開啟模型 → 匯入和匯出。在匯出下選擇整個模型與SysML v2 文字,然後按一下匯出。

    會下載一個 zip,每個頂層套件一個檔案,例如 Vehicles.sysml、VehicleRequirements.sysml、VehicleBehavior.sysml 與 VehicleViews.sysml。

  2. 在文字編輯器中開啟 VehicleRequirements.sysml。將 attribute maxCurbMass : MassValue = 1650 [kg]; 改為 1600 [kg] 並儲存。
  3. 回到匯入和匯出,選擇匯入到此專案並拖放 VehicleRequirements.sysml。

    預覽會將 VehicleRequirements 顯示為已變更,並附上已變更的元素數量。其他套件不在檔案中,因此不會列出。

  4. 按一下匯入 1 個套件。

    該值會在模型中變更。需求 Sedan Mass(VR-1.1)提及 maxCurbMass,因此其關聯會標示為待審查(請參閱SysML v2 專案中的需求與驗證)。按 ⌘Z / Ctrl+Z 可復原匯入。

  5. 若要從相同檔案開始第二個專案,請選擇匯入到新的 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 不解譯之元素的 JSON256 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 檔案。請使用管理專案上的匯出此專案…來保留它們。

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