注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。
オントロジーは Global Branching と統合されており、オントロジーリソースを安全に分離された環境で開発できます。このドキュメントでは、ブランチ上でオントロジーを操作する方法を説明します。リソースの追加と変更、オブジェクトタイプのインデックス化、リベースと競合の解決、レビューとマージのプロセス、および既知の制限事項を取り上げます。
Global Branching の概念とワークフローに関する一般的な情報は、Global Branching のドキュメントを参照してください。
ブランチ、提案、リベースの一般的な定義については、Global Branching の基本概念を参照してください。以下の用語は、オントロジーのブランチ化に固有のものです。
main にマージされるオントロジーの変更に関するレビュー、名前、説明などのメタデータが含まれます。ブランチ上でオントロジーを変更するには、Ontology Manager で新しいブランチを作成するか、ブランチセレクターを使用して既存のブランチにアクセスします。
ブランチを作成するには、ブランチセレクターを開き、新規ブランチを作成を選択します。開いたダイアログで、ブランチのタイトルと説明を追加できます。
ブランチに含めたいオントロジーの変更がすでにある場合は、保存ダイアログで新しいブランチに保存を選択すると、その変更を含む別のブランチを作成できます。保護されたオントロジーリソースを変更した場合は、新しいブランチへの保存が必要になります。
ブランチは、main ブランチとも呼ばれるメインのオントロジーからのみ作成できます。
ブランチ上では、インターフェースの下部にあるブランチタスクバーに、現在のブランチ名と追加のメタデータが表示されます。
ブランチ保護に対応しているオントロジーリソースのタイプは次のとおりです。
次のリソースではリソース保護を利用できません。
また、オントロジーリソースを保護するには、事前にプロジェクト権限を使用するように移行する必要があります。詳細は、オントロジーの権限を参照してください。
オントロジーリソースをプロジェクト権限を使用するように移行すると、親プロジェクトのファイルタブで保護状態を表示および管理できます。

保護を有効にした後は、別のブランチで変更を行い、メインブランチにマージするための提案を作成する必要があります。
保護状態は、Ontology Manager の概要タブにも表示されます。

適用されるポリシーは、セキュリティタブでも確認できます。

保護されたリソースを変更する場合、保存ダイアログはブランチを作成して保存に置き換わり、変更を新しいブランチに保存する必要があります。

グローバルブランチ上でオブジェクトタイプをインデックス化すると、そのブランチ上でプレビューとテストにデータを利用できるようになります。Ontology Manager では、オブジェクトタイプのページ、またはそのオブジェクトタイプを編集するアクションタイプから、オブジェクトタイプをインデックス化できます。複数のオブジェクトタイプを一度にインデックス化するには、Workflow Lineage の一括インデックス化を使用します。インデックス化の進行状況は、オントロジーの提案のプレビューの状態タブで確認できます。
グローバルブランチ上でオブジェクトタイプを初めてインデックス化すると、Foundry はそのオブジェクトタイプが参照するメディアセットを自動的にブランチに追加します。
新しいメディアセットのブランチは空の状態で開始され、main や別のグローバルブランチからメディアアイテムがコピーされることはありません。ただし、オブジェクトタイプのブランチ化された元データソースに含まれる Media Reference は、main 上のメディアアイテムへの参照も含め、引き続きオブジェクトタイプを通じて読み取れます。これにより、元データソースのブランチ化された状態を保持しながら、新しいメディアをブランチ上に分離して保持します。
グローバルブランチでメディアセットがサポートされる前にオブジェクトタイプがすでにインデックス化されていた場合、そのブランチではメディアセットを利用できないことがあります。この場合、Ontology Manager に警告バナーが表示されます。グローバルブランチ上で、そのメディアセットを参照するオブジェクトタイプまたはアクションタイプを開き、メディアセットをブランチに追加を選択します。

このブランチに変更を加えている間に、main にもほかのユーザーによる新しい変更が加わることがあります。リベースは、main の最新の変更を現在のブランチに取り込み、現在のブランチを最新の状態に保ちます。
グローバルブランチにオントロジーの変更が含まれていない場合、リベースは自動的に行われます。オブジェクトタイプのインデックス化を含むオントロジーの変更をブランチに加えると、ブランチを main と同じ最新の状態に保つために、手動でリベースする必要があります。
main に新しい変更がある場合、サイドバーのメインブランチの更新タブに青いインジケーターが表示され、変更の確認を促します。
メインブランチの更新ページに移動すると、前回のリベース以降に取り込まれる変更を表示できます。初めて手動でリベースする場合は、ブランチ作成以降の変更が表示されます。ブランチをリベースを選択すると、ブランチが main の最新バージョンに更新されます。

競合やエラーがない場合、リベースは自動的に完了し、ブランチが最新の状態になります。
競合がある場合、リベースは進行中のままとなり、競合タブにリダイレクトされます。ここで、このブランチと main の間で競合する変更を解決します。エラーのみがある場合は、代わりにエラータブにリダイレクトされます。
リベース中は、main の変更がこのブランチに読み込まれ、現在のブランチで以前に保存された変更が作業状態に再読み込みされます。この作業状態は、すべての変更タブで確認できます。
この状態では、main とこのブランチの両方の変更を表示してアクセスできます。オントロジーリソースに両方のブランチの変更がある場合、デフォルトではこのブランチのバージョンが表示されます。

競合を解決するには、リソースごとにメインブランチの変更を使用または現在のブランチの変更を保持を選択できます。また、そのリソースに直接移動してカスタム変更を適用し、競合を解決することもできます。
この例では、Palantir employee オブジェクトタイプの表示名が main ブランチとこのブランチの両方で変更されているため、競合が発生しています。この競合を解決するには、このオブジェクトタイプのどちらのバージョンを保持するかを選択します。

カスタム変更を加えて、この競合を解決することもできます。この例では、オブジェクトタイプに移動し、表示名を「Palantir employee」から「Current employee」に変更できます。このカスタム変更によって、競合が解決されます。


すべての競合を解決したら、リベースを完了する前に、エラーにも対処していることを確認してください。
すべてのエラーと競合が解決したら、リベースを完了して保存を選択すると、ブランチが最新の状態になります。

ブランチで作業を続けながら定期的にリベースすることで、ブランチを main ブランチの最新バージョンと同じ状態に保つことができます。

変更を加えたブランチを main にマージする準備ができたら、ブランチのタスクバーで提案を作成アイコンを選択して提案を作成します。名前と説明を追加して、提案を設定します。


提案を作成すると、マージチェックが実行され、グローバルブランチのリソースを main ブランチにマージできるかどうかが確認されます。チェックが失敗する原因には、このブランチと main ブランチ間の競合などがあり、その場合はブランチをリベースする必要があります。
オントロジーの提案ページで、変更を確認に移動し、レビュー担当者を招待を選択して、提案にレビュー担当者を追加します。プロジェクトに移行済みのオントロジーリソースについては、ポリシーを表示を選択すると、関連するプロジェクトポリシーに基づいて、そのリソースのレビューが必要なレビュー担当者を確認できます。
オントロジーリソースは、それぞれ個別のタスクとして扱われます。リソース名の横にあるステータスタグは全体の承認ステータスを示し、右側の自分のレビューセクションからレビューを送信できます。
オントロジーエンティティは Global Branching では個別のリソースとして扱われますが、単一のローカルなオントロジーの提案にまとめられます。そのため、1個のオントロジーリソースにレビュー担当者を追加すると、実質的にすべてのオントロジーリソースにそのレビュー担当者が追加されます。

提案内のさまざまなタスクにコメントを残し、提案された変更の背景を伝えることもできます。右端のコメントサイドバーを選択すると、タスクのコメントセクションにアクセスできます。
変更を確認タブでは、レビュー担当者が個別のタスクを承認または拒否できます。権限のないユーザーも、たとえば変更に関する意見を伝えるためにタスクをレビューできますが、そのレビューはタスクの承認ステータスには影響しません。
承認権限を持つユーザーは、レビュー担当者として追加されていなくても提案を承認できます。レビュー担当者リストは、承認を制限するためではなく、誰が変更をレビューすべきかを把握するために使用してください。
オントロジーの提案では、レビュー担当者は提案の詳細を確認し、変更されたすべてのリソース、または特定のオントロジーリソースに対する変更を承認または拒否できます。

ポリシーの要件を満たすと、承認されたリソースのステータスが進行中から承認済みに変わります。その後、ほかのすべてのチェックに合格していれば、提案をマージできます。
変更を main にマージする準備ができたら、Global Branching の提案をマージする必要があります。これにより、オントロジーのマージ処理が自動的に開始されます。

マージするには、ブランチのタスクバーでマージアイコンを選択するか、Global Branching の提案ページに移動して提案をマージを選択します。
main ブランチで元データソースが置き換えられた、または削除されたオブジェクトタイプに競合が発生した場合、このブランチの変更を保持することを選択すると、マージが失敗します。この場合は、main ブランチの変更を選択します。main ブランチで条件付き書式設定のルールセットが置き換えられた、または削除されたプロパティタイプに競合が発生した場合、このブランチの変更を保持することを選択すると、マージが失敗します。この場合は、main ブランチの変更を選択します。