管理とレビュー
変更要求
承認済みまたはベースライン化された項目への変更を変更要求として提案し、レビューと承認を受けてから、完全な記録とともに 1 ステップで適用します。
このページの内容
変更要求は、モデルに対する一連の編集を提案し、その理由を説明し、何かが変わる前に承認を待ちます。変更要求は構成管理に使用します。要求が承認されたりベースラインが設定されたりすると、変更はプロジェクトの承認者がレビューする要求を通じて行われます。変更要求は管理とレビュー → 変更要求にあります。
使い方
変更要求を作成する
- 管理とレビュー → 変更要求を開いてページヘッダーの+ 新しい変更要求をクリックするか、構成管理下にある項目の項目ビューのページヘッダーで変更を提案…をクリックします(その項目に未完了の変更要求がある場合は、それが開きます)。
- タイトルと理由(変更が必要な理由と、変更で達成すべきこと)を入力します。
- 作成をクリックし、項目を追加…で影響を受ける項目を追加します。Holarch はそれらにトレースされた項目(要求、テスト、インターフェース、その他の関連項目)を一覧表示します。同じく変更される項目の+をクリックします。
変更をステージする
- 変更を追加 ▾をクリックし、提案する内容を選びます:項目を変更…(番号、名前、リッチテキストエディターでの説明(書式は保持されます)、または 1 つの属性)、新しい項目…、項目を削除…、関係を追加…、関係を除去…、別のプロジェクトへのリンクを追加…、または別のプロジェクトへのリンクを除去…。SysML v2 プロジェクトでは、SysML テキストを編集…で 1 つのパッケージのテキストに対する編集を提案します。
- 変更をステージをクリックします。ステージした各変更は提案された変更の下に、説明とテキストの変更の単語単位の差分と、その影響リスト(影響を参照)とともに一覧表示されます。この時点ではモデルはまだ何も変わりません。
- ステージした変更は除去で除去します。
提出、レビュー、承認
- レビューに提出をクリックします。ホスト型サービスでは、承認者に通知が届き、マイワーク → 判断待ちに項目が追加されます。そこで承認…と却下…をクリックすると、投票ダイアログ付きで要求が開きます。
- 承認者は要求を開き、提案された変更とその影響リストを確認して、承認…または却下…をクリックします(却下には理由が必要です)。変更された要求がベースラインに含まれている場合、承認…ダイアログには再レビューが必要な検証項目とドキュメントも一覧表示されます。
- レビューカードにはApprovals: N of Mが表示されます。状態の変更に専用の承認者がある要求では、各ルールがその数とともに、たとえば○ Every named approver (3): 1 of 3のように一覧表示されます。必要な承認がそろうと、要求のステータスは承認済みになります。却下が 1 件あると要求は却下されます。その後、作成者は変更を編集して再提出できます。
取り下げは、まだ適用されていない要求をモデルを変更せずに閉じます。その記録はログに残ります。
変更を適用する
- 編集者またはオーナーが承認済みの要求を開いて変更を適用をクリックし、変更を適用で確定します。
- ステージしたすべての変更は、まとめて適用され、1 回の元に戻すですべて取り消せます。変更された各項目の履歴には、変更が「via CR-12」として記録されます。
- その間に項目が削除された変更はスキップされ、結果とともに一覧表示されます。ステージした構成のリリース(変更を追加 ▾ → 構成をリリース…)は要求の承認者とともに記録されるか、リリースされなかった理由とともに一覧表示されます。変更要求によるリリースを参照してください。
- 要求は、検討された内容の記録として、各変更の影響リストを変更適用の直前の状態で保持します。その履歴には「impact recorded」が件数とともに、たとえば「4 affected, 9 to check」のように表示されます。適用が影響リストを待つことはありません:数秒たっても他のプロジェクトの項目をまだ読み取っている場合、要求はすぐに適用され、その時点までに計算されたリストを保持します。このことは、要求、その履歴、およびエクスポートに「Impact not finished when applied」と示されます。
変更要求内で作業する
各変更をダイアログでステージする代わりに、下書きの変更要求内で作業できます:どのページでも通常どおりモデルを編集すると、編集はライブモデルではなく要求に入ります。ライブモデルは、要求が承認されて適用されたときにのみ変わります。
オンにする
変更要求内での作業は、プロジェクトのオーナーがオンにするまで、すべてのプロジェクトでオフです:変更要求ページで設定を開き、変更要求での作業:ドラフトで編集し、承認後に適用をオンにします。下書きにその中で行った編集がまだある間は、オフにすることは拒否されます。先にそれらの要求を適用するか取り下げてください。ホスト型サービスでは、変更要求内での作業は、承認ルールと同じく、プロジェクトのオーナーの Team プランに含まれます(構成管理の注記を参照)。確認済みの学術用メールアドレス、または有効なクラス組織のメンバーシップでも利用でき、バージョン 2.29.0 より前に承認ルールを使用していたプロジェクトは引き続き利用できます。その他のプランでは、この設定は無効の状態で表示されます。デスクトップアプリにはプランはありません。
開始と終了
下書きの要求内での作業は、次のいずれかから開始します:
- 新しい変更要求ダイアログの今すぐこの中で作業(既定でオン)。
- 下書きの要求のページのこの変更要求で作業。
- 項目の項目ビューの変更を提案 ▾ → 変更要求内で作業…。一覧には、その項目を指定している下書きと新しい変更要求…が表示されます。
- 構成管理下にある項目を編集したときに表示されるメッセージの変更要求内で作業。
- ⌘K / Ctrl+K → 変更要求内で作業…。
- マイワーク → 作業中の変更要求の下の続行。
要求内で作業している間:
- トップバーの下のバナーに、たとえばWorking in CR-12 Range upgrade. Edits go to this change request, not the live model. 3 changes.と表示され、変更をレビューと終了があります。
- 保存状態は、たとえばSaved 14:02 in CR-12と表示されます。
- 要求が変更した項目には、表やダイアグラムでCRマーカーが付きます。
試すには、CubeSat EO-1 デモプロジェクトを開きます:CR-1 Shorten the planning cycleは、その中で編集が行われた下書きです。変更要求でそれを開き、この変更要求で作業をクリックします。Hybrid Car デモでは、CR-2 Clarify the charge timeに要求のドキュメントに対する編集が入っています。
バナーの終了(または⌘K / Ctrl+K → 変更要求を終了)をクリックすると、ライブモデルに戻ります。このモードはブラウザーのタブごとです:別のタブでは同時にライブモデルを表示でき、再読み込みしてもタブは要求内に留まります。
動作の違い
- 元に戻すは、要求に入った時点で止まります。
- スキーマの変更、ベースライン、共有、承認を要求、以前のバージョンを復元は、要求を終了するまで拒否されます。
- 構成管理下にある項目も要求内で編集できます。それがこの機能の目的です。
- レビューに提出すると、要求が決定されるか取り下げられるまで編集は一時停止します。却下された要求は、編集すると再び下書きになります。
- 取り下げは、要求の編集を 1 つのエントリ(たとえばCR-12 changes)としてゴミ箱に移動します。復元で要求に戻せます。
変更をレビューする
その中で編集が行われた要求のページには 2 つのタブがあります:詳細(要求、ステージした変更、レビュー、コメント、履歴)と変更です。変更タブは、要求前のモデルと、要求によって変わった後のモデルを比較します。バナーの変更をレビューでこれが開きます。
- 件数タイルには、追加、除去、変更された項目と関係の変更が表示されます。その下には変更ごとに行があり、変更されたテキストは単語単位で表示されます。
- 品質の結果、疑わしいリンクのマーク、その他のレビュー記録は非表示です。それらも一覧表示するにはレビューデータを表示をクリックします。
- ドキュメントには、変更された項目を含む各ドキュメントが一覧表示されます。版を比較…は、要求前と要求適用後のドキュメントを、各フィールドを並べて変更された単語に印を付けて表示します。フィールド内で移動した文は両方の位置に紫色で表示され、両者の間にリンクが付きます。
- ダイアグラムには、変更された各ダイアグラムが変更内容とともに、たとえばAsset Diagram 0 Drone Delivery System: 1 shape added (Charger), 1 movedのように一覧表示されます。変更前と変更後を表示は両方のバージョンを並べて描画します。
要求のページのモデルでプレビューは、要求を適用した後のモデルを読み取り専用で開きます。バナーには、たとえばPreviewing CR-12 (read only).と表示されます。すべてのページに変更がその場で表示されるため、生成された仕様書、RVTM、マトリックスを確認できます。終了をクリックするまで編集は拒否されます。レビュー担当者と閲覧者もプレビューできます。
投票は、要求のステージした変更だけでなく、要求内で行われた編集も対象とします:投票後に行われた編集はその投票を無効にし、承認者が再度判断します。
作業した要求を適用する
承認済みの要求の変更を適用は、まず要求の編集を現在のライブモデルと比較します。その間に他のユーザーが同じ項目を変更している可能性があるためです。
- 競合がない場合:確認には、たとえばApply 14 changes to the live model? A single Undo takes it all back.と表示されます。変更を適用の後、トーストにはCR-12 applied: 14 changes.と表示されます。新しい項目は ID を保持し、変更された各項目の履歴には「via CR-12」と表示され、要求の作成者の名前が示されます。
- 同じ項目の異なるフィールドへの変更は、確認なしでマージされます:要求で項目の名前を変更し、他のユーザーがライブモデルでその番号を変更した場合、両方の変更が保持されます。
- 競合:同じフィールドが両方で変更された場合、項目が一方で削除され他方で変更された場合、または要求からライブモデルで削除された項目へのリンクがある場合です。要求のページにはその件数が、たとえばCR-12 has 2 conflicts with the live model.のように表示され、変更を適用は先に競合を解決 — CR-12を開きます。
競合を解決では、競合する各項目にカードがあり、ライブモデルのバージョン(ホスト型サービスでは変更したユーザー付き)と変更要求のバージョンが表示されます。元の内容を表示は、どちらかが変更される前のバージョンを追加します。ダイアグラムは並べて描画されます。次のいずれかを選びます:
- ライブに保つ:項目はライブモデルのままになります。削除された項目へのリンクの場合、リンクは含まれません。
- 変更要求を使用:要求が変更した各フィールドには要求の値が使われ、ライブモデルだけが変更したフィールドはライブの値を保持します。削除の場合は要求の結果になります:項目は削除されるか、要求の変更を加えて復元されます。削除された項目へのリンクの場合、項目はリンクとともにゴミ箱から復元されます。
- 結合:変更されたフィールドごとに、ライブと変更要求のある行が 1 つ表示されます。一方だけが変更したフィールドはその側から始まり、両方が変更したフィールドは変更要求から始まります。
すべての競合に選択がされるまで、変更を適用は無効のままです(「Choose a version for each of the 3 conflicts.」)。競合を解決できるのは、編集権限を持つその要求の承認者だけです。他のユーザーには、たとえばCR-12 has 3 conflicts with the live model. An approver resolves them at Apply.と表示されます。要求の履歴には各選択(「Kept the live version of R.4.2」、「Replaced a live change by Ann to R.4.3」)が記録され、ホスト型サービスでは、ライブでの変更が置き換えられたユーザーに通知が届きます。
1 回の元に戻すで適用全体を取り消せます:ライブモデルが復元され、要求はその編集とともに承認済みに戻り、再び適用できる状態になります。適用後、要求の変更タブには適用された内容の一覧が残ります。承認後に編集された要求は、再提出して再び承認されるまで適用できません。要求の適用時にその中で作業中またはプレビュー中のユーザーは、ライブモデルに戻ります。SysML v2 プロジェクトでは、確認に要求がモデルに追加するエラーが一覧表示され、別のバージョンを選ぶか要求が却下されるまで変更を適用は無効のままです。
影響
ステージした各変更には影響リストがあります:その変更にトレースされる項目で、誰かが変更を承認または適用する前に見つかります。見出しには件数が、たとえばImpact 3 affected · 7 to checkのように表示されます。見出しをクリックするとリストの表示と非表示が切り替わります。変更が 4 件以上ある要求では、リストは閉じた状態で始まります。
リストは要求、テストと検証、インターフェース、ドキュメント、ダイアグラム、他のプロジェクトの項目、その他の項目にグループ化されます。各行には次のマークが付きます:
| マーク | 意味 |
|---|---|
| 影響あり | 変更が直接関わるもの:変更された項目から関係 1 つ離れた項目、変更された項目を表示するドキュメントまたはダイアグラム、追加または除去された関係の両端、変更された項目にリンクされた他のプロジェクトの項目。 |
| チェック | さらに 1 段階先のもの:影響を受ける項目にトレースされた項目、それらを表示するドキュメントとダイアグラム、2 リンク先にある他のプロジェクトの項目。 |
各行には、そのクラスと到達経路が、たとえば「verified by 1.1 Pump pressure」のように示されます。リンクを最後にレビューしてから項目が変更された別のプロジェクトへのリンクには変更ありと表示されます。行をクリックすると、項目、ドキュメント、またはダイアグラムが開きます。他のプロジェクトの項目は、自分のアクセス権で項目トレースから取得されます:開けないプロジェクトへのリンクは件数のみが数えられます。
リストには最大 300 行が表示され、残りの件数が示されます。他のプロジェクトへのリンクは、最初の 12 個の変更された項目について読み取られます。
見出しの下の注記には、リストの根拠が示されます:「Impact is based on modeled relationships; unlinked or more distant dependencies may not appear. Computed against revision 1,204 at 14:02.」リビジョンは、リストを計算したときのプロジェクトのリビジョンです(ホスト型サービスでは、すべての編集者で同じ番号)。読んでいる間にモデルが変わっても、リストは計算時のままです。再計算するには要求を開き直します。保存されたリストは、計算の基になったリビジョンを保持します。
要求が適用されると、リストは要求とともに保存され、当時のまま表示されます。そのため、項目の名前が変更されたり削除されたりした後も、記録には検討された内容が残ります。エクスポート ▾ → Word (.docx)にはリストが含まれ、Excel のログには件数を示す影響列があります。
変更が判断を待つ他の場所にも同じリストが表示されます:
- AI のプレビューとAI クライアントからの提案:AIを参照してください。
- ライブラリの新しいリリース…:最新のリリース以降に変更されたライブラリ項目を使用しているプロジェクトと項目。ライブラリを参照してください。
- ベースライン化された要求の承認:再レビューが必要になる検証項目とドキュメント。要求を参照してください。
ステータス
| ステータス | 意味 |
|---|---|
| Draft(下書き) | 作成中です。作成者が変更をステージします。 |
| 提出済み | 承認者を待っています。 |
| レビュー中 | 少なくとも 1 人の承認者が投票しました。 |
| 承認済み | 必要な承認がそろい、適用できる状態です。 |
| 却下 | 承認者が却下しました。作成者は修正して再提出できます。 |
| 取り下げ済み | モデルを変更せずに閉じられました。 |
| 実施済み | 変更が適用されました。 |
構成管理
注:ホスト型サービスでは、プロジェクトのオーナーのプランで決まります。構成管理(最初の設定)は Individual プランと Team プランに含まれ、以下の承認ルール(必要な承認数、承認者、変更委員会、自己承認)は Team プランに含まれます。確認済みの学術用メールアドレス、または有効なクラス組織のメンバーシップがあれば、両方を利用できます。バージョン 2.29.0 より前にこれらを使用していたプロジェクトと組織は、引き続き利用できます。承認ルールがない場合、変更要求は 1 つのルールで動作します:プロジェクトのオーナーの承認で決まり、作成者は自分の要求を承認できるため、1 人で作業するときは自分の変更を承認して適用できます。以前に保存した設定は保持されますが適用されず、設定にその旨が表示されます。この場合、承認済みおよびベースライン化された項目は直接編集できます。承認記録、投票、ステータスは保持されます。デスクトップアプリにはプランはありません。
変更要求ページのページヘッダーにある設定は、変更要求の設定を開きます。設定は構成管理(変更要求が必要なものと、編集者が下書きで作業するかどうか)と承認(承認数、承認者、自己承認)の下にまとめられています。各設定は変更するとすぐに適用され、完了でダイアログを閉じます。一覧の上の行には、現在の設定の動作が、たとえば「Approved and baselined items can be edited directly; 1 approval by project owners.」のように、設定で変更リンクとともに表示されます。
設定で、プロジェクトのオーナーは承認済みおよびベースライン化済みの項目の変更には変更要求が必要をオンにできます。すると:
- 承認済みの要求(Status が Approved)と最新のプロジェクトベースラインに含まれる項目は、直接編集、削除、リンクできなくなります。Holarch はその理由を説明し、変更要求を案内します。
- それらの適用対象、適用性、構成への所属(プロダクトライン)もその一部です:項目が適用される構成やユニットを変更するには変更要求が必要です。
- コメント、レビュー、要求の承認、品質の結果、リンクレビューのマークは引き続き利用できます。
- 承認済みの変更要求は、これらの項目に変更を適用します。
- REST API と MCPも同じルールに従います:これらの項目に対するスクリプトの直接の変更は拒否され(
409 change-control)、AI クライアントの提案にはこれらを含めることができません。代わりに変更要求で変更を提案してください。 - ホスト型サービスでは、サーバーに届くすべての変更(オフラインで行った変更も含む)をサーバーがチェックします。項目が管理下に入る前(オフライン中、または他のユーザーが承認している間)に行われた、承認済みまたはベースライン化された項目への変更は保存されません:Holarch はどの項目かを示し、プロジェクトを再読み込みし、他の変更は保持します。代わりにその変更を変更要求で提案してください。
注:ホスト型サービスでは、構成管理はすべての編集方法(アプリ、REST API、MCP)についてサーバーによって適用されます。編集者が別のクライアントで回避することはできません。これらの項目を変更できるのは、承認済みの変更要求の適用だけです。デスクトップアプリとブラウザープロジェクトでは、項目のロックと同様に、アプリがこれを適用します。
承認と承認者
- 必要な承認数:1、2、または 3。
- 承認者:プロジェクトのオーナー、オーナーと編集者、または指名されたプロジェクトメンバーによる変更委員会(ホスト型サービス。デスクトップでは自分の要求を自分で承認します)。変更委員会はレビュー担当者を指名できます。レビュー担当者は、モデルを編集することなく要求を承認、却下し、コメントできます。コメントできるプロジェクトメンバー(レビュー担当者以上)は誰でも変更要求にコメントできます。
- 作成者は自分の変更要求を承認できる:既定ではオフです。
これらの設定を変更できるのはプロジェクトのオーナーだけです。
ワークフローが作成する要求にも同じ設定が適用されます:スキーマ → ワークフローで承認と指定された状態変更は承認を要求を開き、その 1 つの変更を含む変更要求を作成して提出します。
ワークフローの遷移には、代わりに独自の承認者を指定することもできます。たとえば、レビュー委員会の全メンバーや、指名された 4 人のエンジニアのうち 2 人です(遷移の承認者を選ぶ)。その場合、要求には、その状態変更が該当する各ルールの承認が必要です。どの遷移にも該当しない変更には、これらの設定が使われます。デスクトップアプリでは、承認者は名前です:環境設定 → お名前の名前で承認します。状態変更だけを含む要求は、最後の承認者が編集権限を持つ場合、その承認とともに適用されます。
ホスト型サービスでは、Holarch はプロジェクトのオーナーが保存した設定だけを使用します。他のユーザーが変更した設定は無視され、既定値(オーナーが承認、承認 1 件、自分の要求は承認不可)が適用されます。
変更要求を誰が提出したかの記録が Holarch にない場合(たとえば、要求ごとアップロードまたはインポートされたプロジェクト)、承認できるのはプロジェクトのオーナーだけです。誰が保存したかの記録がない設定は、オーナーが再度保存するまで、オーナーを承認者とし自己承認なしで適用されます。
承認の記録
ホスト型サービスでは、承認または却下の際にパスワードが求められ(10 分に 1 回)、誰がいつ判断したか、メモ、投票の対象となるステージされた変更の内容が正確に記録されます。投票後にステージされた変更が編集されると、その投票は数えられなくなり、承認者に再度依頼されます。変更が適用される前に、サーバーは要求が現在の変更内容で承認されていることを確認します。各投票は監査ログにも書き込まれます(要求、判断、メモの長さ。メモ自体は書き込まれません)。
注:承認記録は、誰が何をいつ承認したかを示すものです。法的に規制された電子署名(21 CFR Part 11 に基づくものなど)ではありません。
コメント、通知、ログ
- 変更要求のコメントは、項目のコメントと同じように機能します。
- ホスト型サービスでは、要求が提出されると承認者に、承認または却下されると作成者に、適用または取り下げられると作成者と投票者に通知が届きます。
- 各要求には、何が、誰によって、いつ行われたかの履歴が保持されます。
- 変更要求ページのエクスポート ▾(変更要求が 1 つあると表示されます)は、変更要求ログを、各要求の変更と履歴とともにExcel(.xlsx)またはWord (.docx)として保存します。