要求
他のプロジェクトへのリンク
項目を別のプロジェクトの要求、機能、テストにトレースします。リンクされた項目は、そのプロジェクトを開ける人にだけ表示されます。
このページの内容
概要
他のプロジェクトへのリンクは、このプロジェクトの項目から別のプロジェクトの項目へのトレース関係です。たとえば、システム仕様の要求から traced from されたサブシステム要求や、別のチームが管理する要求を verifies するテスト手順です。
リンクはこのプロジェクトの一部です。保存されるのは 2 つの項目の ID と関係だけです。リンク先の項目の番号、名前、クラス、ステータスは、表示するたびに、あなた自身のアクセス権でその項目のプロジェクトから読み取られます。
- 相手のプロジェクトを開ける場合は、項目が表示され、クリックしてその項目に移動できます。
- 開けない場合は、開けないプロジェクト内の項目と表示されます。名前は、アプリでも、エクスポートでも、API や AI ツールを通じても、あなたに届くことはありません。
他のプロジェクトへのリンクは Team プランの機能です。プロジェクトのオーナーのプランで決まります。他のプランでは既存のリンクは表示されたままで除去もできますが、新しいリンクは追加できません。Hybrid Car と Hybrid Car Battery Pack のデモプロジェクト間のリンクは、どのプランでも動作します。
概念
リンクが保持するもの
| 構成要素 | 意味 |
|---|---|
| 出所 | このプロジェクトの項目 |
| 関係 | このプロジェクトのスキーマの関係。たとえば traced from、satisfies、verified by |
| 目標 | プロジェクトの ID と、その中の項目の ID |
関係はソースのクラスに対してチェックされます。リンクは相手のプロジェクトの内容を読まないため、リンクを作成するときにターゲットのクラスはチェックされません。ターゲットのクラスが関係に合わない場合は、トレースセクションに ⚠ と「この関係は通常 … を指しません」が表示されます。
誰に何が表示されるか
各ユーザーには、リンク先の各項目が、その項目のプロジェクトでのロールに応じて表示されます。
| 相手のプロジェクトへのアクセス | 表示される内容 |
|---|---|
| 任意のロール(オーナー、編集者、レビュー担当者、閲覧者) | 番号、名前、プロジェクト、項目を開くリンク |
| なし、またはプロジェクトがもう存在しない | 開けないプロジェクト内の項目 |
存在しないプロジェクトと開けないプロジェクトは同じように表示されるため、リンクからプロジェクトの存在がわかることはありません。
リンクの状態
| 表示 | 意味 | すること |
|---|---|---|
| 番号と名前 | 項目が存在し、そのプロジェクトを開ける | なし |
| <project> で削除済み | 項目がそのプロジェクトのゴミ箱にある | そのプロジェクトを編集できる人に復元を依頼するか、リンクを除去します |
| 削除日時 | 項目がもう存在しない | リンクを除去します(切れたリンクを除去) |
| 開けないプロジェクト内の項目 | プロジェクトへのアクセス権がないか、プロジェクトがもう存在しない | 必要であれば、プロジェクトのオーナーにアクセス権を依頼します |
| 読み込み中… | 項目を読み取っている | しばらく待ちます |
名前は、ページにリンクが表示されたとき、1 分以上たってからタブに戻ったとき、そして 5 分ごとに読み取られます。名前が変更された項目は、このプロジェクトを変更しなくても新しい名前で表示されます。
変更されたターゲット
リンクの作成後または最後のレビュー後に、リンク先の項目がそのプロジェクトで編集されると、行に変更済みと表示されます。ポインターを合わせると日付が表示されます。リンクがまだ成り立つことを確認してから、次のようにします。
- 行の ✓ をクリックして、そのリンクをレビュー済みにします。
- 他のプロジェクトの横の ⋯ をクリックし、すべてをレビュー済みにする (n) をクリックすると、項目のフラグ付きリンクがすべてレビュー済みになります。
- または ニーズと要求 → 確認するリンクを開きます。カード他のプロジェクトで変更には、プロジェクトのフラグ付きリンクがすべて表示され、行ごとの ✓ とすべてをレビュー済みにするがあります。
レビュー済みにする操作は項目の履歴とアクティビティに表示され、1 回の元に戻すで取り消せます。レビュー担当者と閲覧者にはフラグが見えますが、クリアはできません。ライブラリのリリースへのリンクにはフラグが付きません(リリースは変更されないため)。
使い方
使う場面と理由
1 つのモデルでは大きすぎる場合や、異なるチームが所有する場合に、他のプロジェクトへのリンクを使います。たとえば、システム仕様とそのサブシステム仕様、プロダクトラインの共有要求と各製品、顧客の要求と自社の設計などです。リンクは下位レベルのプロジェクトに置き、上を指すようにします。各サブシステムは、自身の要求をシステム要求からトレースします。
1 つのプロジェクト内では通常の関係を使います。トレースセクションの既存をリンク…は同じプロジェクトの項目同士を関連付けます。他のプロジェクトへのリンクは、別の場所にある項目のためのものです。
リンクを追加する
- 項目を選択します(たとえばサブシステム要求)。
- インスペクターでトレースセクションを開きます。他のプロジェクトの下で +(別のプロジェクトへのリンクを追加…)をクリックします。
- traced from などの関係を選択します。
- プロジェクトを選択します。その項目が番号順に表示されます。
- ライブラリの場合はバージョンを選択します:現在 (作業コピー)、または Release 1.1 などのリリースです。リリースへのリンクには現在の代わりにそのラベルが表示され、名前からページは開きません。
- 検索に入力して、番号または名前で項目を探します。クラスを選択すると、そのクラスだけが表示されます。
- 項目をクリックしてから、リンクを追加をクリックします。トーストに「リンクを追加しました。」と表示され、項目が他のプロジェクトの下に表示されます。
1 回の元に戻すでリンクを除去できます。同じリンクをもう一度追加しても、既存のリンクがそのまま残ります。
リンク先の項目を開く
リンク先の項目の名前をクリックします。その項目のプロジェクトが、その項目の位置で開きます。
リンクを除去する
- リンクの行の × をクリックすると、リンクが 1 つ除去されます。
- 削除済みの項目を指すリンクがある場合は、他のプロジェクトの横の ⋯ をクリックし、切れたリンクを除去 (n) をクリックします。
リンクを除去しても、変わるのはこのプロジェクトだけです。リンクによって相手のプロジェクトが変更されることはありません。
実例:ペイロードサブシステムと CubeSat EO-1 デモ
- EO-1 Payload という名前のプロジェクトを作成し、要求 PL.1 Detector pixel pitch shall be at most 5.5 µm を追加します。
- PL.1 を選択し、トレース → 他のプロジェクト → + を開きます。
- traced from、プロジェクト CubeSat EO-1 を選択し、ground sample を検索して 1.2 Ground Sample Distance をクリックします。リンクを追加をクリックします。
- 行には traced from 1.2 Ground Sample Distance CubeSat EO-1 · 現在 と表示されます。EO-1 Payload しか開けない同僚には、同じ行に開けないプロジェクト内の項目と表示されます。
ヒントとよい進め方
- 下位レベルから上位レベルへリンクします。そうすれば、サブシステムを追加してもシステムのプロジェクトを変更する必要がありません。
- 上位レベルのプロジェクトを、下位レベルのプロジェクトで作業する人と閲覧者として共有すると、その人たちにも名前が表示されます。
- 上位レベルのプロジェクトを再編成した後は、切れたリンクを除去 を実行します。
よくある間違い
| 問題 | 原因 | 対処 |
|---|---|---|
| 「この項目はこのプロジェクト内にあります。代わりに「既存をリンク…」を使用してください。」 | ターゲットが同じプロジェクト内にある | 関係のグループで既存をリンク…を使います |
| 他のプロジェクトの下に + がない | プロジェクトを閲覧しかできないか、項目がロックされている | 編集者のロールを依頼するか、項目のロックを解除します |
| 「他のプロジェクトの項目へのリンクは Team プランの機能です。」 | プロジェクトのオーナーが Team プランではない | アカウント設定 → プランと請求でアップグレードします |
| ピッカーに「このプロジェクトは読み取れません。別のプロジェクトを選択してください。」と表示される | そのプロジェクトへのアクセス権を失った | そのオーナーにアクセス権を依頼します |
他の機能との関係
- トレーサビリティマトリックス:選択した関係による行からのリンクは、グリッドの下の他のプロジェクトに一覧表示されます。エクスポート…でそれらも出力されます(トレーサビリティを参照)。
- Spider 図:リンク先の項目は、その項目の周りに破線のボックスで表示されます。オプション → 他のプロジェクトでオフにできます。
- プログラムマップ:プロジェクトを管理 → プログラムマップには、すべてのプロジェクトのリンク状況が表示されます。他のプロジェクト ⋯ → プログラムマップで表示では、この項目を他のプロジェクトを通じてトレースします(プログラムマップを参照)。
- プログラムカバレッジ:リンク先のプロジェクトでは、検証 → プログラムカバレッジにこれらのリンクが項目別、プロジェクト別に一覧表示されます(プログラムカバレッジを参照)。
- 履歴とアクティビティ:リンクの追加と除去は項目に記録されます。
- ゴミ箱:項目を削除すると、そのリンクも一緒にゴミ箱に移動します。項目を復元するとリンクも復元されます。
- 変更要求:変更を追加 ▾ → 別のプロジェクトへのリンクを追加…と別のプロジェクトへのリンクを除去…でリンクをステージします。リンクは要求が適用されたときに追加または除去されます。
- ライブラリ:バージョンの選択で、ライブラリのリリースの項目にリンクします(ライブラリを参照)。
エクスポートとレポート
エクスポートでは、リンク先の項目がエクスポートする人のアクセス権で名前付けされます。その人が読めないものは「別のプロジェクトの項目」と書き出されます。
| エクスポート | 他のプロジェクトへのリンクの扱い |
|---|---|
| プロジェクト JSON(データベースのエクスポート) | 保存されたまま(ID のみ)。ファイルをインポートしてもそのまま残ります |
| ReqIF(データベースとドキュメント) | リンクされた各項目の External links 属性:関係、プロジェクト ID、項目 ID。読み取れる場合は番号と名前も |
| XMI | 含まれません。エクスポートレポートでは「別のプロジェクトへのリンク」として件数が数えられます |
| トレーサビリティマトリックス(Excel) | 別シートOther projects |
| トレーサビリティマトリックス(CSV) | Other projects 列 |
| 要求トレーサビリティマトリックス(RTM)レポート | Other Projects 列 |
API と MCP
API と MCP はリンクを ID で返します。名前を読むには resolve 操作を呼び出します。この操作はトークン自身のアクセス権とプロジェクト一覧を使います。プログラムマップと項目のトレースは、GET /api/v1/program-map、GET /api/v1/projects/<project>/items/<item>/trace、MCP ツール program_map と trace_chain で利用できます。API と MCP を参照してください。
アプリ内の AI 機能が受け取るのは、リンクの ID だけです。
メッセージ
| メッセージ | 意味 |
|---|---|
| リンクを追加しました。 | リンクが保存された |
| この項目はこのプロジェクト内にあります。代わりに「既存をリンク…」を使用してください。 | 選択した項目が同じプロジェクト内にある |
| 項目を選択してから、リンクを追加してください。 | 項目を選択せずにリンクを追加をクリックした |
| リンクできる他のプロジェクトがありません。先に別のプロジェクトを作成するか開いてください。 | このプロジェクトしかない |
| 他のプロジェクトの項目へのリンクは Team プランの機能です。 | プロジェクトのオーナーが Team プランではない |
| 1 つのプロジェクトが持てる他のプロジェクトへのリンクは最大 20,000 件です。先にいくつか除去してください。 | プロジェクトが上限に達した |
制限事項
| 制限 | 値 |
|---|---|
| プロジェクトあたりのリンク数 | 20,000 |
| リクエストごとに読み取る項目数 | 500 |
| ピッカーに表示される項目数 | 検索ごとに 100 件(他の項目を見るには検索を絞り込みます) |
リンクは、相手のプロジェクトの現在のバージョン、またはライブラリのリリース内の項目のコピーを指します(ライブラリを参照)。