コースのチャプター
トレーニング · トラック 2. 要求と検証 · チャプター 2.4(全 6 チャプター)
2.4 ベースラインと要確認リンク 2:40
仕様書をベースラインで固定し、要求を変更して、その変更が影響するものを確認します。
Holarch 2.13 の画面です。
学習内容
- 承認記録付きでドキュメントのベースラインを保存する
- 承認済みの要求を変更すると、そのステータスとリンクに何が起こるかを説明する
- フラグが付いたリンクを差分で確認し、メモを付けてレビュー済みにする
- ベースラインを現在のバージョンと比較し、変更をエクスポートする
Bike-Share Dock の仕様書を承認付きのベースラインで固定し、承認済みの要求を変更して、それがレビューに戻りリンクが要確認になることを確認し、リンクを確認してメモ付きでレビュー済みにし、ベースライン以降のすべての変更を一覧表示します。
プロジェクトファイル
- 開始時のプロジェクト (.holarch.json。プロジェクトを管理 → プロジェクトファイル ▾ → プロジェクトをインポート (.json)…)
- 完成したプロジェクト (.holarch.json。プロジェクトを管理 → プロジェクトファイル ▾ → プロジェクトをインポート (.json)…)
動画は holarch.app から再生されます。プライバシーポリシーをご覧ください。
演習
CubeSat EO-1 デモプロジェクトを使って、Holarch で実際に操作します。
- EO-1 デモプロジェクトを開きます(または作成します:プロジェクトを管理 → プロジェクトファイル ▾ → 新しいデモプロジェクト → CubeSat(ガイド付きシステムズエンジニアリング))。
- EO-1 System Requirements Specification を開き、表題欄のバージョン ▾をクリックしてベースラインを保存…を選びます。名前を
PDR Baselineにし、承認者の行を 1 つ自分の名前とロールで埋めて、作成をクリックします。 - 3.3 Depth of Discharge の説明で 30% を 25% に変更し、トーストを読みます。要求は In Review に戻り、そのリンクは要確認になります。
- ニーズと要求 → 要確認リンクを開きます。3.3 の行で差分をクリックし、続いてレビュー済みにする…をクリックし、確認した内容を書いてレビュー済みにするをクリックします。
- ドキュメントでバージョン ▾ → 版を比較…を選び、元を PDR Baseline、先を現在のバージョンにして、変更(Excel)をクリックします。
- 管理とレビュー → ベースラインとバージョンを開き、SRR Baseline の隣に PDR Baseline があることを確認します。1 つのドキュメントではなくモデル全体を固定するには、このページヘッダーの+ ベースラインを保存…を使います。
PDR Baseline からの変更レポートに 3.3 の編集が表示され、確認したリンクが要確認リンクに表示されなくなれば完了です。
確認問題
- 要求を変更すると、要求だけでなくそれに依存するリンクにも印が付くのはなぜですか?
- ドキュメントのベースラインとプロジェクトのベースラインの違いは何ですか?
- リンクをレビュー済みにするとき、メモを書くのはなぜですか?
解答を表示
要求を変更すると、要求だけでなくそれに依存するリンクにも印が付くのはなぜですか?
反対側の端にある項目(それを満たす機能や、それを検証するテストなど)は、古いテキストに照らして確認されていました。それぞれのリンクがまだ成り立つかどうか、もう一度確認する必要があります。
ドキュメントのベースラインとプロジェクトのベースラインの違いは何ですか?
ドキュメントのベースラインは 1 つのドキュメントとその承認を固定します(バージョン ▾ → ベースラインを保存…)。プロジェクトのベースラインはすべての項目と関係を固定します(ベースラインとバージョン → + ベースラインを保存…)。
リンクをレビュー済みにするとき、メモを書くのはなぜですか?
メモには、何を確認し、なぜリンクがまだ成り立つかが記録されます。リンク先の項目のコメントに追加されるため、レビュー担当者が後から判断の経緯をたどれます。
関連資料
トランスクリプト
トランスクリプトを表示 (ナレーションと画面の内容)
Introduction
Chapter four: baselines and links to review. Once a specification is agreed, changes need control: everyone should know what changed, and what the change might break.
We baseline the Bike-Share Dock specification, then change one of its requirements.
Change control
A baseline is a read-only snapshot of a document, with its approvals. After it, every change is visible, and a change to a requirement marks the links that depend on it for review, until someone checks them.
On screen: Card: baselines and links to review.
First, give Show Available Bikes a link to depend on. In the Database, select it, and in its Trace section link it with satisfied by to the rental kiosk, which shows the numbers.
On screen: 4.1.1 → Trace → satisfied by + → Link existing… → Rental Kiosk.
Baseline
Open the specification, and the version menu in its title block. Choose Save Baseline, name it SRR Baseline for the requirements review, add your role, and click Create.
On screen: SRS → Current version ▾ → Save Baseline… → SRR Baseline → Create.
A change
Now a change. The team wants the kiosk to show the charge level of each e-bike too. Select Show Available Bikes, and update its statement in the inspector.
On screen: 4.1.1 → Item → new description.
The message says what happened, in the same undo step as the edit: the approved requirement went back to In Review, and its link to the rental kiosk now needs review.
On screen: The toast and the status.
Links to review
Open Needs and Requirements, then Links to Review. Each row is a link to check. Diff shows exactly how the text changed.
On screen: Links to Review → Diff.
The rental kiosk can show charge levels too, so the link still holds. Click Mark Reviewed, write what you checked, and click Mark Reviewed. The link no longer needs review.
On screen: Mark Reviewed… → note → Mark Reviewed.
Changes since the baseline
To see everything that changed since the review, open the specification's version menu again, and choose Compare Versions: from SRR Baseline to the current version.
On screen: SRS → version ▾ → Compare Versions… → SRR Baseline → Current.
The report lists each addition, removal and edit, ready to export to Excel or as a Word redline for a change board.
On screen: The change report.
Recap
Let's recap. You baselined the specification with an approval, changed an approved requirement, saw it return to review with its link flagged, marked the link reviewed with a note, and listed the changes since the baseline.
Next, you plan and run the tests that verify the requirements.