Holarch

トレーニング · トラック 6. Holarch への移行

トラック 6. Holarch への移行:演習シート

他のツールから移行するチーム向け。チャプターごとに演習課題 1 つといくつかの問題があり、各動画の後に取り組みます。このページはブラウザーから印刷するか、画面上で使ってください。解答は最後の新しいページから始まります。

始める前に

先に受講
トラック 1. はじめに、チャプター 1.1~1.3。
プラン
Free
プロジェクト
自分の要求ファイル、または練習用に EO-1 デモからエクスポートしたファイル。

6.1 移行の計画

チャプター 6.1 を視聴(3:00)

演習

CubeSat EO-1 デモプロジェクトで:

  1. EO-1 デモプロジェクトを開きます(ない場合は作成します:プロジェクトを管理 → プロジェクトファイル ▾ → 新しいデモプロジェクト → CubeSat(ガイド付きシステムズエンジニアリング))。
  2. レールで設定 → スキーマを開き、クラスの Requirement をクリックして、要求のスプレッドシートが埋められる属性(たとえば Priority、Owner、Verification Method)を書き出します。
  3. スキーマのラベルページを開き、Performance Requirement などの種類がどこに保持されているかを確認します。
  4. サプライヤーのトラッカーに、受け皿のない Supplier Ref という列があるとします。Requirement で + 属性をクリックし、名前を Supplier Ref にしてテキスト型を選び、属性を追加をクリックします。
  5. ニーズと要求 → インポートとエクスポートを開き、ドロップゾーンが受け付ける形式と、エクスポートカードで利用できるものを確認します。

Requirement の属性リストの最後に Supplier Ref があり、一般的なトラッカーの各列がどこに入るかを説明できれば完了です。

よくある質問

  1. インポートの前に、データの種類ごとの行き先を決めるのはなぜですか?
  2. 対応する属性がない列があります。どんな選択肢がありますか?
  3. インポートが失敗しました。どうやって取り消しますか?
  4. インポートページではなく、プロジェクトを管理 → プロジェクトをインポート (.json)… を使うのはどんなときですか?

6.2 Excel と CSV からの要求

チャプター 6.2 を視聴(2:32)

演習

CubeSat EO-1 デモプロジェクトで:

  1. EO-1 デモプロジェクトを開きます(ない場合は作成します:プロジェクトを管理 → プロジェクトファイル ▾ → 新しいデモプロジェクト → CubeSat(ガイド付きシステムズエンジニアリング))。データベースで class:Requirement を検索し、エクスポート…をクリックして表(CSV)を選び、Status と Priority にチェックを入れ(Labels はチェックしたまま)、エクスポートをクリックします。
  2. スプレッドシートアプリでファイルを開きます。ヘッダーとセクション 1 と 2 の行を残し、先頭に 2 行を追加します:1、Mission Imaging、Class Statement と、2、Attitude Determination and Control、Class Statement。.xlsx または .csv として保存します。
  3. プロジェクトを管理で+ 新しいプロジェクトをクリックし、名前を EO-1 Import Practice にしてプロジェクトを作成をクリックします。
  4. ニーズと要求 → インポートとエクスポートを開き、ファイルをドロップして続行をクリックし、各列の Holarch のフィールドを確認します(不要な列はスキップに設定)。
  5. 続行をクリックし、Create a document from these N items にチェックを入れたまま、Import N items をクリックします。
  6. 新しいドキュメントで、1.6.1 と 1.6.2 が 1.6 の下にあることを確認し、1.5 を選択してラベルとステータスを確認します。

新しいドキュメントにセクション 1 と 2 が表示され、その要求が番号どおりに入れ子になり、ラベルとステータスが保たれていれば完了です。

よくある質問

  1. Holarch はスプレッドシートの行の階層をどのように再構築しますか?
  2. 一部の行が誤ったクラスで取り込まれました。なぜですか?
  3. 既存の 50 件の要求のオーナーを、コピーを作らずにスプレッドシートから更新したいと考えています。どうしますか?

6.3 Word と ReqIF からの要求

チャプター 6.3 を視聴(2:22)

演習

CubeSat EO-1 デモプロジェクトで:

  1. EO-1 デモプロジェクトを開きます(ない場合は作成します:プロジェクトを管理 → プロジェクトファイル ▾ → 新しいデモプロジェクト → CubeSat(ガイド付きシステムズエンジニアリング))。ドキュメント → EO-1 System Requirements Specification を開き、納品 ▾ → 仕様書(Word)をクリックします。
  2. 同じドキュメントで 納品 ▾ → 要求(ReqIF)…をクリックし、エクスポートをクリックします。
  3. プロジェクトを管理で+ 新しいプロジェクトをクリックし、名前を EO-1 Import Practice にしてプロジェクトを作成をクリックします。ニーズと要求 → インポートとエクスポートを開き、.docx をドロップして続行を 2 回クリックし、インポートします。
  4. 新しいドキュメントを SRS と比較します。どの見出しが Statement になり、どの shall 文が Requirement になったか、それらがどのように命名されたかを確認します。
  5. 同じプロジェクトに .reqif ファイルをインポートし、作成されたドキュメントを開いて 1.6 Revisit Time を選択し、その子とラベルを確認します。

プロジェクトに Word からのドキュメントと ReqIF からのドキュメントの 2 つがあり、どちらが元の名前と番号を保持したかを説明できれば完了です。

よくある質問

  1. Word のインポートは、何をセクションとして、何を要求として読み取りますか?
  2. サプライヤーは Word でも ReqIF でも送れます。ReqIF を求めるのはなぜですか?
  3. ReqIF の関係に、Holarch が知らない名前が付いています。どうなりますか?

6.4 他のツールのモデル

チャプター 6.4 を視聴(2:44)

演習

CubeSat EO-1 デモプロジェクトで:

  1. EO-1 デモプロジェクトを開きます(ない場合は作成します:プロジェクトを管理 → プロジェクトファイル ▾ → 新しいデモプロジェクト → CubeSat(ガイド付きシステムズエンジニアリング))。ニーズと要求 → インポートとエクスポートを開き、エクスポートのカードでUML/SysML (XMI) をエクスポート…をクリックし、形式を OMG XMI 2.5.1 (.xmi) のままにして、エクスポートをクリックします。このファイルは、Cameo や Enterprise Architect などの SysML ツールからのエクスポートの代わりです。
  2. プロジェクトを管理で+ 新しいプロジェクトをクリックし、名前を EO-1 Import Practice にしてプロジェクトを作成をクリックします。ニーズと要求 → インポートとエクスポートを開き、.xmi ファイルをドロップし、形式に UML/SysML (.xmi, .uml, .mdzip) と表示されていることを確認して、続行を 2 回クリックし、確認を読んでN 件の項目をインポートをクリックします。
  3. データベースで class:Asset を検索し、Payload Camera を選択して、トレースで EO-1 Spacecraft の一部であること、およびどの Action を実行するかを確認します。
  4. ダイアグラムを開き、+ 新しいダイアグラムをクリックし、Asset 図を選択し、ダイアグラムの対象で EO-1 Spacecraft を選択して、作成をクリックします。
  5. 実行する Actionをオンにして、各サブシステムの機能を一覧表示します。

新しいプロジェクトの Asset 図に、スペースクラフトのサブシステムと、それぞれが実行する Action が表示されれば完了です。

よくある質問

  1. SysML v1 ツールのどのファイルを Holarch にインポートできますか。また、どのように入手しますか。
  2. インポート後にダイアグラムをすばやく再構築できるのはなぜですか。
  3. 同じモデルの新しいエクスポートをインポートしても、コピーができないのはなぜですか。

6.5 インポート後の整理

チャプター 6.5 を視聴(2:40)

演習

CubeSat EO-1 デモプロジェクトで:

  1. これまでのチャプターで作成した EO-1 Import Practice プロジェクトを開きます(またはチャプター 2 と同様に EO-1 の要求の CSV をインポートします)。
  2. ニーズと要求 → 品質を開き、スコープバーでインポートしたドキュメントの 1 つを選んで、品質をチェックをクリックします。
  3. 同じ要求を 2 回(Word と ReqIF で)インポートした場合は、データベースで重複の行にチェックを入れ、一括操作バーの項目を削除…で削除します。2.5 Safe Mode Recovery を測定可能になるよう書き直し、もう一度品質をチェックします。
  4. 検証 → モデルチェックを開き、ルール Requirement.8(どの設計エンティティも満たしていない末端の要求)を開きます。
  5. アセットもインポートした場合は(チャプター 4)、2.1 Pointing Accuracy を選択し、トレースで + → 既存をリンク…を使って ADCS への satisfied by を追加します。モデルチェックをもう一度実行します。

2.5 のスコアが以前より高くなり、Requirement.8 に 2.1 が表示されなくなれば完了です。

よくある質問

  1. 品質チェックは何を確認し、モデルチェックは何を確認しますか?
  2. 自動の品質スコアが 78% を超えないのはなぜですか?
  3. 移行の直後に要求と部品をつなげるのはなぜですか?

解答

6.1 移行の計画

  1. 正しいクラス、ラベル、属性、関係に入ったデータは、トレース、品質チェック、レポートですぐに使えます。インポート後に修正すると、多数の項目を手作業で編集することになります。
  2. インポートの前に 設定 → スキーマ で属性を追加するか、マッピングの手順でその列を「新しい属性(スキーマに追加)」にマッピングします。
  3. ⌘Z / Ctrl+Z を 1 回押します。インポートページからのインポートは、元に戻す操作の 1 単位です。
  4. プロジェクト全体を、別の新しいプロジェクトとして復元するときです。インポートページは、ファイルの項目を開いているプロジェクトに統合します。

6.2 Excel と CSV からの要求

  1. マッピングされていれば親行の ID 列または親番号の列から、そうでなければアウトライン番号から再構築します。1.2 は 1 の下に入ります。親がない場合は、存在する最も近い祖先が使われます。
  2. スキーマが知らない名前を含む Class 列は、警告とともに「クラスのない行のクラス」に置き換えられます。スキーマエディターのクラス名を使ってください。
  3. ID 列付きでエクスポートし、ファイルを編集して、ID 列をグローバル ID にマッピングし「既存の項目の照合基準」をグローバル ID に設定してインポートします。確認の手順で、それらが「更新された項目」に表示されます。

6.3 Word と ReqIF からの要求

  1. Word の見出しスタイルの段落は Statement(セクション)になります。shall、must、will、should を含む段落は Requirement になり、動詞の後の最初の語から命名されます。プレーンな太字テキストで入力された見出しは、通常のテキストとして読み取られます。
  2. ReqIF は各要求の識別子、階層、属性、関係を保持します。サプライヤーが新しいファイルを送ってきたとき、それをインポートするとコピーが追加されるのではなく、同じ項目が更新されます。
  3. traced to として取り込まれます。スキーマが 2 つのクラス間で traced to を許可していない場合、その関係は警告とともにスキップされます。

6.4 他のツールのモデル

  1. Cameo/MagicDraw、Enterprise Architect、Rhapsody、Papyrus の SysML 1.x プロファイル付き XMI 2.x(ツールからエクスポートします)、Cameo または MagicDraw の .mdzip プロジェクト(直接)、Papyrus の .uml ファイルです。要求だけなら ReqIF、テーブルなら Excel または CSV でも取り込めます。
  2. 他のツールのダイアグラムのレイアウトはインポートされませんが、関係はインポートされます。Holarch は、その関係から Asset 図、階層図などのダイアグラムを描きます。
  3. インポートされた各項目は XMI ID を保持し、XMI ファイルでは「一致する既存のエンティティ」の既定が XMI ID になるため、次回のインポートでそれらの項目が更新されます。すでにある関係は重複して追加されません。

6.5 インポート後の整理

  1. 品質チェックは、各要求の記述を良い要求の性質と照らしてスコアを付けます。モデルチェックはモデル全体を見て、何も満たしていない要求、孤立した項目、誰も実行していないアクションなどのギャップを探します。
  2. Correct と Feasible には人の判断が必要なため、チェックはそれらを満たしたとはしません。要求を確認した後に自分で設定します。
  3. それらは別々のファイルから、互いのリンクなしで取り込まれます。satisfied by のリンクは、それ以降トレーサビリティ、カバレッジ、モデルチェックに反映されます。

発行:Holarch