Holarch

从 SysML v1 到 SysML v2

无需重画即可将您的 SysML v1 模型迁移到 SysML v2。

将保存为 XMI(.xmi、.xml、.uml)或 .mdzip 项目归档文件的 SysML v1 模型拖放到 SysML v2 项目中。Holarch 将其转换为 SysML v2 文本并检查该文本,在导入任何内容之前,将每个元素列为已转换、近似转换或未包含,并说明原因。

转换器包含在每个方案中,包括 Free。新账户在首次登录时开始 30 天 Individual 试用:每个项目 10,000 个条目,无需银行卡,试用结束后恢复为 Free。已有账户?开始试用。

实证:CubeSat EO-1 模型

结果元素
已转换1,007
近似转换32
未包含3
读取的元素1,042
SysML v2 文本中的问题0

转换后的文本检查无错误、无警告,并且同一个模型每次都会转换为相同的文本。哪些内容被近似转换或未包含

导入 SysML v1 模型

将 SysML v1 模型的 XMI 文件或 .mdzip 项目导入 SysML v2 项目。在创建任何内容之前,转换报告会将每个元素列为已转换、近似转换或未包含并说明原因,并可保存为 CSV 文件。示例为 CubeSat EO-1 模型:1,042 个元素,导入无问题。

在视频页面观看“导入 SysML v1 模型”

转换器为您提供的内容

一个可以在其中工作的 SysML v2 模型,以及一份清晰的待评审清单。

无需重画

块变为 part def,端口、连接器和项流随之迁移,需求保留其 id 和文本,satisfy、verify 和 allocate 关系保持可追溯。

涵盖每个元素的报告

v1 模型的每个元素都会列出其 v1 类型、结果、转换后的 SysML v2 名称,对于任何近似转换或未包含的元素,还会以文字说明原因。可在屏幕上筛选,也可下载为 CSV。

导入前检查

在您输入时检查 SysML v2 编辑器的同一引擎也会检查转换后的文本。您会先看到结果、文本和报告;导入是一个撤销步骤。

v1 模型变化时重新导入

元素的 id 取自 v1 模型的 XMI id。将较新的导出文件导入同一项目时,元素会就地更新(即使它们被重命名或移动),并保留其图布局、评论、链接和历史记录。

一个可以在其中工作的模型

SysML v2 项目的编辑器、视图、需求、验证和其他页面像读取其他模型一样读取转换后的模型。

您的 v1 模型保持不变

Holarch 读取它的导出文件,绝不回写,因此在团队评审 SysML v2 版本期间,v1 模型仍是参考。

工作方式

  1. 拖放文件。在 SysML v2 项目中,单击模型 → 导入和导出,选择导入到此项目或导入到新的 SysML v2 项目,然后拖放 .mdzip、.xmi、.uml 或 .xml 文件。进度卡片显示读取、转换和检查阶段。
  2. 评审报告。从 SysML v1 转换给出数量统计,说明文本检查是否无问题,并列出近似转换和未包含的元素及各自的原因。显示 SysML v2 文本可打开结果;下载报告或 .sysml 文件即可保留它们。
  3. 导入。取消勾选不需要的包,然后导入。一次撤销即可移除整个导入。

分步说明以及各工具的导出设置:文档中的导入 SysML v1 模型,以及用于规划整个项目群迁移的迁移指南。

一个转换后的块

part def Rover {
  @SysMLv1Library::BlockData { isEncapsulated = true; }
  part battery : Battery;
  part computer : Computer;
  attribute 'power budget' : Types::Power = 120 [SI::W];
  connection 'power bus' connect battery.'out' to computer.'in';
  satisfy Requirements::'Power Margin' by battery;
  flow 'power flow' of Types::Charge from battery.'out' to computer.'in';
}

转换器对一个封装块的输出:该块有两个部件、一个以瓦特为单位的值属性、一个在代理端口之间带项流的连接器,以及一个 satisfy 关系。迁移指南展示了整个小模型转换前后的样子。

可读取的内容

  • XMI 2.x 格式的 SysML v1:采用 SysML 1.x 配置文件的 UML 2.5。
  • .xmi:XMI 文件。
  • .xml:以 .xml 扩展名保存的 XMI。
  • .uml:XMI 模型文件。
  • .mdzip:以 XMI 形式包含模型的压缩项目归档文件;Holarch 读取其中的 XMI。
  • 其他项目格式:以自有项目格式保存模型的工具需先将模型导出为 XMI。

每次导入一个文件,最大 64 MB、250,000 个元素、512 层嵌套。

输出的内容

  • SysML v2 文本,导入到已打开的项目或新的 SysML v2 项目中,作为一个撤销步骤。
  • 文本检查,在导入前显示。
  • 转换报告,涵盖每个元素,可在屏幕上筛选,也可下载为 CSV。
  • .sysml 文件,可下载用于评审或用于其他 SysML v2 工具。

该转换基于 OMG SysML 2.0 规范中从 SysML v1 到 SysML v2 的转换。

已转换、近似转换或未包含

v1 模型的每个元素都会得到三种结果之一,因此您确切知道该查看哪里。

已转换

该元素在 SysML v2 中有直接对应项。块变为 part def,接口块变为 port def,需求保留其 id 和文本。

近似转换

该元素以改变后的形式保留。以接口块为类型的完整端口变为端口;经过选择节点的转换变为每条路径一个转换;不属于已映射 SI 单位的单位变为实数,单位写在其文档中。

未包含

SysML v2 中没有对应项,或该元素指向文件中不存在的内容。例如流终止节点、活动分区、用例扩展以及指向未命名元素的关系。

没有 SysML v2 关键字的 SysML v1 属性(例如封装块、完整端口或 refine 关系)会作为来自 SysMLv1Library 包的元数据保留,Holarch 在每个 SysML v2 项目中都会加载该包。您自己的构造型会成为带有标记值的元数据定义,不透明行为、守卫和约束会将其主体保留为文本表示,例如 language "OCL" /* … */。

转换对应关系

主要映射如下。文档列出了全部映射。

SysML v1SysML v2
包package,嵌套方式与 v1 相同
块、参与者part def
值类型、枚举attribute def、enum def;带有已知 SI 单位的值类型会特化 ISQ 量
部件属性、引用属性和值属性part、ref part、attribute,带有多重性和默认值
接口块、代理端口、流属性port def、port、有方向的 item 或 attribute
连接器、绑定连接器、项流connect, bind, flow
活动、动作、控制流和对象流action def、动作、带守卫的后继、参数之间的流
状态机、状态、转换state def、状态、带 accept、守卫和效果的转换
需求、satisfy、verify、derive带 id 和文本的 requirement、satisfy、verify、派生连接
Allocate、refine、traceallocate;带 SysMLv1Library 元数据的 dependency
用例、交互、约束块use case def、带消息的 occurrence def、constraint def
构造型和标记值每个构造型一个 metadata def,连同其标记一起应用

完整示例:CubeSat EO-1 模型

将 CubeSat EO-1 演示导出为 SysML 1.6 XMI 并导入新的 SysML v2 项目:读取 1,042 个元素,1,007 个已转换,32 个近似转换,3 个未包含。SysML v2 文本检查无错误、无警告,新项目打开后包含卫星的结构、功能、需求和追溯关系。所有近似转换和未包含的元素,按原因分列:

元素结果原因
10 个连接器近似转换连接器的一端位于某个部件内部;到达它的路径根据部件类型推算得出。
8 个转换近似转换4 个变化触发器和时间触发器(例如 when Undervoltage)作为文档保留;4 个没有信号的事件(例如 Contact Start)获得了同名的项定义。
6 个项流近似转换同一位置中名称被使用了两次;该流被加上后缀重命名。
5 个值类型近似转换该单位(%、GB、Mbps、mNms、W/m^2)不是 Holarch 映射的 SI 单位;值类型为实数,单位写在其文档中。
2 个控制流近似转换一个无守卫的分支与带守卫的分支并列;它被赋予守卫 true。
1 个终止状态近似转换终止状态变为普通状态。
1 个用例扩展未包含SysML v2 没有用例扩展。
2 个 trace 关系未包含它们指向没有名称的元素,而 SysML v2 文本无法引用这类元素。

EO-1 文件是 Holarch 自己的 SysML 1.6 导出文件,因此只使用了 Holarch 写入的那部分 SysML v1。来自其他工具的模型通常使用该语言的更多内容,数字也会不同:真正有参考价值的是您自己模型的报告,而且在导入任何内容之前就能看到它。Holarch 以多种 SysML v1 工具的 XMI 形式编写的测试模型也能转换为检查无问题的文本,并且同一个模型每次都会转换为相同的文本。

常见问题

转换中会丢失什么?

图及其布局不会转换:请在 SysML v2 项目中为重要的图创建视图。SysML v2 中没有对应项的元素不会包含,例如用例扩展、流终止节点和活动分区;指向未命名元素的关系也不会包含,因为 SysML v2 文本按名称引用元素(请在导出之前为需要追溯的元素命名)。近似转换的元素以改变后的形式保留;它们是含义可能与 v1 模型不同的地方,请先评审它们。报告会列出其中的每一个,并说明原因。

转换后的模型可以直接使用吗?

它检查无问题,SysML v2 项目的每个页面都能使用它,但请将其视为起点。某些两种语言之间的差异值得做出建模决策,而不只是翻译。SysML v2 项目支持的内容及已知差距:SysML v2 语言覆盖范围。

可以转换多大的模型?

一个文件最大 64 MB,最多 250,000 个元素,嵌套最多 512 层,转换后的文本最多 8 MB。较大的模型请逐个包导出。您的方案对每个项目条目数的限制适用于转换后的模型:Free 为 1,000 个,Individual 为 10,000 个,Team 为 50,000 个。参见哪些内容计为条目。对于超过 10,000 个条目的模型,请申请 Team 评估。

我可以继续在 SysML v1 工具中工作吗?

可以。Holarch 读取导出文件,绝不更改 v1 模型。当 v1 模型变化时,再次导出并将新文件导入同一项目:元素的 id 取自 XMI 文件,因此会就地更新,重命名或移动后也是如此。同一位置中同名的元素会加上后缀(例如 _2)重命名,报告会列出每次重命名。

我的文件会去哪里?

Holarch 在您的浏览器中读取并转换 XMI 或 .mdzip 文件;文件本身不会上传。在 app.holarch.app 上,转换后的 SysML v2 文本会发送给 Holarch 以准备预览,并且只有在您导入时才会保存到您的项目中。托管服务不接受 CUI 或出口管制材料;对于此类内容,Holarch 可在您自己的环境中运行(Enterprise)。详见安全。

保存在需求管理工具中的需求怎么办?

它们以 ReqIF(.reqif、.reqifz)传递;ReqIF 是标准的需求交换格式。Holarch 在 LML 和 SysML v2 项目中导入和导出 ReqIF。在 SysML v2 项目中,ReqIF 文件会成为需求、需求定义和包,并附带转换内容的报告,需求导出时保留其原始标识符。在我们对 CubeSat EO-1 演示进行的从 Holarch 到 ReqIF 再返回的往返测试中,全部 407 个条目和 979 个属性值均原样返回。LML 项目中的 ReqIF · SysML v2 项目中的 ReqIF

转换器的费用是多少?

无需额外付费:它包含在每个方案中,包括 Free。各方案的区别在于每个项目的条目数以及建模之外包含的内容;参见价格。

要在您自己的工具中构建迁移功能?

该转换器是 Holarch Language Engine 的一部分;该引擎是 Holarch 的 SysML v2 项目背后的引擎,并作为迁移附加组件授权给工具供应商和集成商。它与 Holarch 中运行的是同一个转换器。

  • 您的产品读取 XMI 文件,引擎负责转换:以文档所述的中立形式将 v1 模型作为 JSON 发送,即可以 JSON 形式取回 SysML v2 文本、引擎对其的检查结果,以及涵盖每个元素的报告(包含稳定的原因代码和转换后的 SysML v2 名称)。
  • 在您的产品运行的地方运行:在浏览器中作为 Web Worker 中的 WebAssembly 运行,或通过 Node.js 或带服务器端使用的 Python 扩展在您的服务器上运行。
  • 可重复且有边界:同一个模型每次都会转换为相同的文本;支持最多 250,000 个元素的模型,更大的模型会得到错误响应,绝不会挂起。
  • 由您的许可令牌开启,无需重新构建,也无需更改代码。免费的 60 天评估在您自己的计算机上运行,附带文档和示例。

一个请求及其响应

// Request (the model shortened)
{ "op": "v1_convert",
  "model": { "format": "holarch-xmi-model", … } }

// Answer (shortened)
{ "text": "package 'Rover Model' { … }",
  "diagnostics": [],
  "report": {
    "summary": { "elements": 31, "converted": 27,
                 "approximated": 2, "dropped": 2 },
    "items": [ { "kind": "Association",
                 "status": "dropped",
                 "reason": "association" }, … ] } }

参见引擎 API 参考中的 v1_convert 请求。该引擎还以附加组件形式提供仿真和服务器端使用。

在 SysML v2 中查看您自己的模型。

转换模型,阅读报告,满意后再导入。

新账户在首次登录时开始 30 天 Individual 试用:每个项目 10,000 个条目,无需银行卡,试用结束后恢复为 Free。已有账户?请在“账户设置 → 方案与账单”中开始试用。