导入和导出的工作方式
- 导出对所有项目成员开放,包括查看者。导入需要所有者或编辑者角色,因为导入会更改项目。
- 从“导入与导出”页面进行的导入会显示预览,为导入的条目分配新 ID,并作为一个撤销步骤。若要更新现有条目而不是添加新条目,可按 ID、名称或编号进行匹配。
- 导入的内容会经过清理:富文本中的脚本和不安全链接会被移除,SVG 图片中的脚本和外部引用会被移除,含有 DOCTYPE 或 ENTITY 声明的 XML 会被拒绝。
- CSV 导出会中和电子表格可能作为公式执行的文本。文件名会针对所有操作系统进行清理。
- 每个项目要么是 LML 项目,要么是 SysML v2 项目。Word、电子表格、文本和 ReqIF 导入适用于 LML 项目。SysML v2 项目可导入 SysML v2 文本和 JSON,以及 XMI 或 .mdzip 格式的 SysML 1.x 模型(转换为 SysML v2)。LML 项目也可导入 XMI。项目文件以及共享页面的 Word、Excel 和 CSV 导出在两类项目中均可使用。
跳转到:需求和规范 · 模型 · 电子表格和表格 · 文档和报告 · 图片 · 项目文件 · API 和 MCP
需求和规范
| 格式 | 方向 | 涵盖内容 | 已知限制 |
|---|---|---|---|
| Word(.docx) | 导入 | 规范会成为一个带编号的文档。标题按层级嵌套成为 Statement;含有“shall”“must”“will”或“should”的段落以及编号列表项成为 Requirement。表格每行成为一个条目,或作为表格保留在描述中。粗体、斜体、列表和图片会保留,插入的修订会被读取,原始文件会作为附件附上。 | 除 PNG、JPEG、GIF、WebP 和 SVG 以外的 EMF、WMF 等格式图片会被跳过。已删除的修订文本不会导入。 |
| 纯文本(.txt 或粘贴) | 导入 | 带编号的行和“shall”句子会成为由 Statement 和 Requirement 组成的带编号文档。大纲编号可自动检测或手动选择:十进制、罗马数字、字母、混合层级、DoD 样式或自定义模式。 | 结构仅来自编号和措辞。 |
| ReqIF(.reqif、.reqifz) | 导入与导出 | 导入:每个 SPEC-OBJECT 成为一个条目,带有规范层级、作为类的类型,以及字符串、XHTML、布尔、日期、枚举、整数和实数属性。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 profile 的 XMI 2.x,以及 .mdzip 项目归档。包括带 ID 和文本的需求、block、part、port、value property、带单位的 value type、泛化、connector 和 item flow、带控制流的 activity、含并行状态以及 choice、junction、fork 和 join 转换的状态机、序列图、测试用例、package、构造型和标记值。Satisfy、verify、deriveReqt、refine、trace、copy 和 allocate 成为 Holarch 关系。Block 图、内部 block 图、状态机图和 Action 图根据导入的模型绘制。导出:面向 Cameo/MagicDraw、Enterprise Architect 和 Rhapsody 的 SysML 1.6 XMI(XMI 2.5.1),或面向 Papyrus 的 Papyrus 格式(Eclipse UML,.uml),包含需求、block、part、port、带单位的 value type、constraint block、带 item flow 的 connector、activity、用例、测试用例、状态机和追溯关系。导入的条目保留其 XMI ID,导出时会写回这些 ID,因此导入同一模型的后续版本时会更新条目,而不是添加副本。启用 Holarch 属性和标签后,该文件可无损导入回 Holarch。 | 图布局和 operation 不会导入;审查列表会列出省略的内容。仅当 activity 的流程结构良好时才会绘制。Artifact、任务、风险、问题、决策、时间和成本条目不会导出。 |
| Java 源代码(.java) | 导入 | 在类图上:类、接口和枚举成为 Asset,字段成为 Characteristic,方法成为 Action,其参数和结果成为 Input/Output。 | 每次一个文件或一段粘贴的源代码。 |
| SysML v2 文本(.sysml,或包含 .sysml 文件的 .zip) | 导入与导出 | 导入到 SysML v2 项目或新项目中,按 package 显示预览:新增、已更改、未更改或冲突。zip 中的文件夹成为 package。可导出整个模型或一个 package;多个 package 以 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 及转回 | 双向转换副本 | 以另一种语言新建的项目:Asset、端口、Conduit、Input/Output、需求、satisfy 关联、测试用例、带流程的 Action、状态和方程。风险、决策、任务、文档、白板、需求状态和测试结果也会一并带过去。报告列出已转换和未转换的内容,可下载为 CSV。 | 图布局、历史、基线和变更请求不会转换。一种语言中没有对应位置的元素(例如 LML 的 Measure 和 Resource,或 SysML v2 的 calculation 和 analysis case)会在报告中列出。 |
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 页面为图片。 |
| 图片和附件 | 导入 | 富文本中的图片、实体图像、文件属性、白板和幻灯片。用于 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 元模型术语写出词典。 | XML 使用 Holarch 自己的命名空间,未依据 DM2 PES 架构进行验证。 |
| MS Project 进度计划(.xml) | 导出 | 仿真运行的甘特图行,导出为 MS Project XML 进度计划。 | 仅来自仿真器运行。 |
API 和 MCP
脚本可使用个人访问令牌和 OpenAPI 描述,通过 REST API 读取和更改项目。AI 应用等 AI 工具通过 Model Context Protocol(MCP)连接;它们的更改以提议的形式到达,由您审查后才会应用。见 API 和 MCP。