Holarch
コースのチャプター

トレーニング · トラック 4. ドキュメントと成果物 · チャプター 4.4(全 5 チャプター)

4.4 レビューパッケージとベースライン 2:35

レビュー対象を固定し、その後の変更を確認し、レビュー担当者に 1 つのパッケージを渡します。

Holarch 2.41 の画面です。

学習内容

  • 承認記録付きでドキュメントのベースラインを保存する
  • ベースラインを現在のバージョンと比較し、変更をエクスポートする
  • 「レビューを依頼」でドキュメントのレビューを依頼する
  • 複数のドキュメントからレビューパッケージを作成し、1 つの Word ファイルとしてエクスポートする

Bike-Share Dock のシステム要求レビューの準備をします。仕様書を承認付きでベースライン化し、要求を変更してベースラインに対する変更レポートを読み、仕様書とシステムズエンジニアリング管理計画書をまとめたレビューパッケージを作成します。

プロジェクトファイル

  • 開始時のプロジェクト (.holarch.json。プロジェクトを管理 → プロジェクトファイル ▾ → プロジェクトをインポート (.json)…)
  • 完成したプロジェクト (.holarch.json。プロジェクトを管理 → プロジェクトファイル ▾ → プロジェクトをインポート (.json)…)

動画は holarch.app から再生されます。プライバシーポリシーをご覧ください。

演習

CubeSat EO-1 デモプロジェクトを使って、Holarch で実際に操作します。

  1. EO-1 デモプロジェクトを開くか、作成します:プロジェクトを管理 → プロジェクトファイル ▾ → 新しいデモプロジェクト → CubeSat(ガイド付きシステムズエンジニアリング)。この課題では「ドキュメントテンプレート」のチャプターで作成した EO-1 Interface Control Document も使います。そのチャプターを飛ばした場合は、先に作成してください。
  2. EO-1 System Requirements Specification を開き、ドキュメントの種類の横にあるレビューを依頼をクリックし、誰にもチェックを入れずにレビューを依頼をクリックします。タイトルの下のストリップにレビューが表示されます。
  3. バージョン ▾ → ベースラインを保存…をクリックし、名前を PDR Baseline にして自分のロールを入力し、+ 承認者を追加をクリックして 2 人目の承認者を追加し、作成をクリックします。
  4. 2.4 Target Slew を 45 秒に変更します。次に、バージョン ▾ → 版を比較…を選び、元を PDR Baseline、先を現在のバージョンにして、変更(Excel)をクリックします。
  5. 管理とレビュー → レビューを開き、+ 新しいレビューパッケージをクリックして名前を PDR review package にします。書く ▾ → 挿入 ▸ ドキュメント…を 2 回選び、SRS と ICD を追加します。
  6. 納品 ▾ → 納品物の設定…を選び、SRS パートの各パートのエクスポート元を PDR Baseline に設定してから、納品 ▾ → 仕様書(Word)を選びます。

変更レポートに 2.4 の編集が表示され、パッケージの Word ファイルにパート A とパート B があり、SRS パートが PDR Baseline からのものであれば完了です。

確認問題

  1. ドキュメントのベースラインには何が保持され、後から変更できますか?
  2. ドキュメントのベースラインとプロジェクトのベースラインはどう違いますか?
  3. パッケージでは、今日の編集ではなくベースライン化された SRS をエクスポートする必要があります。どうしますか?
  4. 「レビューを依頼」をクリックすると、レビューはどうなりますか?
解答を表示
  1. ドキュメントのベースラインには何が保持され、後から変更できますか?

    ドキュメントの読み取り専用のスナップショットです。その項目、属性と関係、関係 1 つ先の項目が含まれます。名前の変更や承認の追加はできますが、既存の承認記録は編集できません。

  2. ドキュメントのベースラインとプロジェクトのベースラインはどう違いますか?

    ドキュメントのベースラインは 1 つのドキュメントを保持し、そのドキュメントのバージョン ▾ から保存します。プロジェクトのベースラインはプロジェクト内のすべての項目を保持し、管理とレビュー → ベースラインとバージョンの + ベースラインを保存… で保存します。

  3. パッケージでは、今日の編集ではなくベースライン化された SRS をエクスポートする必要があります。どうしますか?

    パッケージで、納品物の設定… の「各パートのエクスポート元」をそのベースラインに設定します。固定されたパートには 📌 とベースライン名が表示され、ベースラインの内容がエクスポートされます。

  4. 「レビューを依頼」をクリックすると、レビューはどうなりますか?

    ドキュメントはレビュー中になります。プロジェクトのレビュー担当者、または指定した人のマイワークの「レビュー対象のドキュメント」に表示され、そこかタイトルの下のストリップで承認または却下します。

関連資料

トランスクリプト

トランスクリプトを表示 (ナレーションと画面の内容)

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.