要求
プログラムマップ
プロジェクト同士がどのようにリンクしているかを、プロジェクトの組ごとのリンク数とともに確認し、1 つの項目のリンクの連鎖を他のプロジェクトまでたどります。
このページの内容
概要
複数のプロジェクト(システムプロジェクト、サブシステムプロジェクト、テストプロジェクト、ライブラリ)にまたがるプログラムは、他のプロジェクトへのリンクで結び付けられます。各リンクはそれを作成したプロジェクトに保存されるため、どのプロジェクトも全体像を示しません。それを示すのがプログラムマップです。開けるプロジェクトごとに 1 つのボックスを、プロジェクトのペアごとに 1 本の矢印を描き、矢印には関係とリンク数のラベルを付けます。
このページには 2 つのビューがあります。
- プロジェクト:開けるすべてのプロジェクトとその間のリンクを、グラフまたは表で表示します。
- 項目のトレース:1 つの項目を中央に置き、他のプロジェクトでその項目にリンクしている項目を、輪ごとに最大 6 ステップ先まで表示します。
プログラムマップは、サインインしているすべてのユーザーが利用できます。リンク自体は Team プランで作成します。オーナーのプランにリンク機能が含まれていないプロジェクトに保存されたリンクは灰色で描かれます。Hybrid Car と Hybrid Car Battery Pack のデモプロジェクト間のリンクは、どのプランでも動作します。
概念
マップに表示されるもの
| 要素 | 意味 |
|---|---|
| ボックス | 開けるプロジェクト:その名前、プロジェクトの種類、項目数。アクセシブルネームには、保持するリンクと受け取るリンクも加わります |
| 矢印 | 矢印の根元のプロジェクトに保存され、矢印の先のプロジェクトの項目を指すリンク |
| 矢印のラベル | 関係 · リンク数 · 削除済み。たとえば traced from · 12 · 1 deleted |
| 開けないプロジェクト(N 件のリンク) | 開けないプロジェクトへのすべてのリンクを数える 1 つの破線ボックス |
| ライブラリのリリースのボックス | 読み取れるライブラリのリリースで、あなたのプロジェクトからリンクされているもの |
矢印は通常、上を向きます。サブシステムプロジェクトはシステムプロジェクトへの traced from と satisfies のリンクを保存し、テストプロジェクトは verifies のリンクを保存します。マップは、リンクを保持するプロジェクトを、それが指すプロジェクトの下に配置します。
誰に何が表示されるか
マップは、あなたが開けるプロジェクトだけから作られます。つまり、任意のロールでメンバーになっていて、ゴミ箱になく、組織の 2 段階サインインのルールを満たしているプロジェクトです。
- 開けないプロジェクトへのリンクは、開けないプロジェクト (N 件のリンク) に数えられます。このボックスがプロジェクトや項目の名前を示すことはなく、プロジェクトが存在する場合も、ゴミ箱にある場合も、一度も存在しなかった場合も同じように表示されます。
- 開けないプロジェクトに保存されたリンクは、あなたのプロジェクトを指していても、どこにも数えられません。
- 組織の管理者であっても何も追加されません。マップはプロジェクトのメンバーシップを使います。
- エクスポート(CSV、SVG、PNG)には、ページに表示されている内容がそのまま含まれます。
色
| 色 | 意味 |
|---|---|
| 青い矢印 | 開けるプロジェクト間のリンク |
| 琥珀色の矢印 | ターゲットの一部が削除されている(ゴミ箱にあるか、存在しない) |
| 灰色の矢印 | 開けないプロジェクトへのリンク、ライブラリのリリースへのリンク、またはオーナーのプランに他のプロジェクトへのリンクが含まれないプロジェクトに保存されたリンク |
使い方
プロジェクトのリンク状況を見る
- プロジェクトを管理をクリックし、プログラムマップをクリックします。リンクを保持または受け取るすべてのプロジェクトを含むプロジェクトビューが開きます。
- 矢印を読みます。ボックスにポインターを合わせると、それに接続されていないものはすべて薄く表示されます。
- 矢印をクリックします。インスペクターにそのリンクが 100 件ずつ表示されます:各リンクを保持する項目、関係、ターゲットの項目です。どちらかの項目をクリックするとそのプロジェクトで開き、さらに表示で次の 100 件が表示されます。
- インスペクターのCSV をエクスポートをクリックするとその矢印のリンクを保存でき、バーのエクスポート ▾をクリックするとマップ全体を CSV、SVG、PNG で保存できます。
1 つのプロジェクトから始める
- プロジェクトを開き、検証 → プログラムカバレッジを開いて、プログラムマップを開くをクリックします。
- マップには、そのプロジェクトと、直接または他のプロジェクトを介してリンクしているプロジェクトだけが表示されます。
- すべてのプロジェクトを表示をクリックすると、開けるものがすべて表示されます。
ボックスをクリックしてリンクされたプロジェクトのみ表示を選ぶこともできます。
1 つの項目をプログラム全体でトレースする
- 項目を選択します。インスペクターのトレースセクションで 他のプロジェクト ⋯ を開き、プログラムマップで表示を選びます。矢印のリンク一覧からは、代わりにこの項目をトレースをクリックします。
- 項目のトレースビューでは、項目が中央に、その項目にリンクしている項目が輪状に表示されます。最初の輪は 1 ステップ先、2 番目の輪は 2 ステップ先です。リンクは双方向にたどられます。
- ステップ(1~6、既定値 3)を選んで、遠くまで広げるか近くにとどめます。
- 項目はプロジェクトごとに色分けされ、各プロジェクトの項目は破線のボックスで囲まれます。プロジェクトでグループ化をオフにするとボックスが消えます。
- 項目をクリックすると項目を開くとここからトレースが表示されます。後者はその項目を中央に置きます。
実例:CubeSat EO-1 デモとペイロードプロジェクト
- CubeSat EO-1 デモを作成し、次に 2 つ目のプロジェクト EO-1 Payload を要求 PL.1 Imager resolution 付きで作成します。
- EO-1 Payload で PL.1 を選択します。トレース → 他のプロジェクトで + をクリックし、traced from、CubeSat のプロジェクトとその撮像の要求を選んで、リンクを追加をクリックします。
- 3 つ目のプロジェクト EO-1 Test Campaign をテストケース TC.4 Resolution test 付きで作成し、verifies で EO-1 Payload の PL.1 にリンクします。
- プロジェクトを管理 → プログラムマップを開きます。マップの下に EO-1 Test Campaign、その上に EO-1 Payload、最上部に CubeSat のプロジェクトが表示され、矢印 verifies · 1 と traced from · 1 が描かれます。
- PL.1 → トレース ⋯ → プログラムマップで表示をクリックします。テストケースと CubeSat の要求が、両側の 1 ステップ先に配置されます。
実例:Hybrid Car とそのバッテリーパック
- プロジェクトを管理で、プロジェクトファイル ▾ → 新しいデモプロジェクト → Hybrid Car (SysML v2) をクリックします。
- 続いて プロジェクトファイル ▾ → 新しいデモプロジェクト → Hybrid Car Battery Pack (SysML v2) を作成します。バッテリーサプライヤーのパック要求 PackCapacity、PackMass、ChargeAcceptance は、最新の Hybrid Car デモにある車の要求 VR-3、VR-6、VR-5 に traced from でリンクされます。2 つのどちらを先に作成してもかまいません。Hybrid Car デモをもう一度作成すると、リンクは新しいデモに移ります。これらのデモのリンクはどのプランでも動作します。Hybrid Car のプロジェクトがない場合、パックのデモにはリンクがありません。
- プロジェクトを管理 → プログラムマップを開きます。マップには 2 つの SysML v2 プロジェクトと矢印 traced from · 3 が表示されます。
ヒントとよい進め方
- サブプロジェクトが使う関係(要求には traced from または satisfies、テストには verifies)を取り決めておくと、どこでも矢印が同じように読めます。
- 関係をグループ化をオフにすると、関係ごとに 1 本の矢印が表示されます。たとえば、同じ 2 つのプロジェクト間の要求のリンクとテストのリンクを区別するときに使います。
- ボックスをドラッグしてマップを配置します。位置は、スコープごとにこのブラウザーに保存されます。
- 表ビューを使うと、プロジェクトのペアをリンク数や削除済みターゲットの数で並べ替えられます。
- 琥珀色の矢印は、修復が必要なリンクを意味します。リンク一覧を開き、項目のトレース → 他のプロジェクトでリンクを修正または除去します。
よくある間違い
| 問題 | 原因 | 対処 |
|---|---|---|
| プロジェクトが表示されない | そのメンバーではないか、ゴミ箱にあるか、リンクがない | オーナーにアクセス権を依頼します。リンクのないプロジェクトを表示するにはリンクされていないプロジェクトを表示にチェックを入れます |
| すべてが開けないプロジェクトに入る | リンクが、あなたがメンバーではないプロジェクトを指している | プロジェクトのオーナーにアクセス権を依頼します |
| マップの中央に灰色の矢印がある | リンクを保持するプロジェクトのオーナーが Team プランではない | オーナーがアカウント設定 → プランと請求でアップグレードします |
| 新しいリンクがまだ表示されない | マップが最近の変更をまだ読み取っている | 1 分後に更新をクリックします |
他の機能との関係
- 他のプロジェクトへのリンク:マップはリンクを読み取るだけで、何も追加や変更はしません。リンクは項目のトレース → 他のプロジェクトで作成します(他のプロジェクトへのリンクを参照)。
- プログラムカバレッジ:1 つのプロジェクトへのリンクを、不足とともに項目ごとに表示するビューです(プログラムカバレッジを参照)。そこにあるプログラムマップを開くは、そのプロジェクトからマップを開始します。
- ライブラリ:ライブラリのリリースの項目へのリンクは、リリースのボックスへの矢印として表示されます(ライブラリを参照)。
- Spider 図:プロジェクト内のトレースを、別の場所にあるリンク先の項目を破線のボックスで示して表示します。項目のトレースも同じ輪状のレイアウトを使います。
- API と MCP:ツール向けの同じマップとトレースです(API と MCP を参照)。
プログラムマップのページ
バー
| コントロール | 機能 |
|---|---|
| プロジェクト / 項目のトレース | ビューを切り替えます |
| 範囲 | 自分のすべてのプロジェクト、1 つの組織(所属している場合)、またはサブフォルダーを含む 1 つのフォルダー(フォルダーがある場合。プロジェクトフォルダーを参照) |
| すべてのプロジェクトを表示 | プロジェクトからマップを開いた後に表示されます。そのプロジェクトのリンク先の集合から離れます |
| リンクされていないプロジェクトを表示 | リンクのないプロジェクトも表示します |
| 関係をグループ化 | プロジェクトのペアごとに 1 本の矢印(ラベルに各関係を列挙)、または関係ごとに 1 本の矢印 |
| ステップ | 項目のトレース:1~6 ステップ先 |
| プロジェクトでグループ化 | 項目のトレース:各プロジェクトの項目を囲む破線のボックス |
| グラフ / 表 | ダイアグラム、または並べ替え可能な表。狭い画面では表が先に開きます |
| 更新 | リンクを再度読み取ります |
| エクスポート ▾ | CSV をエクスポート、SVG をエクスポート、PNG をエクスポート |
グラフ
- ボックスをクリックすると、そのプロジェクトがインスペクターに表示されます:プロジェクトを開くとリンクされたプロジェクトのみ表示。ボックスをダブルクリックするか、ボックス上で Shift+Enter を押すと、プロジェクトが開きます。
- 矢印をクリックすると、そのリンクがインスペクターに一覧表示されます。
- ボックスをドラッグして移動します。スクロールまたはピンチでズームし、背景をドラッグしてパンします。
- Tab を押してマップに移動し、矢印キーでボックスと矢印の間を移動します。Enter でインスペクターに移ります。各ボックスと矢印には、スクリーンリーダーが読み上げる名前があります。たとえば「EO-1 Payload、LML プロジェクト、出力リンク 1、入力リンク 1」です。
表
| ビュー | 列 |
|---|---|
| プロジェクト | ソースプロジェクト、関係、ターゲットプロジェクト、リンク、削除済み |
| 項目のトレース | プロジェクト、番号、名前、クラス、項目からのステップ数、状態 |
列見出しをクリックすると並べ替えられます。
インスペクター
| 選択 | 内容 |
|---|---|
| プロジェクトのボックス | 名前、種類、項目数、出力リンクと入力リンク。プロジェクトを開く、リンクされたプロジェクトのみ表示 |
| 矢印 | ソースとターゲットのプロジェクト、関係ごとのリンク数、リンク一覧(100 件ずつ、さらに表示)、CSV をエクスポート、行ごとのこの項目をトレース |
| 項目(項目のトレース) | 番号と名前、クラス、プロジェクト、トレースした項目からのステップ数、状態。項目を開く、ここからトレース |
| 開けないプロジェクト | 「開けないプロジェクトへのリンク。プロジェクトのオーナーにアクセス権を依頼してください。」 |
API と MCP
REST API と MCP は、トークン自身のアクセス権とプロジェクト一覧を使って同じ結果を返します。API アクセスをオフにした組織のプロジェクトは、開けないプロジェクトと同じく除外されます。
| 呼び出し | 戻り値 |
|---|---|
GET /api/v1/program-map | プロジェクト、リリース、矢印(from、to、relation、links、deleted、plan)、非表示の件数。from、unlinked、org はページと同じ |
GET /api/v1/projects/<project>/items/<item>/trace | 項目のトレース:プロジェクト、番号、名前、クラス、ステップ数を持つノード、ノード間のリンク、非表示の件数。steps は 1~6(既定値 3) |
MCP program_map | GET /program-map と同じ |
MCP trace_chain | トレースの呼び出しと同じ。規制対象データの区分表示があるプロジェクトの項目は withheld を返します |
API と MCP を参照してください。
メッセージ
| メッセージ | 意味 |
|---|---|
| プロジェクト間にリンクがありません。項目のトレースセクションから追加してください。 | どのプロジェクトも、あなたに見えるリンクを保持も受け取りもしていない |
| このプロジェクトには他のプロジェクトへのリンクがありません。項目のトレースセクションから追加してください。 | リンクのないプロジェクトからマップを開いた |
| この項目には他のプロジェクトへのリンクがありません。トレースセクションから追加してください。 | トレースした項目にリンクがない |
| 一部のプロジェクトをまだ読み取っています。1 分後に更新してください。 | 大きなプロジェクトの最近の変更をまだ読み取っている。マップには準備のできたものが表示される |
| 最初の 500 項目を表示しています。ステップ数を減らしてください。 | 項目のトレースが上限に達した |
| オーナーのプランに他のプロジェクトへのリンクが含まれないプロジェクトからの N 件のリンクはたどられません。 | 項目のトレースが、リンク機能のないプランで保存されたリンクを飛ばした |
| プログラムマップを読み取れませんでした。ページを再読み込みしてください。 | リクエストが失敗した |
制限事項
| 制限 | 値 |
|---|---|
| 項目のトレースのステップ数 | 1~6 |
| 項目のトレース内の項目数 | 500 |
| 矢印のリンク一覧で 1 ページに表示されるリンク数 | 100 |
| プロジェクトあたりのリンク数 | 20,000(他のプロジェクトへのリンクを参照) |