トラック 4. ドキュメントと成果物:演習シート
エンジニアとリーダー向け。チャプターごとに演習課題 1 つといくつかの問題があり、各動画の後に取り組みます。このページはブラウザーから印刷するか、画面上で使ってください。解答は最後の新しいページから始まります。
始める前に
- 先に受講
- チャプター 1.5 ドキュメント。トラック 2 と 3 を受講すると、マトリックスがさらに役立ちます。
- プラン
- Free
- プロジェクト
- Bike-Share Dock:各チャプターに開始ファイルがあります。
4.1 ドキュメントテンプレート
チャプター 4.1 を視聴(2:54)
演習
CubeSat EO-1 デモプロジェクトで:
- EO-1 デモプロジェクトを開くか、作成します:プロジェクトを管理 → プロジェクトファイル ▾ → 新しいデモプロジェクト → CubeSat(ガイド付きシステムズエンジニアリング)。
- ニーズと要求 → ドキュメントを開き、+ 新しいドキュメントをクリックします。名前を
EO-1 Interface Control Documentにします。 - 対象のテンプレートで Interface Control Document を選び、記述ガイダンスを含めるにチェックを入れ、Interface Control Document (ICD) カードを選んで作成をクリックします。
- セクション 2.3 Interface Owners and Change Authority を選択し、そのガイダンスを読みます。説明をクリックし、ガイダンスを EO-1 インターフェースのオーナー(たとえば Payload Lead と Comms Lead)に置き換えて、⌘ / Ctrl↵ を押して保存します。
- セクション 3.2 Interface Matrix を選択し、テンプレートがそこに配置したライブのインターフェースマトリックスを確認します。
- チェック付きのウォークスルーを行うには、チュートリアル 11「成果物を作成する」を実行します(ヘルプ → チュートリアル)。
新しい ICD の 2.3 にガイダンスではなく自分のテキストが表示され、3.2 に EO-1 のコンポーネントのマトリックスが表示されれば完了です。
よくある質問
- 「新しいドキュメント」が最初に表示するテンプレートは何によって決まりますか?
- 記述ガイダンスありのテンプレートとなしのテンプレートの違いは何ですか?
- 各セクションがモデル項目であることが重要なのはなぜですか?
4.2 ドキュメント内のライブマトリックス
チャプター 4.2 を視聴(2:48)
演習
CubeSat EO-1 デモプロジェクトで:
- EO-1 デモプロジェクトを開くか、作成します:プロジェクトを管理 → プロジェクトファイル ▾ → 新しいデモプロジェクト → CubeSat(ガイド付きシステムズエンジニアリング)。
- ニーズと要求 → ドキュメント → EO-1 System Requirements Specification を開き、セクション 2 Attitude Determination and Control の説明をクリックして編集します。
- リッチテキストのツールバーで + を開き、マトリックス…を選びます。要求割り当てマトリックスを選び、範囲はこのドキュメントのままにして挿入をクリックし、⌘ / Ctrl↵ を押して保存します。
- キャプションと網掛けの行を確認します。2.5 Safe Mode Recovery はギャップです。これを満たすものがありません。
- 2.5 を選択し、そのトレースセクションで satisfied by の下に F10 Enter Safe Mode をリンクします。セクション 2 に戻り、マトリックスをもう一度確認します。
割り当てマトリックスの 2.5 の行に F10 Enter Safe Mode が表示され、網掛けが消えていれば完了です。
よくある質問
- ライブマトリックスは、手入力した表とどう違いますか?
- ギャップをマトリックスではなくモデルで解消するのはなぜですか?
- マトリックスはどの範囲を対象にできますか?
4.3 Word と Excel の出力
チャプター 4.3 を視聴(2:10)
演習
CubeSat EO-1 デモプロジェクトで:
- EO-1 デモプロジェクトを開くか、作成します:プロジェクトを管理 → プロジェクトファイル ▾ → 新しいデモプロジェクト → CubeSat(ガイド付きシステムズエンジニアリング)。
- EO-1 System Requirements Specification を開き、納品 ▾ → ページ設定…を選びます。区分表示で独自の区分表示を選び、
EO-1 Program Internalなどのヘッダーとフッターを設定します。 - 表紙にチェックを入れてバージョンを
2.0、作成者をEO-1 Systems Teamにし、ページ番号にチェックを入れて適用をクリックします。 - 納品 ▾ → レビュー用コピー(Word)を選んでファイルを開きます。各項目の下に属性の列がある横向きのページで、すべてのページに区分表示があります。
- 納品 ▾ → トレーサビリティマトリックス…を選びます。RVTM を選び、モデルを SRR Baseline、エクスポート形式をマトリックス(Excel)に設定し、行数とギャップ数を確認してエクスポートをクリックします。
表紙、区分表示、ページ番号付きの Word ファイルと、ギャップが網掛けされた SRR Baseline の Excel RVTM が手元にあれば完了です。
よくある質問
- ドキュメントにはどの区分表示が使われますか?
- Word テンプレートとドキュメントテンプレートの違いは何ですか?
- Word エクスポートの改訂履歴と承認の表は、どこから来ますか?
- 現在のモデルではなくベースラインからマトリックスをエクスポートするのはなぜですか?
4.4 レビューパッケージとベースライン
チャプター 4.4 を視聴(2:35)
演習
CubeSat EO-1 デモプロジェクトで:
- EO-1 デモプロジェクトを開くか、作成します:プロジェクトを管理 → プロジェクトファイル ▾ → 新しいデモプロジェクト → CubeSat(ガイド付きシステムズエンジニアリング)。この課題では「ドキュメントテンプレート」のチャプターで作成した EO-1 Interface Control Document も使います。そのチャプターを飛ばした場合は、先に作成してください。
- EO-1 System Requirements Specification を開き、ドキュメントの種類の横にあるレビューを依頼をクリックし、誰にもチェックを入れずにレビューを依頼をクリックします。タイトルの下のストリップにレビューが表示されます。
- バージョン ▾ → ベースラインを保存…をクリックし、名前を
PDR Baselineにして自分のロールを入力し、+ 承認者を追加をクリックして 2 人目の承認者を追加し、作成をクリックします。 - 2.4 Target Slew を 45 秒に変更します。次に、バージョン ▾ → 版を比較…を選び、元を PDR Baseline、先を現在のバージョンにして、変更(Excel)をクリックします。
- 管理とレビュー → レビューを開き、+ 新しいレビューパッケージをクリックして名前を
PDR review packageにします。書く ▾ → 挿入 ▸ ドキュメント…を 2 回選び、SRS と ICD を追加します。 - 納品 ▾ → 納品物の設定…を選び、SRS パートの各パートのエクスポート元を PDR Baseline に設定してから、納品 ▾ → 仕様書(Word)を選びます。
変更レポートに 2.4 の編集が表示され、パッケージの Word ファイルにパート A とパート B があり、SRS パートが PDR Baseline からのものであれば完了です。
よくある質問
- ドキュメントのベースラインには何が保持され、後から変更できますか?
- ドキュメントのベースラインとプロジェクトのベースラインはどう違いますか?
- パッケージでは、今日の編集ではなくベースライン化された SRS をエクスポートする必要があります。どうしますか?
- 「レビューを依頼」をクリックすると、レビューはどうなりますか?
4.5 モデルからのプレゼンテーション
チャプター 4.5 を視聴(1:59)
演習
CubeSat EO-1 デモプロジェクトで:
- EO-1 デモプロジェクトを開くか、作成します:プロジェクトを管理 → プロジェクトファイル ▾ → 新しいデモプロジェクト → CubeSat(ガイド付きシステムズエンジニアリング)。
- 計画 → プレゼンテーションを開き、+ 新しいプレゼンテーションをクリックします。名前を
EO-1 PDR Briefingにし、開始元をドキュメントのアウトラインにして EO-1 System Requirements Specification を選び、作成をクリックします。 - 最初のスライドのタイトルをダブルクリックし、
EO-1 Preliminary Design Reviewと入力して Esc を押します。 - + 新しいスライド ▾をクリックして空白を選び、続いて画像 ▾ → 画像…を選んで F0 Perform EO-1 Mission の FFBD を選びます。
- ▶ 発表 ▾ → 現在のスライドから発表をクリックし、→ で進めて Esc で終了します。次にエクスポート…をクリックし、プレゼンテーション(PowerPoint)を選びます。
デッキにタイトルスライド、SRS のセクションごとに 1 枚のスライド、ライブの FFBD 画像があり、PowerPoint ファイルが手元にあれば完了です。
よくある質問
- スライド上の画像を最新の状態に保つものは何ですか?
- デッキをドキュメントのアウトラインから始めるのはどんなときですか?
- デッキはどの形式にエクスポートできますか?
解答
4.1 ドキュメントテンプレート
- 「対象のテンプレート」で選んだドキュメントの種類です。他の種類のテンプレートも「その他のテンプレート」に表示されます。ドキュメントには選んだテンプレートの種類が設定されます。
- どちらも同じ番号付きセクションと初期の表を備えています。ガイダンスありでは、各セクションの冒頭に記載すべき内容の短いガイドも入り、書きながらそれを置き換えます。
- セクションは Statement なので、要求と同じようにリンク、コメント、ベースライン化ができ、ドキュメントはモデルのビューのままです。
4.2 ドキュメント内のライブマトリックス
- ブロックには、どのマトリックスをどの範囲で表示するかだけが保存されます。Holarch はドキュメントを表示またはエクスポートするたびにモデルから行を再構築するため、内容が古くなることはありません。
- ライブマトリックスはセル単位では編集できません。ギャップはモデル内のリンクや属性の欠落であり、モデルで修正すると、それを表示するすべてのマトリックスとビューが更新されます。
- 1 つのドキュメントの項目、コンピレーションのすべてのパート、またはプロジェクト全体です。インターフェースマトリックスと N² マトリックスは、1 つの Asset または Action の子を対象にすることもできます。
4.3 Word と Excel の出力
- 最も近いものです。ドキュメント自身の区分表示、なければプロジェクトの区分表示、なければ組織の区分表示です。区分表示がない場合は表示されません。
- ドキュメントテンプレートは内容を埋めます。セクションと初期の表です。Word テンプレートは Word ファイルの体裁を決めます。目次、キャプション番号、ページサイズ、前付けの表です。
- Word テンプレートに含まれている場合(仕様書テンプレートのように)、ドキュメントのベースラインとその承認記録から作成されます。
- レビューボードは合意された内容にコメントを付けます。モデルでベースラインを選ぶと、マトリックスは今日の状態ではなく、そのベースライン時点の状態でエクスポートされます。
4.4 レビューパッケージとベースライン
- ドキュメントの読み取り専用のスナップショットです。その項目、属性と関係、関係 1 つ先の項目が含まれます。名前の変更や承認の追加はできますが、既存の承認記録は編集できません。
- ドキュメントのベースラインは 1 つのドキュメントを保持し、そのドキュメントのバージョン ▾ から保存します。プロジェクトのベースラインはプロジェクト内のすべての項目を保持し、管理とレビュー → ベースラインとバージョンの + ベースラインを保存… で保存します。
- パッケージで、納品物の設定… の「各パートのエクスポート元」をそのベースラインに設定します。固定されたパートには 📌 とベースライン名が表示され、ベースラインの内容がエクスポートされます。
- ドキュメントはレビュー中になります。プロジェクトのレビュー担当者、または指定した人のマイワークの「レビュー対象のドキュメント」に表示され、そこかタイトルの下のストリップで承認または却下します。
4.5 モデルからのプレゼンテーション
- 「画像…」で作成した画像は、コピーではなくモデルのビューを表示します。ダイアグラム、ドキュメント、グラフが変わると、スライドにもその変更が表示されます。
- 説明がドキュメントに沿って進む場合です。タイトルスライドと、最上位のセクションごとにセクションのテキストを含む 1 枚のスライドが作成され、あとは削るだけです。
- プレゼンテーション全体は PowerPoint、Word、Web ページに、現在のスライドは PNG または SVG にエクスポートできます。
発行:Holarch