注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。

制限付きビューをブランチ化する

制限付きビューは Global Branching と統合されており、きめ細かな権限設定ポリシーを安全かつ分離された環境で開発できます。このドキュメントでは、ブランチ上で制限付きビューを操作する方法について説明します。ブランチ化されたリソースの追加、表示、削除、下流への変更の伝播、マージ要件、リベース、既知の制限事項を取り上げます。

Global Branching の概念とワークフローに関する一般的な情報については、Global Branching のドキュメントを参照してください。

リソースを追加、表示、削除する

制限付きビューをブランチに追加する

制限付きビューをブランチに追加するには、ブランチセレクターからブランチを選択し、リソースを追加を選択して、制限付きビューをブランチに追加します。これにより、このブランチ上で制限付きビューをビルドしたり、ポリシーやマーキングを変更したりできます。元データセット上にブランチがすでに存在している必要があります。存在しない場合は、エラーが発生することがあります。

デフォルトでは、ブランチ上で制限付きビューにアクセスすると、main ブランチの内容が表示されます。すでにブランチ上にいる状態で制限付きビューのポリシーやマーキングを編集すると、その編集内容を含む制限付きビューが自動的にブランチに追加されます。

デフォルトでは、所有者と編集者が制限付きビューをブランチに追加できます。所有者は制限付きビューをブランチに追加する際にポリシーとマーキングを編集できますが、編集者は制限付きビューのビルドのみを実行できます。これにより、編集者は制限付きビューの所有権を持たなくても、ブランチ化したワークフローに制限付きビューを追加してテストできます。

制限付きビューをブランチに追加すると、そのブランチ上で制限付きビューが自動的にビルドされます。その制限付きビューを元にするオブジェクトタイプがある場合は、変更を反映するために、それらのオブジェクトタイプもブランチ上で自動的に再インデックス化されます。

ブランチ化された制限付きビューを表示する

ブランチ化された制限付きビューの権限は、親の制限付きビューと同じです。元の制限付きビューを閲覧できる場合は、そのブランチ化されたバージョンも閲覧できます。

ブランチのマーキングの変更により、メインで制限されているデータが公開される可能性があります

ブランチ化された制限付きビューの元データセットに、main とは異なるマーキングが設定されている場合、閲覧者は main で以前制限されていたデータを閲覧できる可能性があります。ブランチを共有する前に、ブランチレベルのマーキングの変更が適切であることを確認してください。既知の制限事項を参照してください。

制限付きビューをブランチから削除する

制限付きビューが不要になったら、ブランチから削除できます。制限付きビューをブランチから削除すると、そのブランチにのみ存在するポリシー、マーキング、ビルド出力への変更が破棄され、ブランチは main から制限付きビューを読み取る状態に戻ります。main 上の制限付きビューには影響しません。

ブランチからの制限付きビューの削除は元に戻せません

制限付きビューをブランチから削除すると、元に戻すことはできません。そのブランチにのみ存在するポリシー、マーキング、ビルド出力への編集はすべて破棄されます。

制限付きビューをブランチから削除するには、ブランチタスクバーを開き、ブランチを選択します。変更されたリソースのリストで制限付きビューを探し、操作メニューのブランチから削除を選択してから、確認を選択して削除を完了します。

変更を伝播する

ブランチ上で制限付きビューが更新された場合、変更を反映するには、その制限付きビューを元にするオブジェクトタイプをブランチ上でインデックス化する必要があります。Ontology Manager で、上部のバナーにあるオブジェクトタイプをインデックス化オプションを使用して、ブランチ上のオブジェクトタイプをインデックス化します。インデックス化が完了すると、これらのオブジェクトを参照する Workshop モジュールと Ontology Manager に、ブランチ上の制限付きビューの変更が反映されます。

マージ要件

制限付きビューをブランチから main にマージするには、次の要件を満たす必要があります。

  • 承認要件が満たされている: ブランチをマージする前に、ブランチ化された制限付きビューに必要な承認の要件をすべて満たす必要があります。後述のレビュー担当者の操作を参照してください。
  • **制限付きビューが main の変更を取り込んでリベースされている:**制限付きビューの main ブランチに変更が加えられている場合は、マージする前に、それらの変更をこのブランチにリベースで取り込んでください。後述のリベースと競合の解決を参照してください。

保護された制限付きビュー

制限付きビューへのすべての編集がブランチ化とレビューのプロセスを経るようにするために、その制限付きビューの main ブランチを保護できます。

制限付きビューの main ブランチを保護するには、ファイルシステムでリソースに移動し、ブランチの保護 > プロジェクトポリシーで保護を選択します。

制限付きビューの main ブランチが保護されている場合、main 上でポリシーやマーキングを編集すると、保存時にグローバルブランチを経由する必要があります。

制限付きビューの main ブランチが保護されている場合、ブランチ上で変更を行う必要があります。

変更を保存するには、新しいブランチを作成する必要があります。

レビュー担当者の操作

編集者はブランチ上で制限付きビューのビルドのみを実行できますが、所有者はブランチ上で制限付きビューをビルドし、ポリシーとマーキングを変更できます。

提案が作成されたら、Global Branching アプリケーションまたは Approvals バナーで承認ステータスを選択します。ポップオーバーには、提案のマージに必要な承認ポリシーが表示されます。

レビュー待ちの制限付きビューの承認ポリシー。

制限付きビューにレビュー待ちの変更がある場合、ページ上部のバナーに、要件を満たした承認の数が表示されます。レビュー担当者は、レビューを開始を選択して比較タブを開き、main とブランチの変更を左右に並べて比較できます。その後、自分のレビューオプションを選択して、変更を承認または拒否できます。

比較タブでメインブランチと現在のブランチが左右に並べて比較され、変更を承認または拒否するための自分のレビューメニューが開いています。

必要な承認要件がすべて満たされると、変更が承認され、このリソースの提案をマージできるようになります。

必要な承認要件がすべて満たされ、制限付きビューの変更が承認されたことを示すバナー。

リベースと競合の解決

このブランチの作成後、または最後のリベース以降に main が変更された場合は、リベースが必要です。

制限付きビューの上部にバナーが表示され、最新の変更をこのブランチにリベースで取り込むよう求められます。

メインブランチに制限付きビューの新しいバージョンが存在することを示す、ブランチ化された制限付きビューのバナー。リベースを開始するオプションがあります。

このブランチをリベースするには、バナーのリベースを開始を選択します。リベースが進行中の状態で比較タブが開き、メインブランチと現在のブランチのバージョンが左右に並べて表示されます。変更ごとに、基準(メインブランチ)列または比較(現在のブランチ)列のいずれかでこのバージョンを維持を選択し、リベースして保存を選択して、選択内容を適用します。

リベースが進行中の比較タブ。メインブランチと現在のブランチのバージョンが比較表示され、いずれかのバージョンを維持し、リベースして保存するオプションがあります。

リベースと承認の両方が必要な場合、レビュー担当者が変更をレビューできるようにするには、先にリベースを完了する必要があります。

既知の制限事項

  • ブランチ化された制限付きビューの元データセットに、main とは異なるマーキングが設定されている場合、閲覧者は main で以前制限されていたデータを閲覧できる可能性があります。ブランチ化された制限付きビューを表示するを参照してください。
  • リベースでは、main の変更か、このブランチの変更のいずれかを選択する必要があります。現在、より細かい粒度で差分を解決する方法はありません。
  • 一部の元データセットはブランチ化できません。編集専用ワークフローの元となるデータセット、インポートによって作成されたデータセット、Fusion シートからビルドされたデータセットは、現在ブランチに追加できないため、これらのデータセットに依存する制限付きビューはブランチ上でビルドできません。完全なリストについては、Global Branching の統合に関するドキュメントを参照してください。