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 出现两次时(例如在文本中复制了一个块之后),第一个元素保留该 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 added, 1 changed (ids kept where elements match)”(添加 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
- 勾选包含元素 ID,将包导出为 SysML v2 文本。
- 编辑文件:重命名元素、将其移到其他所有者或另一个包文件中、调整其顺序。将每个
@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 |
| 状态属性(Draft、Proposed、Approved 等) | 该需求在 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)、状态和属性值,作为规格说明的包层次结构,以及派生、细化和依赖关系。从 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 行为、步骤或交互。Holarch 会保留它们而不是将其省略:
- 每个此类元素都以其 ID、名称、所有者和原始 JSON 保留在模型中,包括其关系(类型化、特化等)及其所拥有的内容。其成员仍以它为所有者。
- 浏览器会显示其原始种类,并带有未解释标签;将指针指向该标签可查看说明。属性面板显示其种类、其在文件中的 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. 在美国和其他国家/地区的注册商标。