SysML v2
导入 SysML v1 模型
将来自 Cameo、MagicDraw、Enterprise Architect、Rhapsody 或 Papyrus 的 SysML 1.x 模型转换为 SysML v2 文本,检查哪些内容改变了形式,并将其导入 SysML v2 项目。
本页内容
概述
您可以将 SysML 1.x 模型带入 SysML v2 项目。Holarch 会读取模型的 XMI 文件,将其转换为 SysML v2 文本,检查文本,并在进行任何更改之前显示转换报告。
- 输入:XMI 格式(
.xmi、.uml、.xml)的 SysML 1.x 模型,或 Cameo 或 MagicDraw 项目(.mdzip)。 - 输出:项目中的 SysML v2 文本(一次撤销即可全部撤回),或一个新的 SysML v2 项目。
- 报告:每个 v1 元素及其结果:已转换、已近似或已省略,以及原因。
在以 XMI 交换的模型带有足够细节的情况下,转换遵循 OMG SysML 2.0 规范中从 SysML v1 到 SysML v2 的变换。
概念
已转换、已近似和已省略
v1 模型中的每个元素都会得到一个结果:
- 已转换:该元素在 SysML v2 中有直接对应项,例如块变为
part def。 - 已近似:元素以改变后的形式保留。例如,由接口块类型化的完整端口会变为一个端口,而经过选择伪状态的转换会变为每条路径一个转换。
- 已省略:SysML v2 中没有对应项,或者该元素指向文件中不存在的内容。例如流终止节点、活动分区、用例扩展和实例规格。
报告会用文字说明每个已近似和已省略元素的原因。
SysMLv1Library 包
某些 SysML v1 属性没有对应的 SysML v2 关键字,例如块的 isEncapsulated 或 refine 关系。转换器将它们保留为来自 SysMLv1Library 包的元数据,例如 @SysMLv1Library::RefineData { isRefine = true; }。该包是 Holarch 库的一部分,因此这些名称在每个 SysML v2 项目中都能解析。
不透明主体变为文本表示
不透明行为、不透明动作、守卫和约束规格包含用 OCL 或英语等语言编写的文本。转换器将每个主体保留为文本表示:language "OCL" /* … */。用 SysML 或 KerML 编写的主体会像其余文本一样被检查。请参阅文本表示。
如何使用
何时使用及原因
当团队要将现有的 SysML 1.x 模型迁移到 SysML v2,或想重用其中的部分内容时,请使用此导入。转换后的文本是一个起点:报告会告诉您哪些内容需要手动评审。
将 SysML v1 模型导入项目
- 打开一个 SysML v2 项目,然后点击模型 → 导入和导出。
- 在导入下,选择导入到此项目或导入到新的 SysML v2 项目。
- 将
.xmi、.uml、.xml或.mdzip文件拖放到框中,或点击该框进行选择。您会看到一张进度卡片,依次显示正在读取 XMI 文件…、正在转换为 SysML v2…和正在检查结果…这几个阶段。 - 阅读预览顶部的从 SysML v1 转换。它说明已转换、已近似和已省略的元素数量,以及 SysML v2 文本检查是否没有问题。
- 使用显示列出已近似和已省略的元素、其中一类或所有元素。每行给出元素、其 SysML v1 种类、带有 SysML v2 关键字和限定名的结果,以及原因。
- 打开显示 SysML v2 文本,在导入前阅读结果。
- 在下方的表中清除不需要的包,然后点击导入 N 个包(或创建项目)。模型会被导入,一次撤销即可全部撤回。撤销会再次将其移除。
导入同一模型的较新版本
当 SysML v1 模型发生变化时,请再次导出它,并将新文件导入到同一项目中(导入到此项目)。每个转换后的元素都从该元素在 XMI 文件中的 ID(xmi:id)获取其 ID,因此导入会就地更新元素:在 SysML v1 工具中被重命名或移到另一个包的元素仍是同一个元素,保留其图布局、评论、关联和历史记录。报告会说明有多少元素从 SysML v1 模型获取了 ID。没有名称的元素(连接器、后继关系)按其在模型中的位置进行匹配。
在 Holarch 开始从 XMI 文件派生 ID 之前从 SysML v1 模型导入的项目会保留其 ID:较新的导出按名称更新其元素,SysML v1 模型中新增的元素从中获取 ID。
保留报告和文本
- 点击下载报告可获得一个 CSV 文件,其中包含每个元素、其结果、其 SysML v2 路径和原因。
- 点击下载 SysML v2 文本可获得转换后的
.sysml文件。
从 SysML v1 工具导出模型
- Cameo Systems Modeler 和 MagicDraw:直接导入
.mdzip项目,或使用 File → Export To → Eclipse UML2 (v5.x) XMI File,然后导入.xmi文件。 - Enterprise Architect:选择包,选择 Publish → Export XML,选择 XMI 2.1,然后导入
.xml文件。无法直接读取 Enterprise Architect 项目文件(.eap、.qea)。 - IBM Rhapsody:使用 XMI 工具包(XMI 2.x)导出模型,然后导入该文件。
- Eclipse Papyrus:导入模型的
.uml文件。
实例:CubeSat EO-1 模型
CubeSat EO-1 演示是一个 LML 项目。它的 SysML v1 导出可作为一个贴近实际的测试模型。
- 打开 CubeSat EO-1 演示,并以 OMG XMI 2.5.1 格式将其导出为 UML/SysML XMI(请参阅导出 UML/SysML 模型(XMI))。
- 打开一个 SysML v2 项目,点击模型 → 导入和导出,选择导入到新的 SysML v2 项目,然后拖放
.xmi文件。报告显示:1,042 个元素,1,007 个已转换,32 个已近似,3 个已省略。SysML v2 文本检查没有问题。 - 将显示设为已省略。这三行是一个用例扩展(SysML v2 中没有)以及两个指向无名称元素的追溯关系(SysML v2 文本无法引用它们)。
- 点击创建项目。新的 SysML v2 项目会在编辑器中打开,其中包含卫星的结构、功能、需求和追溯。
提示和常见错误
- 每次导入一个 XMI 文件,不要带其他文件。每次导入一个 SysML v1 XMI 文件,不要带其他文件。
- 为追溯目标元素命名。指向未命名元素的关系会被省略,因为 SysML v2 文本按名称引用元素。
- 重新导入,而不是重新创建。将较新的导出导入到同一项目而不是新项目中:元素只在拥有它们的项目内保留其 ID。
- 先检查近似项。这些地方的含义可能与 v1 模型不同,例如由块类型化的端口或部件内部的连接器端。
- 同一位置中同名的元素会被加上后缀(例如
_2)重命名。报告会列出每次重命名。 - 保存在需求工具中的需求(DOORS、Polarion、Jama、codebeamer)以 ReqIF 而不是 XMI 的形式传入。在同一页面上导入
.reqif文件:它会变为 SysML v2 需求,并附有同类报告(导入和导出 ReqIF 需求)。
转换的内容
| SysML v1 | SysML v2 |
|---|---|
| 模型、包 | package |
| 块、参与者 | part def |
| 值类型、数据类型、枚举 | attribute def、enum def(具有已知 SI 单位的值类型会特化 ISQ 量) |
| 信号 | item def |
| 接口块 | port def |
| 部件属性、引用属性和值属性 | part、ref part、attribute,带有多重性和默认值 |
| 代理端口、流属性 | port、in/out item 或 attribute |
| 完整端口 | 带 @SysMLv1Library::PortData 的 part |
| 连接器、绑定连接器、项流 | connect, bind, flow |
| 泛化 | :> |
| 活动、调用行为动作、引脚 | action def、action、参数 |
| 控制流和对象流、守卫 | 带 if 守卫和 else 的后继关系,参数之间的流 |
| 初始、终止、决策、合并、分叉、汇合 | start, done, decide, merge, fork, join |
| 状态机、状态、区域 | state def、state、并行状态 |
| 转换、信号触发器和时间触发器 | 带 accept、accept after、守卫和效果的 transition |
| 交互 | 带生命线和消息的 occurrence def |
| 用例、主体、包含 | use case def, subject, include |
| 需求(ID 和文本) | requirement <'id'> Name { doc /* text */ } |
| 满足、验证、派生需求 | satisfy、验证目标中的 verify、派生连接 |
| 细化、追溯 | 带 SysMLv1Library 元数据的 dependency |
| 分配、依赖 | allocate, dependency |
| 约束块、约束 | constraint def, assert constraint |
| 构造型和标记值 | 每个构造型一个 metadata def,连同其标记一起应用 |
| 注释、文档说明 | doc, comment |
限制
- 一个最大 64 MB 的文件。
- 最多 250,000 个元素,嵌套最多 512 层。嵌套更深或存在所有权循环的模型不会被导入。
- 在转换后的模型中,嵌套超过 128 层的元素会被省略,原因为嵌套。
- 转换后的文本最大 8 MB。
- 图及其布局不会被转换。请在 SysML v2 项目中创建视图。
消息
| 留言 | 应采取的行动 |
|---|---|
| 每次导入一个 SysML v1 XMI 文件,不要带其他文件。 | 单独导入 XMI 文件。 |
| <file> 不包含 UML 或 SysML 元素。请将模型导出为 XMI 2.x,然后再次导入。 | 将模型重新导出为 XMI 2.x。 |
| 在 <file> 中未找到 UML 模型。在 Cameo 或 MagicDraw 中,将模型导出为 Eclipse UML2 XMI,然后导入 .xmi 文件。 | 将项目导出为 XMI。 |
| 该 SysML v1 模型有超过 250,000 个元素。请导出模型中较小的部分。 | 每次导出一个包。 |
| 转换后的 SysML v2 文本将大于 8 MB。请导出模型中较小的部分。 | 每次导出一个包。 |
相关页面
- 交换 SysML v2 模型
- 导入和导出 ReqIF 需求:来自 DOORS、Polarion 和其他需求工具的需求。
- SysML v2 文本表示法
- 在 LML 和 SysML v2 之间转换
SysML® 和 OMG® 是 Object Management Group, Inc. 在美国和其他国家/地区的注册商标。