Holarch

培训 · 课程 1. 入门

课程 1. 入门:练习单

面向所有初次使用 Holarch 的用户。每章一项练习任务和几个问题,供您在观看每个视频后完成。可从浏览器打印此页面,也可在屏幕上作答。答案从末尾的新页开始。

开始之前

先修课程
无:使用免费账户从这里开始。
方案
Free
项目
第 1.1 章介绍 CubeSat EO-1 演示项目;其他各章从起始文件开始构建一个 Bike-Share Dock。

1.1 Holarch 工作区

观看第 1.1 章 (5:34)

练习

基于 CubeSat EO-1 演示项目:

  1. 创建 EO-1 演示项目:管理项目 → 项目文件 ▾ → 新建演示项目 → CubeSat(引导式系统工程)。
  2. 在 主页 上阅读 需要处理 卡片,然后单击侧栏中的 验证,并从其概览页面打开 测试中心。
  3. 单击侧栏底部的 数据库,单击 + 筛选 并选择类 Test Case。选择 TC-04 Pointing Accuracy Test,在属性面板中查看其 追溯:它验证哪条需求。
  4. 双击 TC-04 行,在 条目视图 中打开它,然后按 ⌘K / Ctrl+K,输入 battery,并在 1.3.2 Battery Pack 上按 Enter。在两个编辑器标签页之间切换。
  5. 单击顶栏中的“需要处理”标志,打开 失败的测试 条目。在该页面上,单击顶栏中的 ? 并阅读帮助面板。
  6. 如需带检查的分步演练,请运行教程 1“快速上手”(帮助 → 教程)。

当 TC-04 和 1.3.2 Battery Pack 在各自的编辑器标签页中打开,且您能说出 TC-04 验证的需求时,即完成练习。

常见问题

  1. 您在数据库中更改了一条需求的描述。系统需求规格说明是否仍显示旧文本?
  2. 什么情况下应使用 ⌘K / Ctrl+K 而不是侧栏?
  3. 为什么没有“保存”按钮?

1.2 您的第一个项目

观看第 1.2 章 (5:43)

练习

基于 CubeSat EO-1 演示项目:

  1. 打开您的 EO-1 演示项目(或创建它:管理项目 → 项目文件 ▾ → 新建演示项目 → CubeSat(引导式系统工程))。
  2. 单击侧栏底部的 数据库,然后单击 + 新建条目。选择类 Statement,将其命名为 Field Boundary Overlays,编号为 N4,描述该需要(农艺师希望在每张植被图上绘制田块边界),然后单击 创建。
  3. 再创建一个 Statement:Rideshare Mass Limit,编号 C1,说明航天器不得超过分配器的质量限制。在属性面板中单击 + 标签 并选择 Constraint。
  4. 创建一个 Requirement:Field Boundary Layer,编号 6.6,以 shall 语句编写,并确认其 Status 为 Draft。然后创建一个 Action:Overlay Field Boundaries,编号 F12。
  5. 在表格中双击 N4 的描述,修改一个词并按 Enter。按 ⌘Z / Ctrl+Z 撤销,按 ⇧⌘Z / Ctrl+Shift+Z 重做。
  6. 单击 + 筛选 并选择类 Statement,同时查看需要和约束。

当 Statement 筛选列出 N1 到 N4 以及 C1、C1 带有 Constraint 标签,且 6.6 Field Boundary Layer 显示状态 Draft 时,即完成练习。

常见问题

  1. 为什么创建条目时类很重要?
  2. 一位利益相关方说,操作员必须能够在家中规划过境。这是 Statement 还是 Requirement?
  3. 既然类已经说明了条目是什么,标签有什么用?

1.3 属性和关系

观看第 1.3 章 (3:29)

练习

基于 CubeSat EO-1 演示项目:

  1. 打开您的 EO-1 演示项目(或创建它:管理项目 → 项目文件 ▾ → 新建演示项目 → CubeSat(引导式系统工程))。
  2. 在 数据库 中选择 2.5 Safe Mode Recovery,并在属性面板中输入 理由(航天器为何必须自行退出安全模式)。
  3. 选择 F10 Enter Safe Mode。在 追溯 中找到 satisfies(如果未列出,请勾选 显示所有关系),单击 + → 关联现有…,勾选 2.5 Safe Mode Recovery,然后单击 关联所选。选择 2.5,在 satisfied by 下找到同一条关联。
  4. 选择 1.4 C&DH,勾选 显示所有关系,并通过 performs 将其关联到 OPS.9 Hold Data Onboard,这是唯一一个尚无部件执行的运行步骤。
  5. 选择 2.2 Mission Operations Center。在 decomposed by 上单击 + → 新建 Asset…,然后创建 Image Processing Server。
  6. 双击 F10 Enter Safe Mode 打开 条目视图,然后依次单击相关名称:从 F10 到 1.4 C&DH,再从那里到 1 EO-1 Spacecraft。

当 2.5 Safe Mode Recovery 的条目视图在 satisfied by 下列出 F10,且 OPS.9 在 performed by 下列出 1.4 C&DH 时,即完成练习。

常见问题

  1. 您从 F10 通过 satisfies 添加了一条关联。为什么 2.5 无需额外步骤就显示 satisfied by?
  2. 为什么“关联现有…”中的选择器不提供项目中的每个条目?
  3. 用 performs 将资产关联到动作,在系统工程中记录的是什么?

1.4 您的第一张图

观看第 1.4 章 (4:00)

练习

基于 CubeSat EO-1 演示项目:

  1. 打开您的 EO-1 演示项目(或创建它:管理项目 → 项目文件 ▾ → 新建演示项目 → CubeSat(引导式系统工程))。
  2. 单击侧栏底部的 图,然后单击 + 新建图。选择 Asset 图,在 图的对象 中输入 EPS,选择 1.3 EPS,然后单击 创建。打开 执行的 Action,查看每个部件执行哪个功能。
  3. 选择 + Asset ▾ → 新建子 Asset…,创建 Battery Heater。单击图工具栏中的 ⋯(更多操作),然后单击 + Conduit:从 Battery Pack 到 Battery Heater,命名为 Heater Power Line。然后选择 排列 ▾ → 整理布局。
  4. 打开 数据库,找到作为新行出现的 Battery Heater 和 Heater Power Line。
  5. 回到图的标签页,使用类型选择器将类型切换为 层次结构图。
  6. 创建 3.2 Battery Capacity 的 Spider 图,层级保持为 2。

当 3.2 的 Spider 图显示满足它的 Battery Pack 和验证它的 TC-07 Battery Capacity Test 时,即完成练习。

常见问题

  1. 您没有删除任何内容,只是在图上重命名了一个部件。新名称还会出现在哪里?
  2. 为什么新建的 1.3 EPS 的 Asset 图已经显示了三个部件?
  3. 什么情况下 Spider 图比 Asset 图更有用?

1.5 文档

观看第 1.5 章 (2:46)

练习

基于 CubeSat EO-1 演示项目:

  1. 打开您的 EO-1 演示项目(或创建它:管理项目 → 项目文件 ▾ → 新建演示项目 → CubeSat(引导式系统工程))。
  2. 打开 需要与需求 → 文档,单击 + 新建文档。将其命名为 EO-1 Ground Station Specification,选择模板 Requirements Specification,然后单击 创建。
  3. 选择章节 4.1 Primary Functions,单击 + 子条目,将需求命名为 Track the Spacecraft,并在属性面板的描述中编写其 shall 语句。
  4. 在底部的 快速添加 中选择 Under 10 Design Constraints,输入 The ground station antenna shall have a diameter of no more than 3.7 m. 并按 Enter。用同样方式再添加一条约束。
  5. 打开 数据库,在搜索框中输入 in:"EO-1 Ground Station Specification" class:Requirement,列出新需求。
  6. 回到文档,选择 交付 ▾ → 规格说明 (Word) 并打开文件。

当 Word 文件在各编号章节下显示您的三条需求时,即完成练习。

常见问题

  1. 在 Holarch 文档中输入的需求与在文字处理软件中输入的需求有什么区别?
  2. “快速添加”如何确定新需求的名称?
  3. 什么情况下应勾选“包括编写指南”?

1.6 查找内容

观看第 1.6 章 (2:37)

练习

基于 CubeSat EO-1 演示项目:

  1. 打开您的 EO-1 演示项目(或创建它:管理项目 → 项目文件 ▾ → 新建演示项目 → CubeSat(引导式系统工程))。
  2. 在 数据库 的搜索框中输入 downlink,查看结果来自哪些类。清除搜索。
  3. 单击 + 筛选,选择类 Requirement,然后在 需求属性 下选择 Status、= 是、In Review,并单击 添加筛选条件。
  4. 在 视图 窗格中单击 保存视图…,将其命名为 Awaiting decision,勾选 与项目共享,然后单击 保存。
  5. 按 ⌘K / Ctrl+K 并输入 TC-09 打开 Safe Mode Entry Test;再次按 ⌘K / Ctrl+K,输入 rvtm 并打开 RVTM 页面;然后输入 new test,不创建任何内容直接按 Esc。
  6. 在 条目视图 中打开 3.1 Orbit Average Power,单击 历史记录…。查看哪些字段发生了更改以及更改人。

当 Awaiting decision 带共享标记出现在“视图”窗格中,且只列出 In Review 状态的需求时,即完成练习。

常见问题

  1. 一位同事每周都会询问哪些需求仍在评审中。向其提供该列表的最快方法是什么?
  2. “无关系”筛选会找到什么?为什么它有用?
  3. 未勾选“与项目共享”而保存的视图,谁能看到?

1.7 共享和角色

观看第 1.7 章 (2:24)

练习

基于 CubeSat EO-1 演示项目:

  1. 打开您的 EO-1 演示项目(或创建它:管理项目 → 项目文件 ▾ → 新建演示项目 → CubeSat(引导式系统工程))。您还需要一个可以收信的第二个电子邮件地址。
  2. 单击顶栏右侧的 共享。在 邀请成员 下输入第二个地址,选择 评审者,然后单击 邀请。确认它列在 待处理的邀请 下,然后关闭对话框。
  3. 在 SRS 中选择 6.4 Operator Interface。在属性面板的 讨论 部分写一个问题,询问该需求应规定哪个可测量的值,然后单击 添加评论。
  4. 在属性面板的 工作流 组中,将 负责人 设为您自己,并将 截止日期 设为下周。打开 计划 → 我的工作,在 分配给我的 下找到该需求。
  5. 在浏览器的隐私窗口中用第二个地址接受邀请。以评审者身份打开 6.4,确认您可以回复评论,但不能编辑文本。

当 6.4 Operator Interface 带着截止日期出现在您的“我的工作”中,且评审者的回复显示在其“讨论”中时,即完成练习。

常见问题

  1. 一位利益相关方需要批准需求,但不应更改它们。您应为其分配哪个角色?
  2. 为什么添加评审者和查看者不会占用方案的协作者名额?
  3. 关于某一条需求的问题应放在哪里:电子邮件还是条目的“讨论”?

1.8 导出、导入和版本

观看第 1.8 章 (2:31)

练习

基于 CubeSat EO-1 演示项目:

  1. 打开您的 EO-1 演示项目(或创建它:管理项目 → 项目文件 ▾ → 新建演示项目 → CubeSat(引导式系统工程))。
  2. 在 数据库 中双击 6.3 Telemetry Archive 的描述,使其更精确,然后按 Enter。继续工作一两分钟,以便保存一个新的自动版本。
  3. 打开 控制与评审 → 基线和版本,单击页面标题栏中的 恢复以前的版本…。选择一个编辑之前的版本,查看它为 6.3 列出的更改,然后单击 取消。
  4. 在 管理项目 中打开该项目所在行的菜单 ⋯,选择 导出此项目…,然后单击 导出 JSON。
  5. 选择 项目文件 ▾ → 导入项目 (.json)… 并选择该文件。打开新项目,确认 SRS 及其图都在其中。
  6. 在副本的 数据库 中筛选类 Test Case,单击 导出…,选择 表格 (Excel),然后单击 导出。完成后删除副本:它会占用您的一个项目名额。

当您得到项目 JSON 文件和测试用例的 Excel 文件,并在恢复预览中看到 6.3 的更改时,即完成练习。

常见问题

  1. 自动版本与基线有什么区别?
  2. 您误恢复了一个版本。能回到原来的状态吗?
  3. 导入项目文件会覆盖其来源项目吗?

答案

1.1 Holarch 工作区

  1. 不会。每个条目只有一份;文档、数据库、图和属性面板都显示同一个条目,因此编辑会出现在所有地方。
  2. 当您知道所需内容的名称或编号时。⌘K / Ctrl+K 按名称查找条目、页面、文档、图和命令;侧栏用于按生命周期阶段浏览。
  3. Holarch 在您每次更改时立即保存,并在顶栏中显示保存状态。每次更改都是一个撤销步骤,因此 ⌘Z / Ctrl+Z 可以将其撤回。

1.2 您的第一个项目

  1. 类决定了条目可以拥有哪些属性和关系。Holarch 只提供对该条目有意义的关联:资产可以执行动作,风险则不能。
  2. Statement:它是以利益相关方的语言表达的需要。将其形式化的需求稍后编写,并追溯回它。
  3. 标签将同一类的条目划分为不同种类,例如带 Constraint 标签的 Statement,这样无需新建类就能按种类筛选和报告。

1.3 属性和关系

  1. 每种关系在每个方向上都有一个名称。它是同一条关联,从功能读作 satisfies,从需求读作 satisfied by。
  2. 它只列出该关系对此条目允许的类的条目,因此您无法创建架构未定义的关联。
  3. 将功能分配给执行它的物理部件。

1.4 您的第一张图

  1. 出现在该条目出现的所有地方:数据库、文档、其他图和属性面板。图是模型的视图,而不是单独的绘图。
  2. 该图读取模型中已有的 decomposed by 关系,因此无需手动放置就能绘制出各部件。
  3. 当您想查看某个条目周围跨关系类型的追溯时:需要、功能、部件和测试,例如用于判断变更的影响。

1.5 文档

  1. 在 Holarch 中,文档中的每条需求都是一个模型条目:您可以追溯它、检查其质量、在图上绘制它,并在数据库中找到它。
  2. 它根据 shall 之后的词语为需求命名,并按所选章节中同级条目的顺序为其编号。
  3. 当作者初次接触该文档类型时:每个章节会附带一条简短说明,指出应包含的内容,您在编写时将其删除。

1.6 查找内容

  1. 将查询保存为视图并勾选“与项目共享”。项目中的每个人都会在“视图”窗格中看到它,并且它始终反映当前模型。
  2. 完全没有关联的条目,例如没有任何内容追溯到的需要,或没有任何内容满足的需求。它们是模型中的遗漏之处。
  3. 只有您自己,且仅限于此浏览器。它保存在浏览器中,并在您于该浏览器中打开的每个项目中提供。

1.7 共享和角色

  1. 评审者。评审者可以阅读、评论,以及批准、拒绝或重新打开需求,但不能编辑模型。
  2. 只有所有者和编辑者计入名额限制;评审者和查看者不计入。
  3. 条目的“讨论”。评论会与需求保存在一起,提及会通知对方,并在其“我的工作”中等待处理。

1.8 导出、导入和版本

  1. 自动版本在您编辑时大约每分钟保存一次,仅按所有者方案规定的天数保留。基线是您在里程碑时创建的命名快照,会一直保留。
  2. 可以。恢复前的状态会先保存为一个版本,并且恢复操作是一个撤销步骤。
  3. 不会。导入会成为一个具有新标识的新项目,您是其所有者。

由 Holarch发布