製品の指定
このチュートリアルのこのパートでは、Requirements Portal の利用を開始するための主要なユーザーフローの1つを順に確認します。
-
要件の収集と記述
-
要件の分解
-
要件のレビューと改善
-
仕様の承認とリリース
新規プロジェクトの作成
-
左上の Project ドロップダウンメニューをクリックし、
ボタンをクリックします。
-
開いたプロジェクト設定ページで、適切な(かつ一意の)プロジェクト名(例:
Valifan)を Project name フィールドに入力し、続いて
ボタンをクリックします。
ステークホルダー要件の定義
多くのシステム設計・開発は V cycle に従います。Vサイクルの最初のプロセスは、ビジネスニーズを理解し、ステークホルダーのニーズを特定することです。これらのステークホルダーのニーズは、直接作成したり、CSV/XLSX からインポートしたり、AI 搭載の ValiAssistant で作成したりできるステークホルダー要件へと変換されます。このチュートリアルのこのパートでは、インポート方法に焦点を当てます。
-
ステークホルダー要件を含む次の CSV ファイルをダウンロードします。
-
まだの場合は、左側のプロジェクトツリーで Requirements エントリをクリックして Requirements Module に移動します。
-
開いたページで
ボタンをクリックし、表示されるメニューから Import Requirements を選択します。
-
開いた Document Importer ウィンドウで、open the legacy importer here リンクをクリックします。
-
Import Requirements ウィザードが開きます。Create a specification 領域で仕様の Name(例:
Stakeholder_requirements)を定義し、続いて
ボタンをクリックします。
-
次のステップでは、インポートウィザードがファイルを読み取りインポートできるように CSV をアップロードします。ダウンロードした CSV ファイルを Import Requirements ウィザードの Drop file 領域にドラッグ&ドロップします(または領域をクリックしてダイアログからアップロードします)。
-
次のステップでは、CSV ファイルのデータ列が Requirements Portal の列に正しくマッピングされていることを確認します。必要に応じて、表の上部にある Map To ドロップダウンを使用します。
-
ウィザードの次のページで、インポートが成功したことが通知されます。ウィンドウ上部の Check now コントロールをクリックして、データ駆動型システムエンジニアリングのアプローチに従い、値と単位をパラメータ(valis)に変換します。
-
開いた Valify Requirements ウィンドウで、5つの要件が valify されることが通知されます。
をクリックして進むと、2つの vali が見つかったという通知が表示されます。
をクリックして進み、続いて
をクリックします。
-
ご覧のとおり、50 dB と 50 W は単なるテキストから、後で使用できる vali に変換されました。
Valify Requirements ウィンドウを閉じて進みます。すべての要件が追加され、検出されたすべての値が vali に変換されました。vali は要件内でハイライト表示されます。
システム要件の追加
一般的なシステムエンジニアリングのフローでは、システム要件はステークホルダー要件を用いて作成されます。多くの技術設計は、質量、消費電力、コストなどの厳格な要件に従う必要があります。Requirements Portal は、設計がこれらすべての要件をどの程度満たしているかを包括的に可視化します。
ここでは、いくつかのシステム要件を手動で作成します。
-
左側のプロジェクトツリーで Requirements エントリを右クリックし、表示されるメニューから Create Specification を選択します。Create new specification ウィンドウで、Name フィールドに
Fan_Specsを入力し 、
をクリックします。
-
プロジェクトツリーで新しく作成した仕様のエントリをクリックします。この仕様内で、
ボタンをクリックし、表示されるメニューから Create Requirement を選択します。
-
Create new requirement ウィンドウが開きます。このウィンドウで次を行います。
-
Specification フィールドで、正しい仕様が選択されていることを確認します(
Fan_Specs)。 -
Identifier フィールドに、一意の識別子(例:
R-Fan-001)を入力します。 -
Requirement text フィールドに
The Mass of the fan shall not exceed 300gを入力します。 -
Check for possible Valis オプションが有効になっていることを確認します。
-
-
表示される Valify Requirements ウィンドウで
ボタンをクリックします。要件内に vali が見つかります。
ボタンをクリックして値を vali に変換し、次に
ボタンをクリックして進み、最後に
ボタンをクリックして処理を完了します。
-
同様に、識別子を
R-Fan-002、要件テキストをThe Mass of the propeller shall not exceed 50gとして別の要件を追加します。ただし今回は Check for possible Valis オプションを無効にします(この要件内の値からは、後で手動で vali を作成します)。
-
Fan_Specs 仕様を選択すると、追加した要件が一覧表示されます。R-Fan-001 には vali がある一方で、R-Fan-002 にはまだ vali がない点に注意してください。
要件内での Requirement Vali の作成
次に、要件テキストフィールド内に新しい vali を手動で作成します。
-
R-Fan-002 の要件の Text 列のセルをダブルクリックし、
50gテキストを削除します。
-
$と入力すると、プロジェクト内の vali/オブジェクトの一覧を含むポップアップが表示されます。ポップアップ右上の
ボタンをクリックして vali を作成します。
-
開いた Create new ウィンドウで、ウィンドウの Vali タブにて、新しい vali に次のデータを入力します。
-
Name:
Req_Mass_Propeller -
Formula and unit:
50g -
Display unit:
g
-
-
これで
50gのテキストは通常のテキストとは異なる表示になり、vali であることが示されます。この vali は、プロジェクトのさまざまな箇所(例:レポート、Blocks Module、検証など)で使用できます。
親子関係による要件の分解
-
表の右側にある Columns コントロールをクリックし、Parents 列と Children 列のエントリにチェックが入っていて表に表示されていることを確認します。
Columns コントロールをもう一度クリックして一覧を非表示にします。
-
R-Fan-002 の要件の Parent 列のセルをダブルクリックし、ポップアップから要件 R-Fan-001 を選択して両方の要件をリンクします。R-Fan-002 は自動的に R-Fan-001 の Children 列に追加される点に注意してください。
-
要件表の上部にある Connections タブをクリックし、選択した仕様の親子関係を示す接続グラフを開きます。
ValiAssitant を使用した要件生成
要件管理プロセスを加速するために、AI の ValiAssistant 機能を使って要件/要件分解を生成できます。ここでは、チュートリアルプロジェクト用に2つの安全要件を作成するために使用します。
-
右上の
ボタンをクリックして ValiAssistant - Generate Requirements ウィンドウを開きます。ドロップダウンで Generate Requirements オプションが選択されていることを確認し、
ボタンをクリックします。
-
次のページでは、製品、システム、サブシステムについてできるだけ多くの情報を記述することで、AI が説明に最適な要件を作成できるようにします。ここでは安全要件に関心があるため、Generate Description 見出しの下のフィールドに
Create 2 safety requirements for designing a fanのテキストを入力し、ファンに対する2つの安全要件を依頼します。Prompt Extension見出しの下にあるテキストフィールドでは、プロンプトをさらにカスタマイズできます。ここでは INCOSE 形式で記述された要件を求めているため、
Apply the INCOSE guide to writing requirementsのテキストをフィールドに入力します。
-
次のページではAIの出力が表示され、提案内容を確認し、変更したうえで承認または却下できます。
-
要件の生成が成功したことを知らせるダイアログを閉じます。生成された要件は Fan_Spec 仕様の表に表示されます。
要件の更新、管理、レビュー
開発プロセス全体を通して、要件はステークホルダーからの入力や設計上の制約など、さまざまな要因により変化し、更新されるのが一般的です。Requirements Portal では、列フィールドをダブルクリックするか、要件の詳細セクション内で直接要件を更新でき、すべての変更は履歴に記録されるため参照が容易です。
-
R-Fan-003 または R-Fan-004 の要件テキストを編集モードにするには、Text 列のセルをダブルクリックします。テキストを
The fan shall include a protective guard with openings no larger than inches to prevent accidental contact with moving parts.に変更し、Enterを押すか、セルの外(表内の別の場所)をクリックして編集を終了します。 -
変更した要件の識別子をクリックすると詳細ビューが開き、追加フィールドの調整、購読、オーナーの定義、根拠(rationale)の追加、親/子の作成などを行えます。
-
トレーサビリティは Requirements Portal の重要な概念であり、すべての変更は要件および他のオブジェクトの履歴で追跡されます。History をクリックすると、バージョン情報、誰がいつ変更したか、対象フィールドや実行アクションを確認できるビューが開きます。
要件の検証
製品ライフサイクルの初期段階では、設計プロセスを進める前に要件を検証することが重要です。Requirements Portal では State 列を使用して要件の状態を便利に管理できます。デフォルトでは Draft、In Review、Final などの状態が含まれていますが、必要に応じて追加の状態を追加できます。
このチュートリアルのこのパートでは、新しく追加した要件に Draft 状態を割り当て、構造化された整理されたワークフローを確保します。
-
Fan_Spec 仕様で、表の右側にある Columns コントロールをクリックし、State 列のエントリにチェックが入っていて表に表示されていることを確認します。
-
Identifier 列ヘッダーの左側にあるチェックボックスをオンにして、仕様内のすべての要件を選択します。
-
State 列の任意の要件セルをダブルクリックします(必要に応じて、列が見えるように表を右へスクロールします)。状態の選択肢がドロップダウンで表示されます。ドロップダウンで Draft を選択し、更新を確定します。すべての要件が Draft 状態になります。