Holarch

管理とレビュー

プロダクトラインと構成

フィーチャーと構成を使って 1 つのプロジェクトで複数の製品をモデル化し、Applies To と適用性でどの項目がどの製品に適用されるかを指定し、モデルを 1 つの構成として表示・編集し、構成ごとにドキュメント、RVTM、ベースラインを生成します。

使い方 →

このページの内容
  1. 概要
  2. 概念
    1. 機能
    2. 構成
    3. 判定
    4. 完全性
    5. ステージごとの完全性
    6. 構成のリリース
    7. 変更要求によるリリース
    8. リリースされた定義
    9. 適用対象と適用性
    10. 共有される同一性と構成の値
    11. 150 % ビュー
  3. 使い方
    1. 使う場面と理由
    2. プロダクトラインを開始する
    3. 構成を作成する
    4. どの項目がどの製品に属するかを指定する
    5. 1 つの構成を表示・編集する
    6. 構成に独自の値を与える
    7. 1 つの構成の仕様書を生成する
    8. 実例:CubeSat EO-1 のデモ
    9. ヒントとよい進め方
    10. よくある間違い
    11. 他の機能との関係
  4. プロダクトラインページ
    1. ページヘッダー
    2. 機能
    3. 構成
    4. 空の状態
    5. キーボード
    6. スクリーンリーダー
  5. 適用対象
    1. フィールド
    2. 選択… ダイアログ
    3. 適用対象の式
    4. 式のメッセージ
  6. 構成として表示
    1. メニュー
    2. バナー
    3. 各ページに表示されるもの
    4. スクリーンリーダー
  7. 構成ビューでの編集
    1. 項目を作成・変更する
    2. 除去と削除
    3. 既存の項目を追加する
    4. ビューで使えないもの
    5. リリース済みと廃止済みの構成は値を保持する
    6. 元に戻すと履歴
    7. 他の人との共同作業
  8. 構成の値
    1. 異なる値にできるフィールド
    2. 構成ビューで
    3. すべての構成で
  9. 適用性
    1. フィールド
    2. シリアル番号または日付で表示する
    3. 適用性のメッセージ
    4. 項目のリビジョン
  10. ドキュメント、RVTM、検証
    1. 1 つの構成のドキュメントをエクスポートする
    2. ドキュメントのアウトライン
    3. RVTM
    4. テストセンター
    5. ダイアグラムとトレードスタディ
  11. ベースラインと変更要求
    1. 構成ごとのベースライン
    2. 変更要求
  12. モデルチェック
  13. 検索、インポート、エクスポート
  14. REST API と MCP
  15. プラン
  16. SysML v2 プロジェクト
  17. 制限事項
  18. 関連ページ

概要

プロダクトラインは、1 つの設計の大部分を共有する製品のファミリーです。共有する設計を一度だけモデル化し、製品ごとに異なる箇所に印を付け、各製品を構成として定義します。そうすれば、どのページでもモデルを 1 つの構成として表示でき、共有する設計への変更はすべての製品に反映されます。

プロダクトラインは次の場所で扱います:

  • 管理とレビュー → プロダクトライン:フィーチャー、そのルール、それらから作られる構成。
  • インスペクターのプロダクトライングループ:選択した項目の適用対象と適用性。
  • トップバーの View as ▾:モデルを 1 つの構成として表示・編集します。
  • ドキュメント、RVTM、テストセンター、ベースラインとバージョン、変更要求:構成ごとの出力と管理。

プロダクトラインは Individual プランと Team プランに含まれます。構成ごとのベースライン、構成のオーナー、変更要求が影響する構成は Team プランに含まれます。プランを参照してください。

概念

機能

フィーチャーは、製品によって異なる選択肢です(例:「X-band Downlink」や「Propulsion」)。フィーチャーはツリーを形成し、親フィーチャーが関連する選択肢をまとめます。

各フィーチャーには次のものがあります:

  • 種類:Mandatory(親を持つすべての構成がこれも持つ)または任意(構成ごとに選ぶ)。新しいフィーチャーは任意です。
  • 子:子フィーチャーに対するルール。Any number(自由に選ぶ)、Choose one(構成ごとにちょうど 1 つの子)、Choose at least one(1 つ以上)。新しいフィーチャーは Any number です。
  • ルール:フィーチャーは別のフィーチャーを requires(必要とする)か、excludes(除外する)ことができます。除外は双方向に働きます。
  • 制約:そのフィーチャーを選択するすべての構成で成り立つ必要がある任意のルール。適用対象と同じように書きます。

構成

構成は 1 つの製品、つまりフィーチャーの選択です。各構成には次のものがあります:

  • 番号と名前(例:CFG-2 EO-1 Lite)。
  • Status:下書き、リリース済み、Retired。新しい構成は下書きで、リリース済みの構成のコピー(複製、コピーと貼り付け、開いているプロジェクトへのインポート)も下書きです。コピーには独自のリリース記録がありません。廃止された構成は表示できますが、編集はできません。構成は構成をリリース…でリリースします(構成のリリースを参照)。
  • ステージ(任意):構成がいるライフサイクルのステージ(Preliminary design や CDR など)。ステージによって、適用される完全性のルールが決まります。
  • Owner(任意、Team プラン):構成を変更する変更要求を承認する必要がある人またはチーム。
  • 適用性(任意):その構成に従って製造されたユニットのシリアル番号または製造日。

構成の有効な選択は、チェックを入れたフィーチャーだけではありません:

  • 選択したフィーチャー
  • ルートまでのその親フィーチャー
  • 選択した各フィーチャーの Mandatory の子
  • ツリーのルートにある Mandatory のフィーチャー

判定

Holarch は、すべての構成をフィーチャーのルールに照らしてチェックし、判定を表示します:

  • 有効:選択はすべてのルールに従っています。
  • Breaks: …:ルールに違反しています。例:「Breaks: Encrypted Downlink requires X-band Downlink.」
  • Incomplete: …:選択が欠けています。例:「Incomplete: choose a Downlink (choose one).」

複数のルールが成り立たない場合、判定は次の順で最初のものを示します:選択された別のフィーチャーが除外する Mandatory のフィーチャー、選択がないか 2 つ以上ある Choose one のグループ、選択がない Choose at least one のグループ、満たされない requires、違反した excludes、偽の制約。

完全性

有効の判定が対象とするのは、フィーチャーのルールだけです。完全性は、構成に含まれる項目をチェックします:

  • そこに含まれるすべての末端の要求が、そこに含まれる項目(その構成に適用されるテストケース)で検証されている
  • そこに含まれるすべての接続(Conduit)の両端がそこに含まれ、独自の適用対象を持つすべての関係の両端が、それが適用される構成に含まれる
  • そこに含まれるすべての項目の親がそこに含まれる

各構成には完了または不備の数(「3 gaps」など)が表示されます。廃止された構成はチェックされません。完全性は適用性を無視します。項目は、構成に適用されるときにその構成に属します。

ステージごとの完全性

構成のステージによって、チェックの範囲が決まります。各ステージは 5 つのレベルのいずれかを使います:

レベル既定のステージチェック
1コンセプトすべての項目の親が構成に含まれる。
2Preliminary designレベル 1 に加え、すべての接続の両端がそこに含まれ、すべての末端の要求がそこに含まれる項目で満たされている。
3詳細設計レベル 2 に加え、すべての末端の要求がそこに含まれる項目で検証されている。
4テストレベル 3 に加え、検証するすべてのテストケースに、手順(説明またはテストステップ)とこの構成の結果がある。
5生産レベル 4 に加え、検証するすべてのテストケースがこの構成で Passed で、その項目にリンクされた未解決の課題がない。

SE プロセスがある場合、ステージの一覧には代わりにそのレビューゲート(SRR、PDR、CDR、TRR など)が並び、それぞれにレベルがあります:SRR は 1、PDR は 2、CDR は 3、TRR は 4、生産と運用のレビューは 5 です。ステージがない場合、完全性は上の完全性のルール(検証された要求、接続の端、親)を使います。

ステージのレベルを変更するには、プロダクトラインページの ⋯ → 設定…を開き、ステージでレベルを選びます。1 回の元に戻すで変更を取り消せます。

完全性の行には、モデルの完全性と検証が別々に表示されます(例:「Complete at CDR · 12/40 verified」)。前半はステージのチェック、後半はこの構成で Passed の結果を持つ要求です。検証は、レベル 3 以上とステージがない場合に表示されます。

構成のリリース

構成は構成をリリース…でリリースします。プロダクトラインページで構成の列の ⋯ を開くか、⌘K / Ctrl+K を押して「Release」と入力します。インスペクターまたはデータベースで Status をリリース済みに設定しても、同じダイアログが開きます。

ダイアログには次のものが表示されます:

  • ステージ:リリースの対象となるステージ。そのステージについて完全性がチェックされます。
  • フィーチャールールとリビジョン:ルールに違反する構成、または 2 つのリビジョンが同時に有効になっている構成はリリースできません:「CFG-2 cannot be Released. Breaks: Wallbox requires Large pack. Change its selection on the Product Line page first.」
  • ステージでの完全性と不備を表示、検証(そこで検証されている要求の数)。
  • 未対応の高リスク:完全性レベル 5(Production)のステージでのみ表示されます。構成内のリスクとハザードのうち、高いレベル(設定されている場合は残存レベル)で未対応のものです(例:「Risk RSK-1 Battery fire: High, Open」)。これは警告で、リリースを妨げず、理由も必要ありません。Risk は、Status が Open で Opportunity でない間は数えられます。Hazard は Accepted または Closed になるまで数えられます。
  • Release condition:構成が完了していない間だけ表示されます。理由(10~2,000 文字)と承認者。両方が入力されるまでリリースは無効のままです。

リリースをクリックします。構成の Status がリリース済みになり、Holarch はリリース記録を保持します:ステージ、リリース時の完全性と検証、受け入れた不備、理由と承認者、リリースされた定義(下記参照)。1 回の元に戻すで、リリースとその記録の両方を取り消せます。

完全性と検証は、リリース時にブラウザーで Holarch が計算したとおりに記録されます。Holarch オンラインは、リリースされた定義がその SHA-256 ダイジェストと一致することを確認し、一致しないファイルのリリースを拒否します。完全性の再チェックはまだ行いません。

承認者:

  • デスクトップアプリ:承認者の名前を入力します。名前として入力されたとおりに記録されます。このコピーの Holarch にはアカウントがありません。
  • Holarch オンライン、Individual プラン:自分のリリースを自分で承認します。サーバーがアカウントと時刻を記録します。
  • Holarch オンライン、Team プラン:構成の Owner が承認します。Owner がいない場合はプロジェクトのオーナーが承認します。完了していないリリースは、承認者がそれに対して構成をリリース…を開き、リリースを承認をクリックするまで(Holarch はパスワードを求めます)、承認待ちのまま待機します。自分の申請を自分で承認できるのは、プロジェクトが自己承認を許可している場合(変更要求 → 設定)だけです。完了したリリースには承認は不要です。

サーバーは、リリース記録を伴わない Status のリリース済みへの変更を拒否します。そのため、API クライアントや古いページがダイアログを省略することはできません。また、リリース記録を除去または変更するプロジェクトの保存も、プロジェクトのオーナーからであっても拒否します。

リリースを取り下げ…(列の ⋯、または Status を下書きか Retired に戻す)では理由を尋ねられます。リリース記録は残り、そのログに取り下げが記録されます。リリース記録が削除されることはありません。もう一度リリースするとリリース 2 になります。

リリースを記録…(列の ⋯)は、リリース記録ができる前にリリース済みになった構成に対して表示されます。構成の現在の状態を、そのリリースとして「recorded later」の印付きで記録します。

  • 複数の構成の Status を一度に設定すると(データベース → 属性…)、ルールに違反するもの(下書きのまま残ります)の名前が示され、その他のそれぞれについて構成をリリース…が順に開きます。
  • リリースの取り下げは、変更要求ではなくライブのモデルで行います。変更要求を通じて構成をリリースするには、リリースをステージングします(変更要求によるリリースを参照)。構成の Status をリリース済みに設定するだけの変更要求は、適用されてもその構成をリリースしません。構成は Status を保ち、変更要求の残りが適用されます。
  • AI または MCP の提案では構成をリリースできません。そのレビューには「Needs a release record」と表示され、構成をリリース…が示されます。提案を適用すると、その他の変更が適用されます。

SysML v2 プロジェクトの構成のリリースは、まだ使えません。

変更要求によるリリース

リリースは変更要求の一部にできるため、変更を承認する委員会がリリースも承認します。変更要求で作業している(または開いている)間に、リリースをステージングします:

  • 変更要求で 変更を追加 ▾ → 構成をリリース…を選び、構成を選びます。
  • プロダクトラインページで、構成の列の ⋯ → Release with CR-12…。
  • インスペクターまたはデータベースで、Status をリリース済みに設定します。

ダイアログは同じで、タイトルは「Release CFG-2 with CR-12」です。変更要求が適用された後のモデルに対して、選んだステージでの完全性をチェックし、レベル 5 では未対応の高リスクを一覧表示します。また、ステージの結果が前回のリリースより低い場合や、次のステージで不備が残る場合に警告します。構成が完了していない間は理由を入力します。承認者の代わりに、申請の承認者が承認します。Add to CR-12 をクリックします。リリースは 1 つの変更(「Release CFG-2 at CDR」)としてステージングされ、構成はそれまで下書きのままです(列の Status のチップには「Release staged in CR-12」と表示されます)。構成は申請の影響を受けるものとして数えられるため、承認ルールが適用される場合は、その Owner の承認が必要です。

承認された申請が適用されると、Holarch は構成をリリースし、ステージングしたとおりのステージ、理由、受け入れた不備と、申請の承認者、via CR-12 を含むリリース記録を保持します。1 回の元に戻すで、適用した要求とリリースの両方を取り消せます。適用時に、構成が削除または廃止されている、すでにリリース済みであるか承認待ちである、フィーチャーのルールに違反している、申請が受け入れていない不備がある場合、Holarch は構成をリリースしません。申請の残りは適用され、申請のログと結果にその理由が示されます。問題を修正してから、もう一度リリースをステージングします。

Holarch オンラインは、承認を申請の投票(サーバーからのアカウントと時刻)から記録し、ページで入力された名前からは記録しません。申請によって承認された完了していないリリースには、別途リリースを承認は必要ありません。申請のリリースを記録できるのは、承認チェックから 1 時間以内に申請を適用した人だけです。プロジェクトの保存や API クライアントが、変更要求を通じてリリースを追加することはできません。

リリースされた定義

各リリース記録は、リリースされたとおりの構成を保持します:その項目と関係とその値、選択、使ったライブラリのフィーチャーと構成、リリース時に読み取った他のプロジェクトのリンク済み項目、検証結果。これは SHA-256 ダイジェスト付きの圧縮ファイルとしてプロジェクトに保存されます。

ベースラインとバージョンのリリースカードには、すべてのリリースが、その構成、ステージ、完全性、承認者、日付、状態とともに一覧表示されます。その ⋯ メニューには次のものがあります:

  • リリースされた定義を開く:リリースされた項目を、リリース時の値(例:構成独自の Mass)とともに読み取り専用で表示します。
  • Verify:記録がそのダイジェストと一致すること(完全であること)を確認し、記録自身の入力から構成を再構築します(厳密に再現):そのスナップショット、固定したライブラリのフィーチャーと構成、解決に使ったスキーマ。後からの編集、新しいライブラリのリリース、変更されたリンク済み項目、名前を変えたクラス、属性、関係は、結果を変えません。
  • 今日と比較:構成が現在表示している内容をリリースと比較します。別のリリースに移ったライブラリ(リリースのラベルで示されます)と、その後に変更されたリンク済み項目も含みます。
  • エクスポート(JSON):定義付きの記録。
  • 取り下げ…

適用対象と適用性

どの項目や関係にも、それがどの製品に属するかを示す 2 つのフィールドがあります:

  • 適用対象は、その項目を含む構成を示します。F-4 and not F-5 のような、フィーチャーと構成の式です。空の場合はすべての構成です。
  • 適用性は、項目がどのユニットまたは日付から有効かを示します:1-20, 25, 40- のようなシリアル番号、日付の範囲、またはその両方。空の場合は常に有効です。

2 つは独立しており、組み合わせて使います。項目がビューに含まれるのは、構成に適用され、かつビューのシリアル番号または日付で有効な場合です。

共有される同一性と構成の値

項目は、どの構成でも 1 つの項目です。その名前、Number、クラス、ラベル、担当者はどこでも同じで、階層内の位置、ドキュメントの順序、ダイアグラムのレイアウトも同じです。

その説明と属性値は異なる値にできます。構成の値とは、1 つの構成に対する項目独自の値です。たとえば、他の構成が 3 GB のままのところ、EO-1 Lite では Daily Data Volume が 1 GB である場合です。独自の値のない構成は、項目の基本値を使います。

150 % ビュー

すべての構成(構成を選んでいない状態)は、プロダクトライン全体を表示します:すべての製品のすべての項目と基本値。構成によって異なるフィールドには 異なるの印が付きます。番号の振り直し、ベースラインの復元、すべてからの項目の削除は、このビューで行います。

使い方

使う場面と理由

複数の製品が要求、機能、アーキテクチャの大部分を共有する場合にプロダクトラインを使います:フライトユニットとより軽量な派生型、輸出版、顧客オプション、ブロックアップグレードなどです。1 つのモデルで共有部分をそろえて保ちます。各構成には、それぞれ独自の仕様書、RVTM、ベースラインがあります。

作業のよい順序:

  1. 共有する設計を通常どおりモデル化します。
  2. 製品によって異なる点を、ルールとともにフィーチャーとして一覧にします。
  3. 製品ごとに 1 つの構成を追加し、それぞれが有効であることを確認します。
  4. 一部の製品だけが持つ項目には適用対象で、異なる値には構成の値で印を付けます。
  5. ドキュメントを生成し、各構成を検証します。

製品の違いが製造日やシリアル番号だけの場合は、1 つの構成(例:「Production」)を作成し、適用性だけを使います。

プロダクトラインを開始する

  1. ⌘K / Ctrl+K を押してプロダクトラインを開始…を選ぶと、ページと新しいフィーチャーのダイアログが開きます。または、データベースで + 新しい項目を使ってフィーチャーまたは構成の項目を作成します。ナビゲーションレールに管理とレビュー → プロダクトラインが、すべての項目のインスペクターにプロダクトライングループが表示されます。
  2. プロダクトラインページで + 新しいフィーチャーをクリックし、フィーチャーの名前(例:「Downlink」)を入力します。Enter を押します。名前が保存され、新しい兄弟の行が始まります。
  3. 次のフィーチャーの名前を入力します。上の行の子にするには ⌥⇧→ / Alt+Shift+→ を押します。⌥⇧← / Alt+Shift+← で元に戻します。
  4. インスペクターで各フィーチャーの種類と子を設定します(その行で Enter を押します)。
  5. 行の ⋯ メニューからルールを追加します:requires と excludes にはルール…、制約には制約…。

プロダクトラインページ、インスペクターのグループ、適用対象の列は、プロジェクトに最初の Feature または Configuration ができるまで非表示です。最後の 1 つを削除すると再び非表示になります。ただし、適用対象または適用性の値をまだ持つ項目では表示されます。

構成を作成する

  1. プロダクトラインページで + 新しい構成をクリックします。名前(例:「EO-1 Lite」)を入力します。構成に新しい列が表示されます。
  2. この製品が持つフィーチャーにチェックを入れます。Choose one のグループでは、セルはラジオボタンです。1 つを選ぶと他が置き換わります。暗黙の印が付いたセルは、別のフィーチャー(親または Mandatory の子)によって含まれており、変更できません。
  3. 列の下にある判定の行を読みます。有効と表示されるまで選択を修正します。
  4. 完全性の行を読みます。不備の数をポイントすると不備が表示されます。
  5. すべての構成を一度にチェックするには、構成をチェックをクリックします。

既存の製品から始めるには、構成の列見出しの ⋯ メニューを開き、複製を選びます。コピーは同じ選択と同じ構成の値を持ちます。

どの項目がどの製品に属するかを指定する

  1. 要求などの項目を選択し、インスペクターのプロダクトライングループを開きます。
  2. 適用対象に、F-4 のようなフィーチャーまたは構成の番号を入力します。↓ と Enter で候補の一覧から選びます。フィールドの下の行には、たとえば「Applies to 1 of 2 configurations: CFG-1」と表示されます。
  3. and、or、not とかっこで項を組み合わせます:F-3 and not F-5。
  4. または選択…をクリックし、一覧から構成またはフィーチャーを選びます。

すべての製品が持つ項目では、適用対象を空のままにします。ほとんどの項目は空のままです。

1 つの構成を表示・編集する

  1. トップバーの View as ▾ をクリックし、構成を選びます。バナーが表示されます:「Viewing configuration CFG-2 EO-1 Lite. New items apply to CFG-2 only; changed values become CFG-2's.」これで、どのページにも CFG-2 の項目だけが、CFG-2 の値で表示されます。
  2. 通常どおり作業します。新しい項目は CFG-2 に適用されます。他の構成もその項目を持つ場合、変更した説明や属性は CFG-2 独自の値になります。
  3. すべての構成を再び表示するには、バナーの Leave をクリックします。

この選択はブラウザーのタブごとです。他の人や他のタブは、それぞれのビューを保ちます。すべてのルールについては構成ビューでの編集を参照してください。

構成に独自の値を与える

  1. View as ▾ で構成を選びます。
  2. 項目を選択し、インスペクターで属性を変更します。編集中、フィールドの下のヒントには、たとえば「CFG-2 のみに保存しました。Other configurations keep 3 GB.」と表示されます。変更後、フィールドに CFG-2 value のチップが表示されます。
  3. 違いを元に戻すには、チップのメニューを開き、基本値を使用を選びます。

1 つの構成の仕様書を生成する

  1. ドキュメントを開き、納品 ▾をクリックして、Specification (Word) などの Word テンプレートを選びます。Word にエクスポートダイアログが表示されます。
  2. 構成を製品に、適用性を Any unit、シリアル番号、日付のいずれかに設定します。
  3. ドキュメントをエクスポートします。ドキュメントは、適用されないセクションを除き、残りを表示どおりに番号付けし、タイトルページ、フッター、ファイル名に構成の名前を示します。

実例:CubeSat EO-1 のデモ

CubeSat EO-1 のデモプロジェクトには 2 つの製品があります:X バンドのダウンリンクと暗号化を持つ EO-1 Flight と、S バンドのダウンリンクを持つ EO-1 Lite です。プロジェクトの管理でプロジェクトファイル ▾ → 新しいデモプロジェクトを使ってデモを作成します。

  1. 管理とレビュー → プロダクトラインを開きます。フィーチャー Downlink(Mandatory、Choose one)と S-band Downlink と X-band Downlink、Encrypted Downlink(任意、X-band Downlink が必要)、Propulsion(任意、X-band Downlink が必要)が表示されます。
  2. 構成 CFG-1 EO-1 Flight(X バンドと Encrypted Downlink、シリアル番号 1~2)と CFG-2 EO-1 Lite(S バンド、シリアル番号 3 以降)を見ます。どちらの判定も有効です。
  3. CFG-2 の列で Encrypted Downlink にチェックを入れます。判定が「Breaks: Encrypted Downlink requires X-band Downlink.」に変わります。⌘Z / Ctrl+Z を押します。
  4. 要求 4.4 Downlink Encryption を開きます。その適用対象は Encrypted Downlink のフィーチャー(F-4)なので、EO-1 Flight にだけ含まれます。1.5.2 S-band Transmitter、そのインターフェース IF-08 と IF-12、5.1 S-band Downlink Rate は F-2 に適用されます。1.5.3 X-band Payload Radio、そのインターフェース IF-08.1 と IF-12.1、5.5 X-band Downlink Rate とそのテストケース TC-21 X-band Link Test は F-3 に適用されます。
  5. View as ▾ → CFG-2 EO-1 Lite を選び、要求 5.4 Daily Data Volume を開きます。その説明は「at least 1 GB」で、CFG-2 value のチップが付いています。EO-1 Flight では基本のテキスト「at least 3 GB」のままです。
  6. テストケース TC-11 UHF Command Test を開きます。構成ごとに 1 つの結果を持ちます:EO-1 Flight では Passed、EO-1 Lite では In Progress です。
  7. 1.3.2 Battery Pack を開き、その Characteristic Thermostat Heater Power(2 W、適用性 SN 1)と Software-Controlled Heater Power(3 W、SN 2 以降)を見ます。ヒーターは 2 機目の宇宙機から変更されました。
  8. 管理とレビュー → ベースラインとバージョンを開きます。EO-1 Flight PDR は CFG-1 のベースラインです(Team プラン)。
  9. すべての構成で検証 → モデルチェックを開きます。プロダクトラインのルールが、Propulsion がどの構成でも選択されていないことを警告します(ProductLine.4)。デモでは、このチェックの例として意図的に未選択のままにしています。

ヒントとよい進め方

  • フィーチャーはドキュメントではなく製品について定めます:「Section 5 option」ではなく「X-band Downlink」とします。
  • 適用対象ではフィーチャーの項を使います。X バンドのダウンリンクを持つ 3 つ目の製品を追加しても F-3 は正しいままですが、CFG-1 はそうではありません。
  • 長い式を書く代わりに、関連する多数のオプションを親フィーチャーの下にまとめます。
  • 構成の値は、本当に異なる値だけに与えます。それ以外はすべて共有のままにします。
  • 管理下にある構成にはリリース済みを、もう製造しない製品には Retired を使います。
  • あるシリアル番号からの部品の変更は、それぞれ独自の適用性を持つ新旧 2 つの項目としてモデル化します。

よくある間違い

  • 編集後に項目がビューから消える。その適用対象または適用性に、もうその構成が含まれていません。トーストに項目の名前が表示されます。元に戻すをクリックするか、すべての構成で見つけます。
  • 構成が Incomplete のままになる。Choose one または Choose at least one のグループに選択がありません。そのグループの子にチェックを入れます。
  • 項目がどの構成にも含まれない。その適用対象が、どの構成も選択していないフィーチャーを指定しています。モデルチェックがそれを報告します(ProductLine.2)。
  • 移動がすべての製品を変える。構造は共有されています。構成ビューで項目を移動または並べ替えると、すべての構成で移動します。

他の機能との関係

  • ドキュメント:構成とシリアル番号または日付ごとに生成します。
  • RVTM とテストセンター:構成ごとに結果を記録します。「verified」は、その製品について検証済みであることを意味します。
  • モデルチェック:プロダクトラインのルールセットが、式、判定、適用性、リビジョン(supersedes)をチェックします。
  • ベースラインとバージョン(Team):1 つの構成のベースラインを作成し、構成を比較します。
  • 変更要求(Team):申請がどの構成を変更するかを確認します。オーナーが承認します。
  • 検索:appliesto:CFG-2 と varies:yes で、構成によって項目を見つけます。
  • REST API と MCP:モデルを 1 つの構成として読み取ります。

プロダクトラインページ

管理とレビュー → プロダクトラインには、左側にフィーチャー、右側に構成が表示されます。幅が 1,100 px 未満では、2 つの領域が縦に並びます。

コントロール機能
+ 新しいフィーチャー次の番号(F-1、F-2、…)のフィーチャーを、ツリーの最後に追加します。
構成をチェックすべての構成を、有効またはその最初の問題と、完了またはその不備とともに一覧表示します。
+ 新しい構成次の番号(CFG-1、CFG-2、…)の構成の列を追加します。
⋯CSV をエクスポート(構成ごとのフィーチャー。Selected または Implied と判定付き)とヘルプ。

機能

フィーチャー(番号と名前)、種類、子、使用元(そのフィーチャーを適用対象で指定している項目の数)の列を持つツリーグリッド。ルールは行内の小さなタグ(「requires F-3」など)として表示されます。

フィーチャーの種類と子はインスペクターで設定します。行で Enter を押すと、そこで開きます。

行の ⋯ メニュー:

  • 子フィーチャーを追加…
  • 名前を変更(F2)
  • ルール…:必要と除外のチェックリスト
  • 制約…:そのフィーチャーが選択されたときに成り立つ必要がある、適用対象の式
  • 使用している項目を表示
  • 削除…

構成

フィーチャーごとに 1 行(ツリーの順)、構成ごとに 1 列のグリッド。各列の見出しには、番号、名前、Status、Team プランではオーナーが表示されます。

セル:

  • 自由に選ぶフィーチャーにはチェックボックス。
  • Choose one のフィーチャーの子にはラジオボタン。
  • 別のフィーチャーによって含まれるフィーチャーには暗黙の印。ツールチップにその理由が示されます(例:「Included because F-1 is selected.」)。

下部の判定の行には、有効または最初の問題(フィーチャーのルール)が表示されます。その下の完全性の行には、完了または不備の数が表示され、ツールチップにそれらが一覧表示されます(完全性を参照)。

列見出しの ⋯ メニュー:

  • この構成として表示
  • 名前を変更…
  • 適用性…
  • オーナー…(Team):インスペクターで構成を開きます。
  • Baseline CFG-2…(Team):この構成のベースラインを保存します(構成ごとのベースラインを参照)。
  • 複製:選択とすべての構成の値を、コピーします。1 回の元に戻すですべて取り消せます。コピーは「<name> (copy)」という名前の下書きです。
  • 廃止、または廃止された構成では下書きに戻す。廃止された構成のビューは読み取り専用です。
  • 削除…:構成をゴミ箱に移動します。項目はその値を保持するため、復元で元どおりに戻せます。

空の状態

  • フィーチャーがない場合:「No features yet. Add the first feature: a choice that differs between products.」
  • 構成がない場合:「No configurations yet. A configuration is one product: a selection of features.」

キーボード

キー場所動作
Tabページヘッダーの操作と 2 つのグリッドの間を移動します。字下げは行いません。
Home / End機能最初または最後の行。
↑ / ↓機能前または次の行。
← / →機能折りたたむまたは展開する。
Enter機能名前の入力中:名前を保存し、下に新しい兄弟を始めます。選択した行では:インスペクターでフィーチャーを開きます。
F2機能その場でフィーチャーの名前を変更します。Esc を押すか名前を空のままにすると、何も追加されません。
⌥ / Alt+↑ / ⌥ / Alt+↓機能兄弟の間でフィーチャーを上下に移動します(2 つのフィーチャーの番号が入れ替わります)。
⌥⇧→ / Alt+Shift+→ / ⌥⇧← / Alt+Shift+←機能ドキュメントのアウトラインと同じく、フィーチャーを字下げまたは字上げします。
Delete機能確認の後にフィーチャーを削除します。
矢印キー構成セルからセルへ移動します。
Space構成セルにチェックを入れるか外します。
Enter構成列見出しでは:そのメニューを開きます。
Home / End構成最初または最後の列。

スクリーンリーダー

フィーチャーは「フィーチャー」という名前のツリーグリッドです。構成は「フィーチャー別の構成」という名前のグリッドで、各セルはたとえば「F-3 X-band Downlink in CFG-1 EO-1 Flight: selected」と読み上げられます。変更は読み上げられます:「X-band Downlink selected for CFG-1.」、「CFG-2 breaks a rule: Encrypted Downlink requires X-band Downlink.」、「CFG-2 is valid.」

適用対象

適用対象は、項目を含む構成を示します。インスペクターのプロダクトライングループ(属性グループの後)、項目ビュー、データベースの列にあります。まだできないこと:関係パネルで関係の適用対象を編集すること。

フィールド

  • 適用対象:式。空の場合は「すべての構成」と表示されます。
  • 選択…:入力する代わりに、一覧から構成またはフィーチャーを選びます。
  • その下のプレビューの行:「Applies to 2 of 4 configurations: CFG-1, CFG-3」または「Applies to every configuration」。
  • 構成ビューで項目が追加または除去された場合は、Removed from CFG-2 や Added to CFG-4 のようなチップ。チップの ✕ をクリックするとクリアされ、その構成について項目は再び適用対象に従います。
  • 式が削除されたフィーチャーまたは構成(古い番号で表示されます)を指定している場合の警告。

Feature と Configuration の項目には適用対象はありません。

データベースでは、いずれかの項目が適用対象を使うと適用対象の列が表示されます(▾ から非表示にし、列から元に戻せます)。セルをダブルクリックするか、Enter または F2 を押すと、同じフィールドで編集できます。

入力すると、一致するフィーチャーと構成、続いて演算子の一覧が開きます。↓/↑ で移動し、Enter または Tab で挿入し、Esc で一覧を閉じ、もう一度 Esc を押すとフィールドが元に戻ります。Enter で保存します。式が有効な場合は、フィールドを離れると保存されます。

選択… ダイアログ

Applies To — <item> には 3 つの選択肢があります:

  • すべての構成:式をクリアします。
  • これらの構成:構成にチェックを入れます。CFG-1 or CFG-3 と書き込まれます。
  • フィーチャー:フィーチャーにチェックを入れ、すべて(F-2 and F-5 と書き込まれます)または任意(F-2 or F-5 と書き込まれます)を選びます。

結果の式が下に表示されます。式として編集は、保存せずにそれをテキストフィールドに入れます。適用は、それを保存します。1 回の元に戻すですべて取り消せます。

適用対象の式

入力する内容意味
F-3 または "X-band Downlink"番号、または引用符で囲んだ名前で指定したフィーチャー。構成の有効な選択にそれが含まれる場合に真です。
CFG-2 または config "EO-1 Lite"構成。その構成についてだけ真です。
and, or, not, ( )項を組み合わせます。&、|、! も使え、単語として表示されます。not が最初に結合し、次に and、次に or です。
all, noneすべての構成、またはどの構成でもない。

大文字と小文字は区別されません。Holarch は式を項目の ID とともに保存するため、フィーチャーの名前を変えたり番号を振り直したりしても、式が壊れることはありません。式には番号が表示され、番号のない項目では引用符で囲んだ名前が表示されます。

削除されたまたは不明なフィーチャーは偽となり、モデルチェックがエラーとして報告します。

式のメッセージ

無効な式は保存されません。フィールドは入力したテキストを保持してエラーに印を付け、最後の有効な値が有効なままです。位置は 1 から数えた文字数です。

メッセージすること
No feature or configuration named “F-9”. Choose one from the list, or create the feature first.番号を確認するか、フィーチャーを作成します。
Expected a feature or configuration after “and” (character 12).演算子の後に項を追加します。
Expected a feature or configuration at character 1.項、not、( のいずれかで始めます。
Expected “and” or “or” before “F-5” (character 9).2 つの項を演算子で結びます。
Missing “)” for the “(” at character 5.かっこを閉じます。
“)” at character 9 has no matching “(”.余分なかっこを除去します。
Missing closing quote for the name at character 4.引用符で囲んだ名前を閉じます。
“Wallbox” matches 2 features (F-3, F-11). Use the number.2 つのフィーチャーが同じ名前を持っています。番号を入力します。
Applies To is too long. Use at most 200 features and configurations; group them with a parent feature instead.式を短くします。

構成として表示

View as ▾ は、モデル全体を 1 つの構成として表示します。プロジェクトに構成ができると、トップバーの保存状態の左に表示されます。

メニュー

  • すべての構成:プロダクトライン全体。
  • 構成ごとに 1 つの項目。その Status と、ルールに違反しているか不完全な場合は印が付きます。
  • 適用性 ▸:Any unit、シリアル番号…、日付…、シリアル番号と日付…。シリアル番号または日付で表示するを参照してください。
  • プロダクトラインを管理:プロダクトラインページを開きます。

メニューは Enter、Space、↓ で開きます。矢印キーで移動し、Enter で選び、Esc で閉じます。⌘K / Ctrl+K には、構成として表示…、すべての構成を表示、適用性を設定…、プロダクトラインに移動、新しいフィーチャー…、新しい構成…、ビュー内では Add Existing to CFG-2… があります。

バナー

構成を選んでいる間、トップバーの下にバナーが表示されます。たとえば「SN 23 時点の構成 CFG-2 EO-1 Lite を表示しています。New items apply to CFG-2 only; changed values become CFG-2's.」です。ビューに含まれる項目の数(「1,204 of 1,350 items」)が表示され、次のものがあります:

  • 変更 ▾:View as ▾ と同じメニュー。
  • Leave:すべての構成に戻ります。

変更要求でも作業している場合は、変更要求のバナーが先に、構成のバナーがその次に表示されます。

各ページに表示されるもの

  • 構成に適用されない項目と関係、またはビューの時点で有効でない項目と関係は除かれます。
  • 構成の値を持つ項目には、その値が表示されます。
  • 件数、集計、予算、シミュレーション、品質スコア、モデルチェックは、その構成について計算されます。
  • ドキュメントのアウトライン、生成されたドキュメント、RVTM は、項目を表示どおりに番号付けします。保存された番号は変わりません。エクスポートには「Numbering as shown in CFG-2.」と記されます。
  • 検索とクエリはビューに対して実行されます。

この選択はブラウザーのタブごとで、再読み込みしても保持されます。ビューの切り替えは編集ではないため、元に戻すの対象になりません。

スクリーンリーダー

ボタンの表示は「View as: CFG-2 EO-1 Lite」です。バナーは「構成ビュー」という名前の領域です。開始、終了、時点の変更は読み上げられます。たとえば「構成 CFG-2 EO-1 Lite を表示しています。1,350 件中 1,204 件の項目が適用されます。」や「すべての構成を表示しています。」です。

構成ビューでの編集

構成ビューでも、他の場所と同じように編集します。Holarch は各編集をプロダクトライン全体の変更に変換するため、他の構成はそれまでの内容を保ちます。各操作は 1 回の元に戻すで取り消せます。

項目を作成・変更する

操作結果
項目を作成する(+ 新規、ダイアグラム、ドキュメント、データベースの行、貼り付け、複製、テンプレート、インポート、適用した AI または MCP の提案など、方法は問いません)項目はこの構成にだけ適用されます。構成が 1 つしかない場合、適用対象は空のままです。
複製する、または Copy with Children各コピーはこの構成に適用され、表示されている値を基本値として受け取ります。
名前、Number、クラス、ラベルを変更するすべての構成についてそれらを変更します。フィールドには共有中のアイコンが表示され、変更はたとえば「すべての構成で名前を変更しました。」と読み上げられます。
他の構成も持つ項目の説明または属性を変更するこの構成独自の値として保存されます。基本値と同じ値にすると、独自の値は除去されます。廃止された構成も他の構成として数えられるため、その値は保たれます。
この構成だけが持つ項目の説明または属性を変更する基本値として保存されます。
適用対象または適用性を変更するすべての構成についてそれらを変更します。フィールドには共有中のアイコンが表示され、編集中のヒントには「CFG-2 だけでなく、すべての構成の適用対象を変更します。」と表示されます。項目がビューに含まれなくなると、ビューから外れます:「R-4.2 no longer applies to CFG-2.」と元に戻すが表示されます。
関係を追加するプロダクトラインに追加されます。その両端が別の構成でも一緒にある場合は、この構成に限定されます。
関係の属性を変更する項目の属性と同じです。
移動、並べ替え、字下げ、字上げ、親の変更を行うすべての構成について共有の構造を変更します:「すべての構成で移動しました。」
ダイアグラムのレイアウトを変更するすべての構成で共有されます。
テスト結果を記録する他の構成がそのテストケースを持たない場合も、この構成の結果として保存されます。スイートを実行には「Recording results for CFG-2.」と表示されます。
スキーマ、プロジェクトの設定、共有、ライブラリの購読を編集するすべての構成と同じく、共有されます。

除去と削除

操作結果
他の構成も持つ項目を削除する確認で、たとえば「R-4.2 を CFG-2 から除去しますか?CFG-1 と CFG-3 には残ります。」と尋ねられます。Remove from CFG-2 はこの構成からだけ外し、すべてから削除…はゴミ箱に削除します。
子を持つそのような項目を除去するAlso remove its 3 children from CFG-2(既定でオン)。オフにすると、子は構成に残り、1 つ上のレベルに表示されます。
この構成だけが持つ項目を削除する通常どおりゴミ箱に削除されます。
他の構成も持つ関係を除去するこの構成からだけ除去されます:「Removed the link from CFG-2. It stays in 2 other configurations.」
この構成だけが持つ関係を除去する通常どおり削除されます。
ダイアグラムから除去この構成について、項目とダイアグラムの関係を除去します。図形を一覧にするだけのダイアグラムでは、ダイアログに「Removes the shape from this diagram in every configuration.」と表示されます。
ゴミ箱から復元する項目をプロダクトラインに復元します。それが構成に適用されない場合:「R-4.2 を復元しました。CFG-2 には適用されません。」

編集によって選択中の項目がビューから外れると、フォーカスは同じ一覧の次の項目に移り、トーストに項目の移動先が表示されます。

既存の項目を追加する

ダイアグラム、ドキュメント、関係に既存の項目を追加するためのピッカーには、ビュー内の項目が一覧表示されます。構成に適用されない項目を取り込むには、⌘K / Ctrl+K またはバナーの変更 ▾メニューにある Add Existing to CFG-2… を使います:「Added Battery to CFG-2.」

ビューで使えないもの

  • 番号を振り直す…、ここから番号を振り直す…、子の番号を振り直す…:番号はすべての構成で共有されます。すべての構成で振り直します。
  • ベースラインを復元と Restore Earlier Version:「ベースラインを復元するには、構成ビューを終了してください。」
  • Retired の構成でのすべての編集:「CFG-1 は廃止されています。変更するにはコピーしてください。」リリース済みの構成は、構成管理でロックされない限り編集できます。

リリース済みと廃止済みの構成は値を保持する

他の場所での編集が、廃止された構成の表示を変えることはありません。リリース済みの構成を変えるのは、変更要求を通じた場合だけです。項目の基本値を変更すると(すべての構成で、これを基本値にするで、またはインポートや適用した AI または MCP の提案で)、その項目を持ち独自の値を持たない、廃止された各構成と、変更要求の外にあるリリース済みの各構成は、同じ変更の一部として古い値を独自の値として受け取ります。空だった基本値は保持されません。

ロックされた項目、ライブラリからマウントされた項目、管理下の項目は、構成の値についても通常のルールに従います。

元に戻すと履歴

  • 元に戻す操作はビューの切り替えをまたいで機能します。その単位が別のビューで行われた場合、トーストにそれが示されます:「CFG-2 で行われた変更を元に戻しました: Mass of Battery。」
  • 履歴には、そのビューで行われた各変更の横に「In CFG-2」と表示されます。

他の人との共同作業

異なる構成にいる 2 人が、互いの値や除去を上書きすることはありません。基本値の編集と構成の値が衝突することもありません。2 人が同じ構成の同じフィールドを変更した場合は、他のフィールドと同じく後の変更が優先されます。

表示中の構成を誰かが削除すると、タブはすべての構成に戻ります:「CFG-2 は削除されました。すべての構成を表示しています。」

構成の値

構成の値とは、1 つの構成に対する項目独自の説明または属性値です。

異なる値にできるフィールド

フィールド構成によって異なる値にできるか
説明、すべての属性、関係の属性はい
名前、Number、クラス、ラベル、担当者いいえ:項目を識別するもの
適用対象、適用性、Feature と Configuration の属性、selects、requires、excludesいいえ:構成を定義するもの
承認ワークフローのある属性(承認の対象となる Requirement の Status など)いいえ:承認記録は項目ごとに 1 つ
品質の結果、レビューのデータ、計算値いいえ:ビューごとに計算されるもの
ダイアグラムのレイアウトとドキュメントの設定いいえ

構成ビューで

  • この構成独自の値を持つフィールドには、CFG-2 value のチップが表示されます。そのメニュー:
    • 基本値を使用(3 GB):独自の値を除去します。
    • これを基本値にする:この値を基本値にします。他の構成の独自の値は残ります。
    • すべての構成の値…
  • 異なる値にならないフィールドには共有中のアイコンが表示されます(「すべての構成で共有されます。」)。
  • 他の構成も持つ項目のフィールドを編集している間、ヒントには「CFG-2 のみに保存しました。Other configurations keep 3 GB.」と表示されます。

すべての構成で

独自の値を持つフィールドには異なる(2)と表示されます。そのメニューにはすべての構成の値…と構成の値をクリアがあります。

異なる値にできるフィールドを編集している間、ヒントには変更が及ぶ構成が示されます。例:「Changes CFG-2 and CFG-3. CFG-1 (Released) keeps 1,400. CFG-4 keeps its own value.」

すべての構成の値…には、最初に基本値、次に各構成とその値と Source(「独自の値」または「base」)が一覧表示されます。行をその場で編集し、Enter を押して保存します。

データベースでは、独自の値を持つセルの角に印が付きます。履歴、変更の一覧、比較では、構成の値はたとえば「Mass (CFG-2)」、所属の変更は「In CFG-2」と示されます。

適用性

適用性は、項目、関係、構成がどのユニットまたは製造日から有効かを示します。適用性のフィールドは、プロジェクトに構成ができると表示されます。

フィールド

インスペクターのプロダクトライングループの適用対象の下と、構成の適用性…ダイアログ:

  • シリアル番号:1-20, 25, 40- のような一覧。40- は 40 以降を意味します。すべてのユニットが対象の場合は空のままにします。
  • 有効開始:適用される最初の製造日(YYYY-MM-DD)。
  • 終了(含まない):適用されなくなる最初の製造日。

フィールドの下の要約には、たとえば「In effect for SN 1–20 and 25, and SN 40 on.」と表示されます。他の場所のタグには「SN 1–20, 25, 40– · From 2027-03-01」と表示されます。シリアル番号と日付の両方を設定した場合は、両方が成り立つ必要があります。

シリアル番号は並べ替えて統合した形で保存されます。範囲は最大 200 個、番号は最大 1,000,000,000,000 です。まだできないこと:SN-0021 のような番号を入力するためのプロジェクトのシリアル接頭辞。

構成の適用性は、その構成に従って製造されたユニットを示します。その構成の項目を絞り込むものではありません。

シリアル番号または日付で表示する

  1. View as ▾ → 適用性 ▸ → シリアル番号…(または日付…、シリアル番号と日付…)を選ぶか、⌘K / Ctrl+K の適用性を設定…を使います。
  2. シリアル番号、製造日、またはその両方を入力します。バナーに時点が加わります:「SN 23 時点の構成 CFG-3 Block 2 を表示しています。」

シリアル番号と製造日を合わせると、1 つのユニットを表します:「SN 75 built 2027-06-15」。その場合、項目は、項目が設定している方のそれぞれで両方が成り立つときに表示されます。シリアル番号…はすでに選んだ日付を保ち、日付…はシリアル番号を保ちます。Any unit は両方をクリアします。ドキュメント(エクスポートのダイアログのシリアル番号と日付)、RVTM、API(effectivity=sn:75,date:2027-06-15)も同じ時点を受け付けます。

項目が持つものシリアル番号で表示日付で表示
シリアル番号のみ番号がその一覧にある場合に表示タグ付きで表示
日付のみタグ付きで表示日付がその範囲内にある場合に表示
両方番号がその一覧にある場合に表示日付がその範囲内にある場合に表示
どちらもなし表示表示

すべての構成でシリアル番号を選ぶと、そのシリアル番号を含む構成が選ばれます。複数ある場合は、メニューにそれらが一覧表示されます(「SN 23 は CFG-2 and CFG-3 にあります。1 つを選択してください。」)。時点が選んだ構成自身の適用性の外にある場合、バナーが警告します:「SN 23 is outside CFG-2's effectivity (SN 1–20).」

適用性のメッセージ

メッセージすること
“x” is not a serial number or range. Use numbers and ranges such as 1-20, 25, 40-.示された部分を修正します。
The range “20-1” goes backwards. Write the lower number first.番号を入れ替えます。
Use at most 200 serial ranges.範囲を統合します。
Serial numbers go up to 1000000000000.より小さい番号を使います。
“x” is not a date. Use YYYY-MM-DD.日付を修正します。
Effective Until must be after Effective From.どちらかの日付を変更します。
Write serial numbers as ranges such as 1-20, 25, 40-.フィールドの下に表示されます。範囲を修正します。
Until must be after From.フィールドの下に表示されます。どちらかの日付を変更します。
SN 12–30 overlaps CFG-3 (SN 21–40).構成に対する警告で、ブロックはしません:2 つの製品がシリアル番号を共有しています。

項目のリビジョン

あるシリアル番号または日付から部品が変わる場合は、新旧の部品をそれぞれ独自の適用性を持つ 2 つの項目としてモデル化し、新しい方を supersedes(逆方向は superseded by)で古い方に関係付けます。rev C supersedes rev B supersedes rev A のような連鎖により、それらは 1 つの位置のリビジョンになります。Holarch がリビジョンの間で選ぶことはありません。適用性が重なる箇所や、リビジョンのないユニットが残る箇所を報告します。

  • バナー:ビューの時点で 2 つのリビジョンがどちらも有効な場合、バナーが警告します:「Overlapping revisions: A-20 Cooling unit has 2 in effect at SN 75 (A-20A, A-20B).」
  • モデルチェック:2 つのリビジョンのそれぞれに対する Revisions in effect together(ProductLine.13)。共有するシリアル番号と日付が示されます。リビジョンが分解する項目(または最も古いリビジョン)に対する Units with no revision in effect(ProductLine.14)。最初と最後のリビジョンの間で、リビジョンのないユニットが示されます(例:「SN 1–49 from 2027-07-01」)。
  • リリースとベースライン:2 つのリビジョンが重なっている間は、構成をリリース済みに設定することも、ベースラインを作成することもできません:CFG-1 cannot be Released: A-20A and A-20B are both in effect for SN 50–99 from 2027-06-01 until 2027-07-01. どちらかのリビジョンの適用性を変更してから、リリースします。

重なりと空きは、両方のリビジョンが適用される各構成の中で、その構成自身の適用性の範囲内でチェックされます。

ドキュメント、RVTM、検証

1 つの構成のドキュメントをエクスポートする

少なくとも 1 つの構成があるプロジェクトでは、納品 ▾の Word テンプレート(Specification (Word) など)と ⌘K / Ctrl+K のドキュメントを Word にエクスポートは、まず短いWord にエクスポートダイアログを開きます。構成のないプロジェクトは、これまでどおり 1 回のクリックでエクスポートされます。

  • 構成:すべての構成、または 1 つの構成(「CFG-2 EO-1 Lite」)。廃止された構成は最後に「(Retired)」の印付きで一覧表示されます。選択は、タブが表示している構成で始まります。
  • 適用性:Any unit、シリアル番号(23 など。「SN 23」も使えます)、日付。ビューの時点で始まります。
  • 適用範囲を表示(すべての構成のみ、既定でオン):一部の構成にだけあるセクションの下に「適用対象: CFG-1, CFG-3」を追加します。廃止された構成は数えません。

すべてのエクスポート… → Document (Word) のプロダクトライングループにも同じ選択肢があります(ベースラインのエクスポートは除く)。

構成のドキュメントに含まれるもの:

  • 構成に適用され、選んだユニットまたは日付で有効なセクションだけが、構成独自の値で含まれます。
  • 除かれたセクションの下にあるセクションは、残っている最も近いセクションまで上がります。
  • ビューの番号:除かれた兄弟の後の項目は、同じ形式で番号が振り直されます(4 は 3 に、4.1 は 3.1 になります)。保存された番号は変わりません。ファイルのタイトルの下に「Numbering as shown in CFG-2.」と記されます。
  • タイトルページとフッターに:「Configuration CFG-2 EO-1 Lite · Serial number 23」(または「· Effective 2027-03-01」)。会社の Word テンプレートでは、フィールド {{Configuration}} でこれを配置できます。
  • ファイル名に構成の名前が入ります:「SRS – CFG-2 EO-1 Lite.docx」。
  • ユニットまたは日付を指定しない場合、適用性を持つセクションには、タイトルの下にそのタグ(「Effective SN 21 and later」など)が表示されます。

構成ビューで印刷したり PDF を保存したりすると、印刷されたフッターにも構成と時点が入ります。

ドキュメントのアウトライン

  • 構成ビューでは、アウトラインにビューの番号が表示されます。番号を振り直す…とここから番号を振り直す…は無効になります:「番号はすべての構成で共有されます。「すべての構成」で振り直してください。」ビュー内では、追加や移動の後の自動の振り直しはオフです。
  • プロジェクトが使い始めると、表示 ▾ → 列に適用対象と適用性の列が加わります。
  • ドキュメントの ReqIF エクスポートでは、適用対象と適用性を文字列属性として書き出します。ダイアログには「Applies To and effectivity are exported as string attributes. Configuration values are not exported.」と表示されます。

RVTM

  • 構成ビューでは:その構成の要求と結果が表示されるため、「verified」はその製品について検証済みであることを意味します。# 列にはビューの番号が表示されます。エクスポート ▾は、ファイル名(「RVTM – CFG-2 EO-1 Lite.csv」)と Word のタイトルに構成の名前を入れます。
  • すべての構成では:廃止されていない構成ごとに 1 つの集約されたステータスを持つ構成の列グループ。「—」は、その要求がその構成に含まれないことを意味します(ツールチップは「CFG-1 には適用されません」)。CSV と Excel のエクスポートでは、構成ごとに「CFG-1 のステータス」の列が 1 つ加わります(含まれない場合は「Does not apply」)。
  • 適用性の列:切り替えで、既定では非表示、タブごとに保持されます。
  • 数えられるのは構成自身の結果だけです。構成なしで記録された結果(構成ができる前、またはすべての構成で記録したもの)は、どの構成も検証しません。構成ではテストケースは未実行として表示され、要求のステータスには「コンフィギュレーションのない結果(TC-1)は CFG-2 に含まれません。」と表示されます。同じ注記が、構成の列のツールチップ、エクスポート、構成用に生成されたドキュメントにも入ります。構成を検証するには、その構成を表示した状態でもう一度テストを実行します。
  • シリアル番号では:ステータスは、表示中の構成でそのシリアル番号(供試体「23」、「SN 23」、「SN-0023」)について記録された最新の実行から得られ、「SN 23 の結果が最初に記録されました」という注記が付きます。そのような実行のないテストケースは、そのステータスを保ちます。エクスポートも同じステータスを使います。

テストセンター

  • 構成ビューでのスイートを実行には「Recording results for CFG-2.」と表示され、コンフィギュレーション / ビルドに「CFG-2 EO-1 Lite」が入力されます。シリアル番号では供試体も入力されます。結果はその構成の値として保存されるため、1 つのテストケースが構成ごとに 1 つの結果を持ちます。
  • ビューでの結果をインポート…にも同じ注記が表示され、同じフィールドが入力されます。
  • すべての構成では、スイートを実行と結果をインポート… で結果の記録先を尋ねられます。テストを実行した構成、または構成なし(どれも検証しない)を選びます。最初は何も選ばれておらず、選ぶまで結果は記録されません。構成の結果は、その構成のビューと同じく、その値として保存されます。選んだ構成に含まれないテストケースは記録されず、その理由が示されます。構成なしの結果は、すべての構成に対するテストケースの値として保存されます。構成ビューでは、それらはテストケースのステータスの下の注記として表示され、その結果としては表示されません。
  • 結果のファイルには構成列を含めることができます。行の値(構成の番号、名前、またはその両方)は、その行をその構成に記録します。どの構成も示さない値の行はスキップされ、ダイアログに一覧表示されます。
  • 結果を再利用…(テストケースのステータスの下):テストが実行されていない構成について、根拠を示せる場合(たとえば同じユニット設計がテストされた場合)に、別の構成の結果を数えます。再利用する結果(構成の結果、または構成のない結果)と、対象の構成(構成ビューでは表示中のもの、すべての構成では、テストケースが含まれ、独自の結果を持たない任意の構成)を選び、根拠(必須)を入力します。結果は、あなたの名前、日付、根拠とともに その構成にコピーされ、1 回の元に戻すですべて取り消せます(トースト「CFG-1 の結果を CFG-2 に再利用しました。」と元に戻す)。
  • 再利用された結果が黙って扱われることはありません。構成では、テストケースのステータスの下に再利用と「from CFG-1 by Ann Lee on 2026-10-28: same motor and cooler」が表示されます。構成の RVTM では、要求のステータスの下に「Result reused from CFG-1 (TC-1): …」と表示されます。すべての構成では、構成の列に「再利用」と表示されます(根拠はそのツールチップです)。構成用に生成されたエクスポートとドキュメントにも同じ注記が加わります。モデルチェックはそれを ProductLine.17 として一覧表示します。再利用を停止で取り消し(テストは再び Not Run と表示されます)、その構成でテストを実行すると、構成独自の結果に置き換わります。
  • テストケースの構成属性は、編集中に(インスペクター、項目ビュー、スイートを実行、結果をインポート)プロジェクトの構成を候補として示します。属性は自由入力のままなので、「Build 2.4.1」のようなビルドも引き続き使えます。

ダイアグラムとトレードスタディ

  • 適用範囲を表示(ダイアグラムのツールバー、LML プロジェクト、すべての構成):適用対象または適用性を持つ項目の図形に色を付け、その下に適用範囲(「Applies to F-4 · Effective SN 30 and later」など)を書きます。この設定はタブごとに保持され、構成ビューの中では使えません。
  • トレードスタディ → + コンフィギュレーションから…(代替案の下)は、プロダクトラインの構成を代替案として追加します。1 回の元に戻すですべて取り消せます。廃止された構成はチェックが外れた状態で始まります。トースト:「Added 2 alternatives.」

ベースラインと変更要求

これらは Team プランに含まれます。Team プランがない場合、コマンドは無効になり、「Baselines per configuration are part of the Team plan. The project owner's plan decides.」と表示されます。

構成ごとのベースライン

  1. 管理とレビュー → ベースラインとバージョンを開きます。
  2. 構成のベースラインを作成…をクリックします。構成を表示している間は、ボタンの表示が Baseline CFG-2… になり、選択が省略されます。
  3. 構成を選び、名前(最初は「CFG-2 baseline 1」)を入力します。ベースラインを保存をクリックします。トーストに「CFG-2 のベースラインを保存しました。」と表示されます。表の Document 列には、たとえば「Configuration CFG-2 EO-1 Lite」と表示されます。

ベースラインは、構成のラベルを付けてプロダクトライン全体を記録し、時点を指定して表示している場合はその適用性の時点も記録します。他のベースラインと同じく比較と復元ができます。まだできないこと:構成の判定、選択、承認のリリースされた定義の記録。

どのベースラインも、プロジェクトが他のプロジェクトから使ったものを記録します:使用中の各ライブラリのリリースと、他のプロジェクトの項目への各リンクと、その時点でのその項目の最後の変更です。フィーチャーが表示中のライブラリから来ている場合、比較 → 構成 ▾は、現在使用中のリリースではなく、ベースラインが記録したライブラリのリリースに対してベースラインを解決します。そのため、新しいリリースで構成から外れた項目は変更として表示されます。ライブラリのリリースを記録するようになる前に保存されたベースラインは、現在使用中のリリースに対して解決され、ページにその旨が表示されます。ベースラインを復元しても、プロジェクトが使うライブラリのリリースは変わりません。

比較には、プロダクトライン用に 2 つの選択肢があります:

  • 構成 ▾:1 つの構成が表示する内容を比較します。その構成の最新の 2 つのベースライン、または最新のベースラインと現在のモデルを選びます。
  • 比較対象 ▾:From のバージョン内で 2 つの構成を比較します。例:「What differs between CFG-2 and CFG-1 in EO-1 Flight PDR」。

構成ビューで作成したプロジェクトのベースラインも、プロダクトライン全体を記録します。

変更要求

  • 変更要求のページには構成カードがあります:「Changes items in 2 of 4 configurations: CFG-2, CFG-3」と構成別に表示(構成ごとの変更された項目)。独自の値を持つ構成については、基本値の変更は数えません。
  • 差分では、構成の値を「Mass (CFG-2)」、「Description (CFG-2)」、「In CFG-2」と示し、「適用対象」と「適用性」の変更を一覧表示します。
  • 承認者としてのオーナー:変更された構成の Owner がプロジェクトのメンバーを指定している場合、申請にはその人の承認も必要です。ルールの行には「CFG-2's owner (Lee) must approve: this request changes CFG-2.」と表示され、スクリーンリーダーでは「Approval needed from Lee for CFG-2」と読み上げられます。プロジェクトのメンバーを指定していないオーナーは、ルールを追加しません。
  • 構成管理:変更管理がオンのとき、リリース済みで最新のベースラインに含まれる構成は管理下に置かれます。項目に対するその独自の値は、変更要求を通じてのみ変更されます(「… released, in the latest baseline」)。
  • 管理下の項目の適用範囲:承認済みまたはベースラインに含まれる項目の適用対象、適用性、および構成ビューでその項目を構成に入れたり構成から外したりすることは、その他のフィールドと同じく、変更要求を通じてのみ変更されます。ソースが管理下にある関係についても同様です。ホスト型サービスでは、オフラインで行った変更もサーバーがチェックします。
  • ライブラリ:マウントしたライブラリリリースのフィーチャーと構成は、適用対象、構成、ビューで数に入ります。これらは読み取り専用です。

モデルチェック

プロジェクトに Feature または Configuration があると、検証 → モデルチェックで組み込みのルールセットプロダクトラインが実行されます。

ルールHeading重大度
ProductLine.1適用対象が存在しないフィーチャーまたは構成を指定しているエラー
ProductLine.2どの構成にも含まれない項目警告
ProductLine.3ルールに違反している、または不完全な構成エラー
ProductLine.4どの構成でも選択されていないフィーチャー警告
ProductLine.5親が含まれていない構成に含まれる項目警告
ProductLine.6両端が同じ構成に含まれることのない関係警告
ProductLine.7シリアル番号が重複している構成警告
ProductLine.8項目の構成の外にある適用性警告
ProductLine.9項目が含まれていない構成の値警告
ProductLine.10ある構成で検証されていない要求警告
ProductLine.11ある構成で一端が欠けている接続警告
ProductLine.13同時に有効なリビジョン警告
ProductLine.14有効なリビジョンのないユニット警告
ProductLine.15構成のないテスト結果警告
ProductLine.16その構成で検証されていない要求を持つリリース済みの構成エラー
ProductLine.17別の構成から再利用されたテスト結果警告

完全性のルールは、ビューを切り替えずに、すべての構成からすべての構成をチェックします。ProductLine.10 は、要求が検証されていない構成を「Not verified in CFG-2, CFG-3 (Released)」のように示します。ProductLine.11 は、構成と欠けている端を「In CFG-2: A-11 Coolant pump is not in the configuration」のように示します。ProductLine.3 は、リリース済みの構成には「Released configuration.」、下書きには「It cannot be Released until this is fixed.」と表示します。ProductLine.16 は、リリース済みの構成が検証していない要求を一覧表示します。

ProductLine.13 と 14 は、supersedes でリンクされたリビジョンをチェックします(項目のリビジョンを参照)。重複する 2 つのリビジョンのそれぞれに「Overlaps A-20B for SN 50–99 from 2027-06-01 until 2027-07-01」、それらが分解する項目に「No revision in effect for SN 1–49 from 2027-07-01」と表示されます。

ProductLine.15 は、構成なしで Status が記録されたテストケースを、その結果が数に入らない構成とともに「Passed without a configuration; does not count for CFG-2」のように一覧表示します。各構成を表示した状態でテストを再実行します。

ProductLine.17 は、結果を再利用…によって結果がある構成で数に入るテストケースを、その理由とともに「CFG-2: Reused from CFG-1 by Ann Lee on 2026-10-28: same motor and cooler」のように一覧表示します。理由をレビューするか、その構成を表示した状態でテストを実行して、再利用した結果を置き換えます。

ProductLine.9 では、修正 → 値を除去が「Mass (CFG-2): 1,520」のように値を一覧表示し、それらを除去します。1 回の元に戻すですべて取り消せます。

CubeSat EO-1 デモでは、フィーチャーPropulsionを意図的に未選択のままにしています。これは ProductLine.4 の例です。

検索、インポート、エクスポート

  • 検索とクエリ:appliesto:CFG-2 は CFG-2 に適用される項目を、varies:yes は構成値を持つ項目を検索します。
  • JSON:すべてのフィールドを保持します。
  • CSV:プロジェクトでプロダクトラインを使用すると、データベースのエクスポートは他の列の後に 4 つの列適用対象(入力するときと同じ形式)、シリアル番号による適用性、有効開始、有効終了を追加します。インポートは同じ列タイトルを読み取ります(マッピングの手順:プロダクトライングループ)。不明なフィーチャーや構成、不正なシリアル範囲、不正な日付はその行について報告され、そのフィールドは取り込まれません。
  • ReqIF:適用対象と適用性は文字列属性として出力されます。構成値はエクスポートされません。
  • インポートしたファイル内の無効な適用対象または適用性の値は取り込まれません。

REST API と MCP

  • list_configurations(MCP)と GET …/configurations(REST)は、フィーチャー、ルール、構成をその判定とともに一覧表示します。
  • 読み取りルートと MCP の読み取りツールは、configuration(番号、名前、または ID)と effectivity(sn:23 または date:2027-03-01)を受け取ります。応答はその構成のビューになります。これらを指定しない場合、項目は appliesTo、effectivity、および構成の values を持ちます。
  • まだ対応していません:API を通じたモデルチェックのプロダクトラインルール(ProductLine.1–9)(run_model_checks、GET …/model-checks)。検証 → モデルチェックで実行してください。
  • 書き込みは appliesTo と effectivity を受け取ります。configuration を指定すると、書き込みはその構成のビューで行ったのと同じように行われます。この方法で作成された AI クライアントの提案には「Apply in CFG-2: new items apply to CFG-2; changed values become CFG-2's.」と表示されます。

すべてのフィールドとメッセージについては、REST API:プロダクトラインを参照してください。

プラン

機能FreeIndividualTeam
API を通じてプロジェクトを 1 つの構成として読み取る✓✓✓
プロダクトラインページ、View as ▾、適用対象、構成値と適用性(読み取り専用)✓✓✓
プロダクトラインの編集:フィーチャー、構成、選択、適用対象、構成値、適用性、構成ごとのドキュメントと RVTM、API を通じた書き込み—✓✓
構成ごとのベースライン、構成ごとの比較、変更要求が変更する構成、構成のオーナー——✓

プロジェクトのオーナーのプランで決まります。学術用のメールアドレスまたはクラス組織では、すべての行が利用できます。

プランがない場合、プロダクトラインは読み取り専用になり、何も削除されません:

  • プロダクトラインページには、フィーチャー、構成、マトリックス、判定が表示されます。構成をチェック、CSV をエクスポート、列のこの構成として表示は動作します。+ 新しいフィーチャー、+ 新しい構成、マトリックス、および変更を行う行と列のコマンドは無効になります。ページにはプランを選択…とともに「読み取り専用:プロダクトラインの編集は Individual プランと Team プランに含まれます。プロジェクトのオーナーのプランで決まります。」と表示されます。
  • View as ▾は 1 つの構成を読み取り専用で表示します。バナーにも同じ文が表示されます。
  • インスペクターは、適用対象、適用性、構成値を読み取り専用で表示します。Feature と Configuration の項目は読み取り専用です。
  • ⌘K / Ctrl+K の新しいフィーチャー…、新しい構成…、プロダクトラインを開始…は一覧に残り、実行できない理由を表示します。
  • エクスポートはすべてのフィールドを保持します。新たな使用は「プロダクトラインは Individual プランと Team プランに含まれます。プロジェクトのオーナーのプランで決まります。」として拒否されます。Team プランのない構成のオーナーの場合:「構成のオーナーは Team プランに含まれます。プロジェクトのオーナーのプランで決まります。」

SysML v2 プロジェクト

SysML v2 には言語に可変性が組み込まれています:可変点、バリアント、構成(@HolarchConfiguration の使用)。SysML v2 プロジェクトでも、同じプロダクトラインページとView as ▾コントロールを使用します:

  • プロダクトラインページ:可変点のツリー、判定行のある構成マトリックス、ルール(プロダクトラインの assert constraint。読み取り専用で、エディターで開く付き)、可変点を挿入…(エディターを開きます)、構成をチェック、+ 新しい構成。バリアントを選ぶと、たとえば part :>> charger = charger::wallbox; が構成に書き込まれます。
  • View as ▾:各プロダクトラインの構成を判定とともに一覧表示します。すべてのビュー、データベース、インスペクター、プロダクトラインページがこれに従います。
  • Free では、LML プロジェクトと同様にプロダクトラインページは読み取り専用です:可変点を挿入…、+ 新しい構成、マトリックスの選択は無効になり、ブラウザー、インスペクター、⌘K / Ctrl+K の新しい構成…はその理由を表示します。モデルのテキストはエディターで引き続き編集できます。
  • 構成ビューでの編集(Individual と Team。Free では読み取り専用):すべての編集は、チェッカーでチェックされる SysML v2 のテキスト編集として行われ、1 回の元に戻すですべて取り消せます。変更した属性はその構成独自の値になり、新しいパートはその構成に属し、継承されたオプションの要素を削除すると part :>> roofBox[0]; が書き込まれます。
  • リスクやタスクなど、モデルの横にある Holarch のデータはすべての構成に適用されます。ただし、構成を表示している間に作成した項目は、その構成に適用されます。これらの項目の適用対象の編集は、SysML v2 プロジェクトではまだできません。適用性はモデル要素と構成に設定します(インスペクターの適用性セクション)。
  • まだ対応していません:LML プロジェクトのSysML v2 のコピーを作成…では、フィーチャーと構成が含まれません(レポートでは変換されていませんの下に一覧表示されます)。コピーでバリアントをモデル化し直してください。

SysML v2 のバリアントと構成を参照してください。

制限事項

  • 適用対象:最大 2,000 文字、200 項、括弧の入れ子 32 レベルまで。
  • シリアル番号:最大 200 範囲、番号は 1,000,000,000,000 まで。
  • 名前、番号、クラス、ラベル、担当者、構造は構成によって変えることはできません。
  • 各構造(親と順序)はすべての構成で共有されます。まだ対応していません:構成ごとの構造。
  • ReqIF のエクスポートには構成値が含まれません。
  • まだ対応していません:プロジェクトのシリアル接頭辞、および関係パネルでの関係に対する適用対象。
  • まだ対応していません:承認日、有効日、製造時、改修の日付を区別する適用性。適用性は 1 つのシリアル番号の範囲リストと 1 つの製造日の範囲です。
  • まだ対応していません:リリースされた定義としての構成ベースライン。ベースラインは構成のラベルを付けたプロダクトラインを記録するもので、構成の判定、選択、承認を個別の記録として記録するものではありません。
  • まだ対応していません:LML プロジェクトの SysML v2 コピーを作成するときのフィーチャーと構成の変換。
  • 式にはシリアル番号や日付を含めません。それらには適用性を使用します。