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 出现两次时(例如在文本中复制了一个块之后),第一个元素保留该 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. 打开模型 → 导入和导出。
  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. 勾选包含元素 ID,将包导出为 SysML v2 文本。
  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
状态属性(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:

  1. 在导出下,选择一个包或整个模型,并选择 ReqIF(.reqif)或 ReqIF 压缩包(.reqifz)。
  2. 点击导出。提示消息显示“已将 N 项需求导出为 <file>。”

数据库或需求页面上的导出… → 需求 (ReqIF)会以同样的方式导出列出的(或所选的)需求。

该文件包含每项需求的短名称(作为 ReqIF.ForeignID)、名称、doc(作为 XHTML)、状态和属性值,作为规格说明的包层次结构,以及派生、细化和依赖关系。从 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 行为、步骤或交互。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 不解释的单个元素的 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. 在美国和其他国家/地区的注册商标。