Holarch

培训 · 课程 6. 迁移到 Holarch

课程 6. 迁移到 Holarch:练习单

面向从其他工具迁移过来的团队。每章一项练习任务和几个问题,供您在观看每个视频后完成。可从浏览器打印此页面,也可在屏幕上作答。答案从末尾的新页开始。

开始之前

先修课程
课程 1. 入门,第 1.1 至 1.3 章。
方案
Free
项目
您自己的需求文件,或从 EO-1 演示项目导出用于练习的文件。

6.1 规划迁移

观看第 6.1 章 (3:00)

练习

基于 CubeSat EO-1 演示项目:

  1. 打开您的 EO-1 演示项目(如果没有,请创建:管理项目 → 项目文件 ▾ → 新建演示项目 → CubeSat(引导式系统工程))。
  2. 在侧栏中打开 设置 → 架构,单击 类 下的 Requirement,列出需求电子表格可以填写的属性(例如 Priority、Owner、Verification Method)。
  3. 打开架构的 标签 页面,找到 Performance Requirement 等种类保存在何处。
  4. 假设供应商的跟踪表中有一列 Supplier Ref 没有对应的位置:在 Requirement 上单击 + 属性,将其命名为 Supplier Ref,选择文本类型,然后单击 添加属性。
  5. 打开 需要与需求 → 导入和导出,了解拖放区接受哪些格式,以及 导出 卡片提供哪些功能。

当 Supplier Ref 位于 Requirement 属性列表的最后,且您能说出典型跟踪表中每一列应放在哪里时,即完成练习。

常见问题

  1. 为什么要在导入之前确定每种数据的去向?
  2. 某一列没有匹配的属性。您有哪些选择?
  3. 一次导入出了问题。如何撤回?
  4. 什么情况下应使用 管理项目 → 导入项目 (.json)… 而不是“导入”页面?

6.2 从 Excel 和 CSV 导入需求

观看第 6.2 章 (2:32)

练习

基于 CubeSat EO-1 演示项目:

  1. 打开您的 EO-1 演示项目(如果没有,请创建:管理项目 → 项目文件 ▾ → 新建演示项目 → CubeSat(引导式系统工程))。在 数据库 中搜索 class:Requirement,单击 导出…,选择 表格 (CSV),勾选 Status 和 Priority(保持 标签 为勾选状态),然后单击 导出。
  2. 在电子表格应用中打开该文件。保留标题行以及第 1 和第 2 章节的行,然后在顶部添加两行:1、Mission Imaging、Class 为 Statement,以及 2、Attitude Determination and Control、Class 为 Statement。将其另存为 .xlsx 或 .csv。
  3. 在 管理项目 中单击 + 新建项目,将其命名为 EO-1 Import Practice,然后单击 创建项目。
  4. 打开 需要与需求 → 导入和导出,拖入文件,单击 继续,并检查每一列的 Holarch 字段(将不需要的列设为 跳过)。
  5. 单击 继续,保持勾选 根据这 N 个条目创建文档,然后单击 导入 N 个条目。
  6. 在新文档中,确认 1.6.1 和 1.6.2 位于 1.6 之下,并选择 1.5 查看其标签和状态。

当新文档显示第 1 和第 2 章节、其需求按编号嵌套,且标签和状态完好无损时,即完成练习。

常见问题

  1. Holarch 如何重建电子表格各行的层级?
  2. 有些行导入后的类不正确。为什么?
  3. 您想通过电子表格更新 50 条现有需求的负责人,而不是创建副本。如何操作?

6.3 从 Word 和 ReqIF 导入需求

观看第 6.3 章 (2:22)

练习

基于 CubeSat EO-1 演示项目:

  1. 打开您的 EO-1 演示项目(如果没有,请创建:管理项目 → 项目文件 ▾ → 新建演示项目 → CubeSat(引导式系统工程))。打开 文档 → EO-1 System Requirements Specification,然后单击 交付 ▾ → 规格说明 (Word)。
  2. 在同一文档中单击 交付 ▾ → 需求 (ReqIF)…,然后单击 导出。
  3. 在 管理项目 中单击 + 新建项目,将其命名为 EO-1 Import Practice,然后单击 创建项目。打开 需要与需求 → 导入和导出,拖入 .docx 文件,单击两次 继续,然后导入。
  4. 将新文档与 SRS 比较:留意哪些标题变成了 Statement、哪些 shall 句子变成了 Requirement,以及它们是如何命名的。
  5. 将 .reqif 文件导入同一项目,然后打开它创建的文档,选择 1.6 Revisit Time 查看其子项和标签。

当项目包含两个文档(一个来自 Word,一个来自 ReqIF),且您能说出哪个保留了原始名称和编号时,即完成练习。

常见问题

  1. Word 导入将什么读取为章节,将什么读取为需求?
  2. 供应商可以发送 Word 或 ReqIF。为什么要索取 ReqIF?
  3. 某个 ReqIF 关系的名称 Holarch 无法识别。会发生什么?

6.4 其他工具的模型

观看第 6.4 章 (2:44)

练习

基于 CubeSat EO-1 演示项目:

  1. 打开您的 EO-1 演示项目(如果没有,请创建:管理项目 → 项目文件 ▾ → 新建演示项目 → CubeSat(引导式系统工程))。打开 需要与需求 → 导入和导出,在“导出”卡片上单击 导出 UML/SysML (XMI)…,将 格式 保持为 OMG XMI 2.5.1 (.xmi),然后单击 导出。该文件相当于从 Cameo 或 Enterprise Architect 等 SysML 工具导出的文件。
  2. 在 管理项目 中单击 + 新建项目,将其命名为 EO-1 Import Practice,然后单击 创建项目。打开 需要与需求 → 导入和导出,拖入 .xmi 文件,确认 格式 显示为 UML/SysML (.xmi, .uml, .mdzip),单击 继续 两次,阅读 审阅,然后单击 导入 N 个条目。
  3. 在 数据库 中搜索 class:Asset,选择 Payload Camera,并在 追溯 中确认它属于 EO-1 Spacecraft,以及它执行哪些 Action。
  4. 打开 图,单击 + 新建图,选择 Asset 图,在 图的对象 中选择 EO-1 Spacecraft,然后单击 创建。
  5. 打开 执行的 Action,列出各子系统的功能。

当新项目的 Asset 图显示航天器的各子系统及其执行的 Action 时,即完成练习。

常见问题

  1. Holarch 可以导入 SysML v1 工具的哪些文件,如何获得这些文件?
  2. 为什么导入后可以快速重建图?
  3. 您导入同一模型的较新导出文件。为什么不会产生副本?

6.5 导入后的清理

观看第 6.5 章 (2:40)

练习

基于 CubeSat EO-1 演示项目:

  1. 打开您在前几章中创建的 EO-1 Import Practice 项目(或按第 2 章的方法导入 EO-1 需求的 CSV)。
  2. 打开 需要与需求 → 质量,在范围栏中选择一个导入的文档,然后单击 检查质量。
  3. 如果您两次导入了相同的需求(Word 和 ReqIF),请在 数据库 中勾选重复项所在的行,并使用批量操作栏中的 删除条目… 将其删除。改写 2.5 Safe Mode Recovery 使其可测量,然后再次检查质量。
  4. 打开 验证 → 模型检查,打开规则 Requirement.8“没有设计实体满足的叶需求”。
  5. 如果您也导入了资产(第 4 章),请选择 2.1 Pointing Accuracy,在 追溯 中通过 + → 关联现有… 添加到 ADCS 的 satisfied by。再次运行模型检查。

当 2.5 的得分高于之前,且 Requirement.8 不再列出 2.1 时,即完成练习。

常见问题

  1. 质量检查看的是什么?模型检查看的又是什么?
  2. 为什么自动质量评分永远不会超过 78%?
  3. 为什么要在迁移后立即连接需求和部件?

答案

6.1 规划迁移

  1. 落入正确的类、标签、属性和关系中的数据,可以立即用于追溯、质量检查和报告。导入后再修正则意味着要手动编辑许多条目。
  2. 在导入之前于 设置 → 架构 中添加该属性,或在映射步骤中将该列映射到“新属性(已添加到架构)”。
  3. 按一次 ⌘Z / Ctrl+Z:从“导入”页面进行的导入是一个撤销步骤。
  4. 用于将整个项目恢复为一个新的独立项目。“导入”页面会将文件中的条目合并到当前打开的项目中。

6.2 从 Excel 和 CSV 导入需求

  1. 如果映射了父行 ID 或父级编号列,则依据该列,否则依据大纲编号:1.2 位于 1 之下。如果缺少父项,则使用最近的现有祖先。
  2. 如果 Class 列中的名称架构无法识别,则会回退到“无类的行所用的类”,并给出警告。请使用架构编辑器中的类名。
  3. 连同 ID 列一起导出,编辑文件,然后导入,将 ID 列映射到全局 ID,并将“匹配现有条目的依据”设为全局 ID。审查步骤随后会将它们列在“已更新的条目”下。

6.3 从 Word 和 ReqIF 导入需求

  1. 使用 Word 标题样式的段落会变成 Statement(章节)。包含 shall、must、will 或 should 的段落会变成 Requirement,并以动词之后的前几个词命名。以普通粗体文字输入的标题会被当作普通文本读取。
  2. ReqIF 包含每条需求的标识符、层级、属性和关系。当供应商发送更新的文件时,导入它会更新相同的条目,而不是添加副本。
  3. 它以 traced to 的形式导入。如果架构不允许这两个类之间存在 traced to,则跳过该关系并给出警告。

6.4 其他工具的模型

  1. 带 SysML 1.x 配置文件的 XMI 2.x(来自 Cameo/MagicDraw、Enterprise Architect、Rhapsody 或 Papyrus,需从工具中导出)、Cameo 或 MagicDraw 的 .mdzip 项目(可直接导入)以及 Papyrus 的 .uml 文件。仅需求也可以通过 ReqIF 导入,表格可以通过 Excel 或 CSV 导入。
  2. 其他工具中的图布局不会导入,但关系会导入。Holarch 根据这些关系绘制 Asset 图、层级图和其他图。
  3. 每个导入的条目都保留其 XMI ID,对于 XMI 文件,“匹配现有实体的依据”默认为 XMI ID,因此之后的导入会更新这些条目。已存在的关系不会重复添加。

6.5 导入后的清理

  1. 质量检查根据良好需求的各项品质为每条需求的措辞评分。模型检查在整个模型中查找缺口,例如没有任何内容满足的需求、孤立的条目或无人执行的动作。
  2. Correct 和 Feasible 需要人工判断,因此检查永远不会将其标为已满足。您在审查需求后自行标记。
  3. 它们来自不同的文件,彼此之间没有关联。从此以后,每条 satisfied by 关联都会为可追溯性、覆盖率和模型检查提供依据。

由 Holarch发布