SysML v2
SysML v2 语言覆盖范围
Holarch 的 SysML v2 项目基于 OMG SysML v2 规范,支持该语言的一个子集。本页列出文本表示法的每个领域、Holarch 的支持程度以及已知差距。
各级别的含义
- 已支持:编辑器解析并检查该构造,模型保留它,使用它的视图和页面可以读取和写入它。
- 部分支持:已支持,但有该行所列的限制。
- 保留,不解释:按原样解析和保留(在文本和导出中均如此),但不赋予其自身的含义。
- 尚未支持:不可用。
编辑器、视图和检查运行的是同一个语言引擎,因此编辑器接受的构造在每个视图中都是相同的。另请参见 Holarch Language Engine。
语言构造
| 领域 | 级别 | 构造 | 限制 |
|---|---|---|---|
| 包和命名空间 | 已支持 | package、嵌套包、library package、doc、comment … about、注释 // 和 //* */、alias … for …、public、private 和 protected、简称 <'1.2'>、带引号的名称。 | 库包(包括标准库)为只读。 |
| 导入 | 已支持 | 成员导入和命名空间导入、::*、递归 ::**、带可见性的导入、筛选导入 [@Kind]。 | 导入筛选器按元类选择。 |
| 定义和用法 | 已支持 | part、attribute、item、port、connection、interface、flow、action、state、requirement、constraint、calc、use case、analysis、verification、view、viewpoint、concern、enum、occurrence、allocation、metadata;ref、abstract、in、out、inout 和 end。 | 暂无已知限制。 |
| 特化、类型化和重定义 | 已支持 | 特化 :> 和 specializes、类型化 : 和 defined by、子集 :> 和 subsets、重定义 :>> 和 redefines、共轭 ~、disjoint、特征链 a.b.c。 | 暂无已知限制。 |
| 多重性 | 已支持 | [n]、[n..m]、[*]、[0..*]、ordered、nonunique、以表达式作为边界。 | 暂无已知限制。 |
| 值和单位 | 已支持 | =、:=、default、量(例如 5 [kg])、单位表达式(例如 [m/s^2])、标准库中的 ISQ 量种类以及 SI 和美制单位、量纲检查。 | 暂无已知限制。 |
| 约束和计算 | 已支持 | 约束和计算的定义与用法、return、assert constraint、调用、包含算术、比较、逻辑、if ? else 和序列操作的 KerML 表达式、带单位的求值。 | 暂无已知限制。 |
| 结构 | 已支持 | 端口和共轭端口、connect、带端的接口、带多重性的命名连接端(connect [1] driver ::> a to [1] driven ::> b)、绑定连接器 bind、项流 flow of T from … to …、message。 | 暂无已知限制。端口、流和 message 的方向会被检查。互连视图会以多重性标注命名端,属性面板可以编辑它们。 |
| 动作 | 部分支持 | 参数、perform、后继 first … then … 和 then、fork、join、decide、merge、守卫、accept、send、assign、if、while、for、loop、start、done、terminate。 | 仿真器运行动作流(包括蒙特卡罗运行),使用模型中的持续时间、分支概率和循环次数。 |
| 状态 | 部分支持 | entry、do 和 exit 动作、带触发器、守卫和效果的转换(可在状态转换视图和属性面板中编辑,并显示在浏览器中该转换的下方)、parallel 状态、嵌套状态、exhibit。 | 仿真器使用 SysML 引擎运行状态机,支持激励,并在运行时高亮显示活动状态。每种 do 效果都会被检查,触发器的负载会对照其端口进行检查,模型的其他部分可以引用转换的触发器和效果(plugIn.effect.sentMessage)。 |
| 需求 | 已支持 | subject、actor、stakeholder、require constraint、assume constraint、frame concern、satisfy … by …、verify、以简称作为需求 id、以 doc 作为需求文本。 | 暂无已知限制。 |
| 用例 | 已支持 | 用例定义和用法、subject、actor、objective、include use case。 | 暂无已知限制。 |
| 分析用例和验证用例 | 部分支持 | 带有主体、目标和 return 结果的分析用例;带有 verify 和判定结果的验证用例。 | 分析用例仅在每个输入都有值时才会求值。标准库中的权衡研究分析不会求值;Holarch 的权衡研究页面改为使用模型中的值为备选方案打分。 |
| 视图 | 部分支持 | view、view def、带 ::*、::** 和筛选器的 expose、filter、viewpoint、frame、render、标准视图定义。 | 序列视图绘制生命线之间的消息,并将 if/else、循环、分叉和判断中的消息绘制为带守卫的 alt、opt、loop 和 par 片段。 |
| 分配和依赖 | 已支持 | allocate a to b、分配定义、dependency from … to …。 | 暂无已知限制。 |
| 元数据 | 部分支持 | @Name { … }、#Name 前缀、metadata Name about …、用户定义的 metadata def、Holarch 用于 TBD 和 TBR 值以及 DoDAF 和 UAF 概念的元数据包、用户定义的关键字(#safetyCritical part controller)、语义元数据(#fault def BatteryOverheat;),以及具有自身含义的元数据:每次使用时都会检查必需值、声明类型的值和定义的约束。 | 元数据定义的约束读取的是它自己的值,而不是被注解的元素。使用 about 编写的元数据不会添加基类型。 |
| 可变性 | 已支持 | variation 定义和用法、variant 成员和变体引用(variant plugInHybrid;)、按值选择(part :>> pack = BatteryPack::largePack;)、标记为 @HolarchConfiguration 的配置。会进行检查和求值:变体拥有其变化点的特征,选择必须是该变化点的变体之一,没有选择的变化点值未知,因此针对它的断言既不满足也不违反。 | 配置在文本中编写;Holarch 的页面目前尚不能搜索有效组合。 |
| 个体和时间片 | 已支持 | individual 定义和用法(individual part def Car_VIN1234 :> Car)、snapshot 和 timeslice(也可在 then 之后)及其值和后继。会进行检查和求值:快照或时间片拥有其所属事件的特征,并优先读取其自身的值。属性面板中的事件字段、浏览器中的 Individuals 筛选器和新建快照…/新建时间片…,以及带有 «individual»、«snapshot» 和 «timeslice» 的一般视图和排列为时间线。 | 只有事件才能是个体、快照或时间片。 |
| 文本表示 | 部分支持 | rep language "…" /* … */;SysML 和 KerML 主体会作为代码进行检查和高亮显示,SysML 约束主体会被求值。属性面板可以添加和编辑表示,动作流视图会用其语言标记带有表示的动作,例如 {Python}。 | 其他语言(例如 Python、OCL 或 MATLAB)的主体作为文本保留,永远不会运行。主体不能包含 */。 |
| KerML | 部分支持 | 标准库的 KerML 文本:内核库以 KerML 读取。文本表示的 KerML 主体会被检查。 | .kerml 文件不会导入到项目中,以 KerML 编写的模型不会被检查。 |
| 语言扩展 | 部分支持 | 来自语义元数据的用户定义关键字:#fault def BatteryOverheat; 会特化元数据的基类型,因此拥有基类型的特征;可限制其注解对象的元数据(annotatedElement)。 | 基类型按名称读取(faults meta SysML::Usage)。该语言的其他扩展不可用,标准库不能编辑。 |
文件与交换
| 格式 | 级别 | 涵盖内容 | 限制 |
|---|---|---|---|
| SysML v2 文本(.sysml) | 已支持 | 导入和导出,也支持文件的 .zip 包,导入应用前会显示预览。 | 导出时勾选包含元素 ID 即可保留元素 id;不保留时,重新导入会按名称匹配元素。 |
| SysML v2 JSON | 部分支持 | 导入和导出 Systems Modeling API 的元素格式,并保留元素 id。 | Holarch 不解释的元素种类按导入时的样子保留,导出时原样写回;它们没有文本,也不能编辑。 |
| SysML v1 模型(XMI、.mdzip) | 部分支持 | 从 Cameo 或 MagicDraw(.mdzip 或 XMI)、Enterprise Architect、Rhapsody 和 Papyrus(XMI、.uml、.xml)导入 SysML v2 项目。模型会转换为 SysML v2 文本并被检查,转换报告将每个元素列为已转换、近似转换或未包含并说明原因,也可导出为 CSV。导入是一个撤销步骤。 | 仅限导入。没有 SysML v2 对应项的元素(例如流终止节点、活动分区、用例扩展和实例规格)不会包含;图及其布局不会转换。一个文件最大 64 MB、250,000 个元素;不读取 Enterprise Architect 项目文件(.eap、.qea)。 |
| 模型仓库 | 已支持 | 从提供 Systems Modeling API 的仓库的一个分支拉取和推送。 | 每个项目一个分支。 |
| Holarch 中的 Systems Modeling API | 部分支持 | 其他 SysML v2 工具读取项目的当前模型,并提交到变更请求分支。 | main 为只读:提交会进入变更请求,由审批人在 Holarch 中应用。 |
| KerML 文件(.kerml) | 尚未支持 | 不导入;导入时会跳过它们。 | 请使用 .sysml 文件。 |
大小限制及其他所有格式列在导入与导出中。
检查
编辑器在您输入时检查文本,并在原处标记每个问题。检查涵盖:
- 语法:字符、注释、字符串、括号、
;、预期的名称和标记。 - 名称:未解析、有歧义、重复和私有的名称。
- 类型化和特化:循环、定义种类是否正确、继承特征的子集和重定义。
- 多重性和单位:有效边界、量纲匹配、缺失或未知的单位。
- 表达式:操作数类型、计算参数和布尔条件。
- 结构、动作和状态:连接端,端口、流和
message的方向,后继目标,控制节点,for循环遍历的值,初始转换,并行区域,转换触发器(经过端口的负载、at时间)以及do效果(包括send的去向)。 - 用户定义关键字:
#Name引用元数据,元数据只标记其允许的种类,语义基类型是适合其所标记元素的定义或用法。 - 元数据值:每次使用元数据定义都提供其必需值,每个值都符合其特征的类型,且定义的约束成立。
- 可变性:变化点只拥有其种类的变体,选择是其变化点的变体,并会注明配置中未选择的变化点。
- 需求、用例和视图:成员位置正确,
satisfy、verify、expose和frame的目标。 - 文本表示:SysML 和 KerML 主体可解析并声明其所表示的元素;Holarch 不认识的语言会被注明。
- 求值:对当前值不成立的约束、需求和目标。
每项检查及示例消息:检查。
已知差距
- 没有分析用例求解器。分析用例在每个输入都有值时求值。在参数视图中,求解功能为每个约束求出一个未知量。
- 页面中没有变体搜索。变化点、变体和配置会被检查和求值;Holarch 的页面尚不能列出所有有效组合。
- 不支持 KerML 文件。KerML 仅用于读取标准库。
- 语言扩展仅限于用户定义关键字和元数据。语义元数据应用其基类型;其他元数据的含义由其定义规定(必需值、值类型和约束),标准库为只读。
- SysML 和 KerML 以外语言的文本表示作为文本保留;Holarch 永远不会运行它们。
- Systems Modeling API:不支持向 main 提交、标签或合并。其他工具提交到变更请求分支;审批人在 Holarch 中应用它们。
Holarch 实现了本页所列的规范子集。新功能列出了对它的每项更改。