Holarch

SysML v2

导入 SysML v1 模型

将来自 Cameo、MagicDraw、Enterprise Architect、Rhapsody 或 Papyrus 的 SysML 1.x 模型转换为 SysML v2 文本,检查哪些内容改变了形式,并将其导入 SysML v2 项目。

使用方法 →

本页内容
  1. 概述
  2. 概念
    1. 已转换、已近似和已省略
    2. SysMLv1Library 包
    3. 不透明主体变为文本表示
  3. 如何使用
    1. 何时使用及原因
    2. 将 SysML v1 模型导入项目
    3. 导入同一模型的较新版本
    4. 保留报告和文本
    5. 从 SysML v1 工具导出模型
  4. 实例:CubeSat EO-1 模型
  5. 提示和常见错误
  6. 转换的内容
  7. 限制
  8. 消息
  9. 相关页面

概述

您可以将 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 模型导入项目

  1. 打开一个 SysML v2 项目,然后点击模型 → 导入和导出。
  2. 在导入下,选择导入到此项目或导入到新的 SysML v2 项目。
  3. 将 .xmi、.uml、.xml 或 .mdzip 文件拖放到框中,或点击该框进行选择。您会看到一张进度卡片,依次显示正在读取 XMI 文件…、正在转换为 SysML v2…和正在检查结果…这几个阶段。
  4. 阅读预览顶部的从 SysML v1 转换。它说明已转换、已近似和已省略的元素数量,以及 SysML v2 文本检查是否没有问题。
  5. 使用显示列出已近似和已省略的元素、其中一类或所有元素。每行给出元素、其 SysML v1 种类、带有 SysML v2 关键字和限定名的结果,以及原因。
  6. 打开显示 SysML v2 文本,在导入前阅读结果。
  7. 在下方的表中清除不需要的包,然后点击导入 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 导出可作为一个贴近实际的测试模型。

  1. 打开 CubeSat EO-1 演示,并以 OMG XMI 2.5.1 格式将其导出为 UML/SysML XMI(请参阅导出 UML/SysML 模型(XMI))。
  2. 打开一个 SysML v2 项目,点击模型 → 导入和导出,选择导入到新的 SysML v2 项目,然后拖放 .xmi 文件。报告显示:1,042 个元素,1,007 个已转换,32 个已近似,3 个已省略。SysML v2 文本检查没有问题。
  3. 将显示设为已省略。这三行是一个用例扩展(SysML v2 中没有)以及两个指向无名称元素的追溯关系(SysML v2 文本无法引用它们)。
  4. 点击创建项目。新的 SysML v2 项目会在编辑器中打开,其中包含卫星的结构、功能、需求和追溯。

提示和常见错误

  • 每次导入一个 XMI 文件,不要带其他文件。每次导入一个 SysML v1 XMI 文件,不要带其他文件。
  • 为追溯目标元素命名。指向未命名元素的关系会被省略,因为 SysML v2 文本按名称引用元素。
  • 重新导入,而不是重新创建。将较新的导出导入到同一项目而不是新项目中:元素只在拥有它们的项目内保留其 ID。
  • 先检查近似项。这些地方的含义可能与 v1 模型不同,例如由块类型化的端口或部件内部的连接器端。
  • 同一位置中同名的元素会被加上后缀(例如 _2)重命名。报告会列出每次重命名。
  • 保存在需求工具中的需求(DOORS、Polarion、Jama、codebeamer)以 ReqIF 而不是 XMI 的形式传入。在同一页面上导入 .reqif 文件:它会变为 SysML v2 需求,并附有同类报告(导入和导出 ReqIF 需求)。

转换的内容

SysML v1SysML 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® 和 OMG® 是 Object Management Group, Inc. 在美国和其他国家/地区的注册商标。