匯入與匯出的運作方式
- 匯出 開放給每位專案成員,包括檢視者。匯入 需要擁有者或編輯者角色,因為匯入會變更專案。
- 從「匯入和匯出」頁面進行的匯入會顯示預覽、為匯入的項目指定新的 ID,並算作一個復原步驟。若要更新現有項目而非新增項目,請依 ID、名稱或編號比對。
- 匯入的內容會經過清理:RTF 文字會移除指令碼與不安全的連結,SVG 圖片會移除指令碼與外部參照,而含有 DOCTYPE 或 ENTITY 宣告的 XML 會被拒絕。
- CSV 匯出會使試算表可能當作公式執行的文字失效。檔案名稱會針對每種作業系統進行清理。
- 每個專案都是 LML 專案或 SysML v2 專案。Word、試算表、文字與 ReqIF 匯入適用於 LML 專案。SysML v2 專案可匯入 SysML v2 文字與 JSON,以及以 XMI 或 .mdzip 形式提供、轉換為 SysML v2 的 SysML 1.x 模型。LML 專案也可匯入 XMI。專案檔案,以及共用頁面的 Word、Excel 與 CSV 匯出,兩種專案都適用。
跳至:需求與規格 · 模型 · 試算表與表格 · 文件與報告 · 影像 · 專案檔案 · API 與 MCP
需求與規格
| 格式 | 方向 | 涵蓋範圍 | 已知限制 |
|---|---|---|---|
| Word(.docx) | 匯入 | 規格會成為一份編號文件。標題會依層級巢狀成為 Statements;含有「shall」、「must」、「will」或「should」的段落以及編號清單項目會成為 Requirements。表格會每列成為一個項目,或以表格形式保留在描述中。粗體、斜體、清單與圖片都會保留,插入的追蹤修訂會被讀取,原始檔案會被附加。 | PNG、JPEG、GIF、WebP 與 SVG 以外的格式(如 EMF、WMF)的圖片會被略過。刪除的追蹤修訂文字不會匯入。 |
| 純文字(.txt 或貼上) | 匯入 | 編號行與「shall」句子會成為由 Statements 與 Requirements 組成的編號文件。大綱編號可自動偵測或自行選擇:十進位、羅馬數字、字母、混合層級、DoD 樣式或自訂模式。 | 結構只依據編號與措辭判斷。 |
| ReqIF(.reqif、.reqifz) | 匯入與匯出 | 匯入:每個 SPEC-OBJECT 都會成為一個項目,並帶有規格階層、以其類型作為類別,以及字串、XHTML、Boolean、日期、列舉、整數與實數屬性。SPEC-RELATION 會成為關係;satisfy、verify 與 deriveReqt 會成為 satisfies、verifies 與 traced from;trace 與 refine 會成為 traced to。從資料庫或文件匯出:每個類別一種類型,包含編號、名稱、描述與每個屬性,關係以 SPEC-RELATION 表示,分解則作為階層。 | 沒有對應的關係類型會成為 traced to;結構描述不允許的關聯會被略過並顯示警告。 |
模型
| 格式 | 方向 | 涵蓋範圍 | 已知限制 |
|---|---|---|---|
| UML 與 SysML 1.x XMI(.xmi、.uml、.xml、.mdzip) | 匯入與匯出 | 匯入:使用 UML 2.5 與 SysML 1.3 至 1.7 設定檔的 XMI 2.x,以及 .mdzip 專案封存檔。包含具 id 與文字的需求、區塊、零件、埠、值屬性、帶單位的值型別、一般化、連接器與項目流、具控制流的活動、具平行狀態以及 choice、junction、fork 與 join 轉移的狀態機、序列圖、測試案例、套件、構造型與標記值。Satisfy、verify、deriveReqt、refine、trace、copy 與 allocate 會成為 Holarch 關係。區塊圖、內部區塊圖、狀態機圖與動作圖會根據匯入的模型繪製。匯出:供 Cameo/MagicDraw、Enterprise Architect 與 Rhapsody 使用的 SysML 1.6 XMI(XMI 2.5.1),或供 Papyrus 使用的 Papyrus(Eclipse UML,.uml),包含需求、區塊、零件、埠、帶單位的值型別、約束區塊、具項目流的連接器、活動、使用案例、測試案例、狀態機與追溯關係。匯入的項目保留其 XMI id,匯出時會寫回,因此匯入同一模型的較新版本時會更新項目,而不是新增副本。開啟 Holarch 屬性與標籤時,檔案可無損地匯回 Holarch。 | 圖的版面配置與操作不會匯入;審查會列出被省略的內容。活動的流程只有在結構良好時才會繪製。Artifacts、Tasks、Risks、Issues、Decisions、Time 與 Cost 項目不會匯出。 |
| Java 原始碼(.java) | 匯入 | 在類別圖上:類別、介面與列舉會成為 Assets,欄位會成為 Characteristics,方法會成為 Actions,其參數與結果則成為 Input/Outputs。 | 一次一個檔案或一段貼上的原始碼。 |
| SysML v2 文字(.sysml,或 .sysml 檔案的 .zip) | 匯入與匯出 | 匯入 SysML v2 專案或新專案,並逐一套件預覽:新增、已變更、未變更或衝突。zip 中的資料夾會成為套件。可匯出整個模型或單一套件;多個套件會以 zip 下載。 | 文字不含元素 id,因此重新匯入時會依名稱比對元素。不匯入 KerML(.kerml)檔案。每次匯入最多 2,000 個檔案、8 MB 文字與 16 MB 的 zip;文字必須為 UTF-8。 |
| SysML v2 JSON(.json) | 匯入與匯出 | Systems Modeling API 所使用、帶有 @id 與 @type 的扁平元素清單。元素 id 會保留,因此重新匯入時會依 id 比對。 | 最多 24 MB 與 100,000 個元素。Holarch 不解讀的元素種類會依匯入時的樣子保留、標示為「未解譯」,並原封不動地寫回。 |
| SysML v2 模型儲存庫 | 拉取與推送 | 將 SysML v2 專案連接到提供 Systems Modeling API 的儲存庫的一個分支。拉取最新的提交,並在套用之前審查每項差異;將您的變更以一次提交推送。 | 僅限公開主機上的 https 位址。分支有尚未拉取的提交時,推送會被拒絕。每次拉取 64 MB、每項操作 120 秒,每個帳戶每小時 300 項操作。需要編輯者角色。 |
| Holarch 中的 Systems Modeling API | 供其他工具讀取與提交 | 其他 SysML v2 工具可使用個人存取權杖,透過 REST 以 SysML v2 JSON 讀取 SysML v2 專案的元素,並將變更提交到變更請求分支。 | main 為唯讀;提交會進入變更請求,由核准者在 Holarch 中套用。僅限分支最新提交;不支援標籤、合併或已儲存的查詢。 |
| SysML v1 轉 SysML v2(.xmi、.uml、.xml、.mdzip) | 匯入 | 來自 Cameo 或 MagicDraw、Enterprise Architect、Rhapsody 或 Papyrus 的 SysML 1.x 模型會轉換為 SysML v2 文字、加以檢查,並以一個復原步驟匯入 SysML v2 專案或新專案。轉換報告會將每個元素列為已轉換、近似處理或省略,並附上原因,可下載為 CSV。 | 圖及其版面配置不會轉換。與未命名元素之間的關係會被省略。 |
| LML 與 SysML v2 互轉 | 雙向轉換的副本 | 以另一種語言建立的新專案:Assets、埠、Conduits、Input/Outputs、需求、satisfy 關聯、測試案例、具流程的 Actions、狀態與方程式。風險、決策、任務、文件、白板、需求狀態與測試結果也會一併帶過去。報告會列出哪些已轉換、哪些未轉換,可下載為 CSV。 | 圖的版面配置、歷程記錄、基準線與變更請求不會轉換。其中一種語言沒有對應位置的元素,例如 LML 的 Measures 與 Resources,或 SysML v2 的計算與分析案例,會列在報告中。 |
與 SysML v2 模型並存的 Holarch 資料,例如需求狀態、風險、預算與檢視版面配置,不屬於 .sysml 或 SysML v2 JSON 檔案的一部分。專案匯出會保留這些資料。
試算表與表格
| 格式 | 方向 | 涵蓋範圍 | 已知限制 |
|---|---|---|---|
| Excel(.xlsx、.xlsm)與 CSV | 匯入 | 任何類別的新項目或更新項目,並依標題列建議欄位對應。屬性、標籤、關係、來自父欄或編號的階層,以及根據資料建立的新屬性。依 ID、名稱或編號比對現有項目以更新它們。 | 不讀取 Excel 97-2003(.xls)與以分號分隔的 CSV。名稱與編號會截斷為 255 個字元。 |
| 從資料庫匯出的 Excel 與 CSV | 匯出 | 任何一組項目,可匯出為含所選屬性與關係的表格(附階層與彙總)、定義、關係矩陣、變更歷程或留言。 | Excel 儲存格最多可容納 32,000 個字元;更長的文字會被截斷。 |
| 其他頁面的 Excel 與 CSV | 匯出 | RVTM、VCRM、RVM、RTM、RSM 與 TVM;需求品質結果;TBD/TBR 登錄表;介面登錄表;N² 與 I² 矩陣;預算與 TPM;風險登錄表;權衡研究;功能分析表;基準線比較;圖表資料;模擬器時間軸、事件記錄與執行結果。 | 每個頁面匯出它自己的欄。 |
| 可追溯性矩陣(.xlsx、.csv) | 匯入與匯出 | 將任何關係匯出為矩陣。在試算表中編輯活頁簿後再匯入回來:預覽會列出要新增的關聯、要移除的關聯,以及略過的儲存格。 | 匯入只會在既有項目之間新增與移除關聯。結構描述不允許的儲存格會被略過並列出。 |
文件與報告
| 格式 | 方向 | 涵蓋範圍 | 已知限制 |
|---|---|---|---|
| Word(.docx) | 匯出 | 使用 Word 標題樣式、機密等級標示、封面與頁碼的文件與大綱;以追蹤修訂呈現基準線之間差異的修訂稿;實體分解;圖報告;ICD;測試案例;RVTM 與可追溯性矩陣;權衡研究摘要;功能分析報告;DoDAF 架構套件。 | 頁面為 US Letter 尺寸。 |
| PowerPoint(.pptx) | 匯出 | 簡報,每頁一張投影片,含文字方塊、圖形與演講者備忘稿。簡報也可匯出為 HTML 與 Word。 | 無。 |
| Markdown(.md) | 匯出 | 以 Markdown 標題與文字呈現的文件。 | 無。 |
| HTML | 匯出 | 圖、圖報告、圖表、簡報與可追溯性矩陣的網頁。 | 無。 |
| 列印與 PDF | 匯出 | 透過瀏覽器的列印對話方塊輸出文件、表格與圖,並可儲存為 PDF。白板可直接匯出 PDF。 | 白板 PDF 的頁面為圖片。 |
圖片
| 格式 | 方向 | 涵蓋範圍 | 已知限制 |
|---|---|---|---|
| PNG 與 SVG | 匯出 | 圖、圖表、投影片、模擬器面板與圖庫卡片。PNG 可選擇縮放比例,並可含或不含背景;SVG 為可縮放的向量圖片。 | 無。 |
| 白板:PNG、JPG、SVG、PDF | 匯出 | 一個畫板、一個選取範圍、目前的檢視、一個框架或所有畫板。SVG 在向量工具中保留可編輯的圖形與文字。 | PDF 頁面為圖片。 |
| 圖片與附加檔案 | 匯入 | RTF 文字中的圖片、實體圖片、檔案屬性、白板與投影片。DoDAF 產品使用的 PNG、JPEG 或 SVG 圖形,例如含熱點的 OV-1。 | 最長邊超過 4,000 px 的圖片會被縮小。檔案大小上限在 Free 方案為 10 MB、Individual 為 25 MB、Team 為 100 MB;Free 方案的專案上限為 100 MB。 |
專案檔案
| 格式 | 方向 | 涵蓋範圍 | 已知限制 |
|---|---|---|---|
| Holarch 備份(.holarch)與專案檔案(.json) | 匯入與匯出 | 整個專案,用於備份或移到另一台 Holarch 伺服器:項目、關係、圖、基準線、留言、歷程記錄與首頁偏好設定,連同附件與圖片。.holarch 備份為每個部分附帶檢查碼,並在匯入前接受檢查。匯入後成為您擁有的新專案。備份與 JSON 格式皆有文件說明。 | 一律建立新專案;若要合併到已開啟的專案,請使用下方的合併匯入。 |
| 合併到專案(.holarch、.json) | 匯入 | Holarch 備份與套件(連同附加檔案),以及 Holarch 專案、資料庫與文件的匯出,合併到已開啟的專案中。類別、屬性、標籤與關係依名稱比對,缺少的結構描述項目可以先新增。選擇時,留言、歷程記錄與圖的版面配置也會一併帶入。 | 來自檔案的模擬指令碼會標示為已匯入,模擬器在執行前會先詢問。 |
| 專案套件(.holarch) | 匯出 | 所選項目及其關係、圖、留言與結構描述,以及所有附加檔案,匯入時會檢查是否損毀。 | 包含所選項目;不包含基準線與歷程記錄。 |
| 結構描述(.json) | 匯入與匯出 | 專案的類別、關係、屬性與標籤。匯入時會合併專案缺少的部分,或取代整個結構描述。 | 無。 |
| 基準線與文件資料(.json) | 匯出;文件資料也可匯入 | 基準線及其日期、文件、核准與快照。文件的項目、關係與狀態,可合併到另一個專案中。 | 無。 |
| DoDAF 產品(JSON)與 DM2 PES 子集(XML) | 匯出 | 架構描述、每個產品及其資料,以及資料字典。XML 以 DoDAF Meta Model 的術語寫出資料字典。 | XML 使用 Holarch 自己的命名空間,未依 DM2 PES 結構描述驗證。 |
| MS Project 排程(.xml) | 匯出 | 模擬執行的甘特列,輸出為 MS Project XML 排程。 | 僅限模擬器執行結果。 |
API 與 MCP
指令碼透過 REST API 讀取與變更專案,使用個人存取權杖與 OpenAPI 描述。AI 工具透過 Model Context Protocol(MCP)連線;它們的變更會以提案形式送達,經您審查後才套用。請參閱 API 與 MCP。