Holarch
课程章节

培训 · 课程 4. 文档和交付物 · 第 4.4 章,共 5 章

4.4 评审包和基线 2:35

冻结评审内容,查看此后的更改,并向评审者提供一个评审包。

演示 Holarch 2.41。

您将学到

  • 保存带审批记录的文档基线
  • 将基线与当前版本比较并导出更改
  • 通过“请求评审”请求文档评审
  • 用多个文档构建评审包,并将其导出为一个 Word 文件

为 Bike-Share Dock 的系统需求评审做好准备:将规格说明连同其审批纳入基线,更改一条需求并查看相对于基线的更改报告,然后构建一个合并规格说明和系统工程管理计划的评审包。

项目文件

  • 起始项目 (.holarch.json;管理项目 → 项目文件 ▾ → 导入项目 (.json)…)
  • 完成项目 (.holarch.json;管理项目 → 项目文件 ▾ → 导入项目 (.json)…)

视频从 holarch.app 播放;参见隐私政策。

练习

在 Holarch 中基于 CubeSat EO-1 演示项目亲自完成此操作。

  1. 打开您的 EO-1 演示项目,或创建它:管理项目 → 项目文件 ▾ → 新建演示项目 → CubeSat(引导式系统工程)。此任务还会用到“文档模板”一章中的 EO-1 Interface Control Document;如果您跳过了该章,请先创建它。
  2. 打开 EO-1 System Requirements Specification,单击文档类型旁边的 请求评审,不勾选任何人,然后单击 请求评审。标题下方的条带显示该评审。
  3. 单击 版本 ▾ → 保存基线…,将其命名为 PDR Baseline,填写您的角色,单击 + 添加审批人 添加第二位审批人,然后单击 创建。
  4. 将 2.4 Target Slew 改为 45 秒。然后选择 版本 ▾ → 比较版本…,从 为 PDR Baseline,至 为 当前版本,然后单击 更改 (Excel)。
  5. 打开 控制与评审 → 评审,单击 + 新建评审包,将其命名为 PDR review package。选择两次 编写 ▾ → 插入 ▸ 文档…,添加 SRS 和 ICD。
  6. 选择 交付 ▾ → 交付物设置…,将 SRS 部分的 每个部分的导出来源 设为 PDR Baseline,然后选择 交付 ▾ → 规格说明 (Word)。

当更改报告列出 2.4 的编辑,且评审包的 Word 文件包含 Part A 和 Part B、其中 SRS 部分来自 PDR Baseline 时,即完成练习。

自测

  1. 文档基线包含什么?以后还能更改吗?
  2. 文档基线与项目基线有何不同?
  3. 您的评审包应导出纳入基线的 SRS,而不是今天的编辑。如何做到?
  4. 单击“请求评审”后,评审会怎样?
显示答案
  1. 文档基线包含什么?以后还能更改吗?

    文档的只读快照:其条目、条目的属性和关系,以及相隔一个关系的条目。您可以重命名基线并添加审批,但现有审批记录不能编辑。

  2. 文档基线与项目基线有何不同?

    文档基线只包含一个文档,从该文档的 版本 ▾ 保存。项目基线包含项目中的每个条目,在 控制与评审 → 基线和版本 中通过 + 保存基线… 保存。

  3. 您的评审包应导出纳入基线的 SRS,而不是今天的编辑。如何做到?

    在评审包的 交付物设置… 中,将“每个部分的导出来源”设为该基线。固定的部分会显示 📌 和基线名称,并导出基线的内容。

  4. 单击“请求评审”后,评审会怎样?

    文档变为 In Review 状态。项目的评审者或您指定的人会在“我的工作”的“待评审的文档”下收到它,并可在那里或标题下方的条带中批准或拒绝。

延伸阅读

文字稿

显示文字稿 (旁白和屏幕内容)

Introduction

Chapter four: review packages and baselines. Before a review, you freeze what is being reviewed, and you hand the reviewers one package.

You will baseline a document with its approval, see what changed since the baseline, and build a review package from several documents.

Baseline a document

Open the system requirements. In the version menu at the top of the document, choose Save Baseline.

On screen: Documents → the SRS → Version ▾ → Save Baseline….

Name it SRR Baseline, for the system requirements review. The approval is filled in with your name. Add the role, Lead Systems Engineer. Approval records are dated now and cannot be edited later. Click Create.

On screen: Name, approval role → Create.

The version menu now lists it. A baseline is a read-only snapshot of the document: its items, their attributes and their relationships.

On screen: Version ▾: the baseline.

What changed since

Now a change arrives: the footprint grows shorter. In the outline, open section 10, and change requirement 10.1 to two by eleven meters.

On screen: Outline → 10.1 → edit its description.

Open the version menu, and choose SRR Baseline. Holarch shows the document as it was, read-only, with its approval. Click Compare to Current.

On screen: Version ▾ → SRR Baseline → Compare to Current.

The change report lists every item that changed since the baseline, with the field and the change marked. Reviewers can see exactly what moved, and the report exports to Excel.

On screen: Baseline Change Report.

Build a review package

Now the review package. Open Plan and Deliver, then Review Packages, and click New Review Package. Name it SRR Review Package, and click Create.

On screen: Plan & Deliver → Review Packages → + New Review Package.

A review package is a document that holds other documents. In Write, choose Insert, then Document, and pick the system requirements.

On screen: Write ▾ → Insert → Document… → the SRS.

Insert the systems engineering management plan the same way. Each document keeps its own sections, below it.

On screen: Write ▾ → Insert → Document… → the SEMP.

The package has its own page setup, so it can carry a cover page of its own. From Deliver, choose a Word template, and the whole package becomes one file for the review board.

On screen: Deliver ▾ → Specification (Word).

Recap

Let's recap. You baselined a document with its approval, read what changed since the baseline, and built a review package from two documents.

Next, you present the model to the review board with slides that stay up to date.