トラック 6. Holarch への移行:演習シート
他のツールから移行するチーム向け。チャプターごとに演習課題 1 つといくつかの問題があり、各動画の後に取り組みます。このページはブラウザーから印刷するか、画面上で使ってください。解答は最後の新しいページから始まります。
始める前に
- 先に受講
- トラック 1. はじめに、チャプター 1.1~1.3。
- プラン
- Free
- プロジェクト
- 自分の要求ファイル、または練習用に EO-1 デモからエクスポートしたファイル。
6.1 移行の計画
チャプター 6.1 を視聴(3:00)
演習
CubeSat EO-1 デモプロジェクトで:
- EO-1 デモプロジェクトを開きます(ない場合は作成します:プロジェクトを管理 → プロジェクトファイル ▾ → 新しいデモプロジェクト → CubeSat(ガイド付きシステムズエンジニアリング))。
- レールで設定 → スキーマを開き、クラスの Requirement をクリックして、要求のスプレッドシートが埋められる属性(たとえば Priority、Owner、Verification Method)を書き出します。
- スキーマのラベルページを開き、Performance Requirement などの種類がどこに保持されているかを確認します。
- サプライヤーのトラッカーに、受け皿のない
Supplier Refという列があるとします。Requirement で + 属性をクリックし、名前をSupplier Refにしてテキスト型を選び、属性を追加をクリックします。 - ニーズと要求 → インポートとエクスポートを開き、ドロップゾーンが受け付ける形式と、エクスポートカードで利用できるものを確認します。
Requirement の属性リストの最後に Supplier Ref があり、一般的なトラッカーの各列がどこに入るかを説明できれば完了です。
よくある質問
- インポートの前に、データの種類ごとの行き先を決めるのはなぜですか?
- 対応する属性がない列があります。どんな選択肢がありますか?
- インポートが失敗しました。どうやって取り消しますか?
- インポートページではなく、プロジェクトを管理 → プロジェクトをインポート (.json)… を使うのはどんなときですか?
6.2 Excel と CSV からの要求
チャプター 6.2 を視聴(2:32)
演習
CubeSat EO-1 デモプロジェクトで:
- EO-1 デモプロジェクトを開きます(ない場合は作成します:プロジェクトを管理 → プロジェクトファイル ▾ → 新しいデモプロジェクト → CubeSat(ガイド付きシステムズエンジニアリング))。データベースで
class:Requirementを検索し、エクスポート…をクリックして表(CSV)を選び、Status と Priority にチェックを入れ(Labels はチェックしたまま)、エクスポートをクリックします。 - スプレッドシートアプリでファイルを開きます。ヘッダーとセクション 1 と 2 の行を残し、先頭に 2 行を追加します:
1、Mission Imaging、ClassStatementと、2、Attitude Determination and Control、ClassStatement。.xlsx または .csv として保存します。 - プロジェクトを管理で+ 新しいプロジェクトをクリックし、名前を
EO-1 Import Practiceにしてプロジェクトを作成をクリックします。 - ニーズと要求 → インポートとエクスポートを開き、ファイルをドロップして続行をクリックし、各列の Holarch のフィールドを確認します(不要な列はスキップに設定)。
- 続行をクリックし、Create a document from these N items にチェックを入れたまま、Import N items をクリックします。
- 新しいドキュメントで、1.6.1 と 1.6.2 が 1.6 の下にあることを確認し、1.5 を選択してラベルとステータスを確認します。
新しいドキュメントにセクション 1 と 2 が表示され、その要求が番号どおりに入れ子になり、ラベルとステータスが保たれていれば完了です。
よくある質問
- Holarch はスプレッドシートの行の階層をどのように再構築しますか?
- 一部の行が誤ったクラスで取り込まれました。なぜですか?
- 既存の 50 件の要求のオーナーを、コピーを作らずにスプレッドシートから更新したいと考えています。どうしますか?
6.3 Word と ReqIF からの要求
チャプター 6.3 を視聴(2:22)
演習
CubeSat EO-1 デモプロジェクトで:
- 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 が知らない名前が付いています。どうなりますか?
6.4 他のツールのモデル
チャプター 6.4 を視聴(2:44)
演習
CubeSat EO-1 デモプロジェクトで:
- EO-1 デモプロジェクトを開きます(ない場合は作成します:プロジェクトを管理 → プロジェクトファイル ▾ → 新しいデモプロジェクト → CubeSat(ガイド付きシステムズエンジニアリング))。ニーズと要求 → インポートとエクスポートを開き、エクスポートのカードでUML/SysML (XMI) をエクスポート…をクリックし、形式を OMG XMI 2.5.1 (.xmi) のままにして、エクスポートをクリックします。このファイルは、Cameo や Enterprise Architect などの SysML ツールからのエクスポートの代わりです。
- プロジェクトを管理で+ 新しいプロジェクトをクリックし、名前を
EO-1 Import Practiceにしてプロジェクトを作成をクリックします。ニーズと要求 → インポートとエクスポートを開き、.xmi ファイルをドロップし、形式に UML/SysML (.xmi, .uml, .mdzip) と表示されていることを確認して、続行を 2 回クリックし、確認を読んでN 件の項目をインポートをクリックします。 - データベースで
class:Assetを検索し、Payload Camera を選択して、トレースで EO-1 Spacecraft の一部であること、およびどの Action を実行するかを確認します。 - ダイアグラムを開き、+ 新しいダイアグラムをクリックし、Asset 図を選択し、ダイアグラムの対象で EO-1 Spacecraft を選択して、作成をクリックします。
- 実行する Actionをオンにして、各サブシステムの機能を一覧表示します。
新しいプロジェクトの Asset 図に、スペースクラフトのサブシステムと、それぞれが実行する Action が表示されれば完了です。
よくある質問
- SysML v1 ツールのどのファイルを Holarch にインポートできますか。また、どのように入手しますか。
- インポート後にダイアグラムをすばやく再構築できるのはなぜですか。
- 同じモデルの新しいエクスポートをインポートしても、コピーができないのはなぜですか。
6.5 インポート後の整理
チャプター 6.5 を視聴(2:40)
演習
CubeSat EO-1 デモプロジェクトで:
- これまでのチャプターで作成した
EO-1 Import Practiceプロジェクトを開きます(またはチャプター 2 と同様に EO-1 の要求の CSV をインポートします)。 - ニーズと要求 → 品質を開き、スコープバーでインポートしたドキュメントの 1 つを選んで、品質をチェックをクリックします。
- 同じ要求を 2 回(Word と ReqIF で)インポートした場合は、データベースで重複の行にチェックを入れ、一括操作バーの項目を削除…で削除します。2.5 Safe Mode Recovery を測定可能になるよう書き直し、もう一度品質をチェックします。
- 検証 → モデルチェックを開き、ルール Requirement.8(どの設計エンティティも満たしていない末端の要求)を開きます。
- アセットもインポートした場合は(チャプター 4)、2.1 Pointing Accuracy を選択し、トレースで + → 既存をリンク…を使って ADCS への satisfied by を追加します。モデルチェックをもう一度実行します。
2.5 のスコアが以前より高くなり、Requirement.8 に 2.1 が表示されなくなれば完了です。
よくある質問
- 品質チェックは何を確認し、モデルチェックは何を確認しますか?
- 自動の品質スコアが 78% を超えないのはなぜですか?
- 移行の直後に要求と部品をつなげるのはなぜですか?
解答
6.1 移行の計画
- 正しいクラス、ラベル、属性、関係に入ったデータは、トレース、品質チェック、レポートですぐに使えます。インポート後に修正すると、多数の項目を手作業で編集することになります。
- インポートの前に 設定 → スキーマ で属性を追加するか、マッピングの手順でその列を「新しい属性(スキーマに追加)」にマッピングします。
- ⌘Z / Ctrl+Z を 1 回押します。インポートページからのインポートは、元に戻す操作の 1 単位です。
- プロジェクト全体を、別の新しいプロジェクトとして復元するときです。インポートページは、ファイルの項目を開いているプロジェクトに統合します。
6.2 Excel と CSV からの要求
- マッピングされていれば親行の ID 列または親番号の列から、そうでなければアウトライン番号から再構築します。1.2 は 1 の下に入ります。親がない場合は、存在する最も近い祖先が使われます。
- スキーマが知らない名前を含む Class 列は、警告とともに「クラスのない行のクラス」に置き換えられます。スキーマエディターのクラス名を使ってください。
- ID 列付きでエクスポートし、ファイルを編集して、ID 列をグローバル ID にマッピングし「既存の項目の照合基準」をグローバル ID に設定してインポートします。確認の手順で、それらが「更新された項目」に表示されます。
6.3 Word と ReqIF からの要求
- Word の見出しスタイルの段落は Statement(セクション)になります。shall、must、will、should を含む段落は Requirement になり、動詞の後の最初の語から命名されます。プレーンな太字テキストで入力された見出しは、通常のテキストとして読み取られます。
- ReqIF は各要求の識別子、階層、属性、関係を保持します。サプライヤーが新しいファイルを送ってきたとき、それをインポートするとコピーが追加されるのではなく、同じ項目が更新されます。
- traced to として取り込まれます。スキーマが 2 つのクラス間で traced to を許可していない場合、その関係は警告とともにスキップされます。
6.4 他のツールのモデル
- Cameo/MagicDraw、Enterprise Architect、Rhapsody、Papyrus の SysML 1.x プロファイル付き XMI 2.x(ツールからエクスポートします)、Cameo または MagicDraw の .mdzip プロジェクト(直接)、Papyrus の .uml ファイルです。要求だけなら ReqIF、テーブルなら Excel または CSV でも取り込めます。
- 他のツールのダイアグラムのレイアウトはインポートされませんが、関係はインポートされます。Holarch は、その関係から Asset 図、階層図などのダイアグラムを描きます。
- インポートされた各項目は XMI ID を保持し、XMI ファイルでは「一致する既存のエンティティ」の既定が XMI ID になるため、次回のインポートでそれらの項目が更新されます。すでにある関係は重複して追加されません。
6.5 インポート後の整理
- 品質チェックは、各要求の記述を良い要求の性質と照らしてスコアを付けます。モデルチェックはモデル全体を見て、何も満たしていない要求、孤立した項目、誰も実行していないアクションなどのギャップを探します。
- Correct と Feasible には人の判断が必要なため、チェックはそれらを満たしたとはしません。要求を確認した後に自分で設定します。
- それらは別々のファイルから、互いのリンクなしで取り込まれます。satisfied by のリンクは、それ以降トレーサビリティ、カバレッジ、モデルチェックに反映されます。
発行:Holarch