コースのチャプター
トレーニング · トラック 6. Holarch への移行 · チャプター 6.3(全 5 チャプター)
6.3 Word と ReqIF からの要求 2:22
Word の仕様書をドキュメントとして、サプライヤーの ReqIF ファイルを階層とリンクとともにインポートします。
Holarch 2.21 の画面です。
学習内容
- Word ファイルのどの部分がセクションになり、どの部分が要求になるかを説明する
- Word の仕様書を番号付きの要求ドキュメントとしてインポートする
- ReqIF ファイルを階層、属性、関係とともにインポートする
- インポートした関係をトレースセクションで確認する
Plant Inspection Drone のペイロード仕様書を Word からインポートし(見出しがセクションに、shall 文が要求になります)、バッテリーサプライヤーの要求を ReqIF から階層、属性、refines 関係とともにインポートします。
プロジェクトファイル
- 開始時のプロジェクト (.holarch.json。プロジェクトを管理 → プロジェクトファイル ▾ → プロジェクトをインポート (.json)…)
- 完成したプロジェクト (.holarch.json。プロジェクトを管理 → プロジェクトファイル ▾ → プロジェクトをインポート (.json)…)
動画は holarch.app から再生されます。プライバシーポリシーをご覧ください。
演習
CubeSat EO-1 デモプロジェクトを使って、Holarch で実際に操作します。
- EO-1 デモプロジェクトを開きます(ない場合は作成します:プロジェクトを管理 → プロジェクトファイル ▾ → 新しいデモプロジェクト → CubeSat(ガイド付きシステムズエンジニアリング))。ドキュメント → EO-1 System Requirements Specification を開き、納品 ▾ → 仕様書(Word)をクリックします。
- 同じドキュメントで 納品 ▾ → 要求(ReqIF)…をクリックし、エクスポートをクリックします。
- プロジェクトを管理で+ 新しいプロジェクトをクリックし、名前を
EO-1 Import Practiceにしてプロジェクトを作成をクリックします。ニーズと要求 → インポートとエクスポートを開き、.docx をドロップして続行を 2 回クリックし、インポートします。 - 新しいドキュメントを SRS と比較します。どの見出しが Statement になり、どの shall 文が Requirement になったか、それらがどのように命名されたかを確認します。
- 同じプロジェクトに .reqif ファイルをインポートし、作成されたドキュメントを開いて 1.6 Revisit Time を選択し、その子とラベルを確認します。
プロジェクトに Word からのドキュメントと ReqIF からのドキュメントの 2 つがあり、どちらが元の名前と番号を保持したかを説明できれば完了です。
確認問題
- Word のインポートは、何をセクションとして、何を要求として読み取りますか?
- サプライヤーは Word でも ReqIF でも送れます。ReqIF を求めるのはなぜですか?
- ReqIF の関係に、Holarch が知らない名前が付いています。どうなりますか?
解答を表示
Word のインポートは、何をセクションとして、何を要求として読み取りますか?
Word の見出しスタイルの段落は Statement(セクション)になります。shall、must、will、should を含む段落は Requirement になり、動詞の後の最初の語から命名されます。プレーンな太字テキストで入力された見出しは、通常のテキストとして読み取られます。
サプライヤーは Word でも ReqIF でも送れます。ReqIF を求めるのはなぜですか?
ReqIF は各要求の識別子、階層、属性、関係を保持します。サプライヤーが新しいファイルを送ってきたとき、それをインポートするとコピーが追加されるのではなく、同じ項目が更新されます。
ReqIF の関係に、Holarch が知らない名前が付いています。どうなりますか?
traced to として取り込まれます。スキーマが 2 つのクラス間で traced to を許可していない場合、その関係は警告とともにスキップされます。
関連資料
トランスクリプト
トランスクリプトを表示 (ナレーションと画面の内容)
Introduction
Chapter three: requirements from Word and ReqIF. Many specifications live in Word, and many suppliers exchange requirements as ReqIF files. Both come in through the same Import and Export page.
We import the payload specification and the battery supplier's requirements into the Plant Inspection Drone project.
Word
The Word file uses heading styles for its sections, and plain sentences with shall for its requirements. That is what the Word import reads. Heading styles or Word's list numbering matter: headings typed as ordinary bold text are read as ordinary text.
On screen: Card: what Holarch reads in Word.
Open Import and Export, and drop the file. Holarch detects Word from the file and analyzes it.
On screen: Import and Export → drop the .docx → Word detected.
Click Continue. The numbering pattern stays automatic, which uses numbered headings and shall sentences. Click Continue for the review: Holarch creates a requirements document with the name of the file, and lists the sections and the requirements under them.
On screen: Continue → Map: numbering → Continue → Review.
Click Import. The document opens, numbered from the Word headings, with each shall sentence as a requirement you can now trace and check.
On screen: Import → the document.
ReqIF
Now the supplier's file. ReqIF is the standard exchange format between requirements tools. Open Import and Export again, and drop the file.
On screen: Import and Export → drop the .reqif → ReqIF detected.
Click Continue. Each requirement in the file is a row. Its ReqIF identifier and its parent rebuild the hierarchy, its type becomes the class, and its attributes map by name: the chapter name to the number, the name, and the text to the description.
On screen: Continue → Map.
Click Continue, check the review, and click Import.
On screen: Continue → Review → Import.
Check the result
The supplier's relations come in as relationships. Select Charge Time, and open Trace: it refines Pack Capacity, just as the file says.
On screen: Select B.4 Charge Time → Trace.
Recap
Let's recap. You imported a Word specification, where headings became sections and shall sentences requirements, and a supplier's ReqIF file, with its hierarchy, attributes and relations.
Next, a whole model from another tool.