注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。
オントロジーをブランチ化する
オントロジーは Global Branching と統合されており、オントロジーリソースを安全に、分離された環境で開発できます。このドキュメントでは、リソースの追加と変更、リベースと競合の解決、レビューとマージのプロセス、既知の制限など、ブランチ上でオントロジーを扱う方法を説明します。
Global Branching の概念とワークフローに関する一般的な情報については、Global Branching のドキュメントを参照してください。
定義
ブランチ、提案、リベースの一般的な定義については、Global Branching の主要概念を参照してください。以下の用語は、オントロジーのブランチ化に固有のものです。
- オントロジーの提案： オントロジーの変更を含むブランチで Global Branching の提案を作成すると、オントロジー固有の変更を追跡するために、オントロジーの提案が自動的に作成されます。オントロジーの提案には、
mainにマージされるオントロジーの変更のレビュー、名前、説明などのメタデータが含まれます。
リソースを追加および変更する
ブランチ上でオントロジーを変更するには、Ontology Manager で新しいブランチを作成するか、ブランチセレクターを使用して既存のブランチにアクセスします。
ブランチを作成するには、ブランチセレクターを開き、新規ブランチを作成を選択します。開いたダイアログで、ブランチのタイトルと説明を追加できます。
ブランチに含めたいオントロジーの変更がすでにある場合は、保存ダイアログから新しいブランチに保存を選択して、その変更を含む別のブランチを作成できます。保護されたオントロジーリソースを変更した場合は、新しいブランチに保存する必要があります。
ブランチは、main ブランチとも呼ばれるメインオントロジーからのみ作成できます。
ブランチ上で作業している間は、インターフェースの下部にあるブランチタスクバーに、現在のブランチ名と追加のメタデータが表示されます。
リソース保護
ブランチ保護に対応しているオントロジーリソースの種類は、次のとおりです。
- オブジェクトタイプ
- アクションタイプ
- リンクタイプ
- インターフェースタイプ
- 共通プロパティタイプ
次のリソースでは、リソース保護を利用できません。
- タイプグループ
- ルールセット（ルールセットを変更する場合は、そのルールセットを含むオブジェクトタイプの保護ステータスが適用されます）
また、オントロジーリソースを保護するには、先にプロジェクト権限を使用するように移行する必要があります。詳細については、オントロジーの権限を参照してください。
オントロジーリソースをプロジェクト権限を使用するように移行した後は、親プロジェクトのファイルタブで保護ステータスを表示および管理できます。
保護を有効にすると、別のブランチで変更を行い、その変更をメインブランチにマージするための提案を作成する必要があります。
保護ステータスは、Ontology Manager の概要タブにも表示されます。
適用されるポリシーは、セキュリティタブでも確認できます。
保護されたリソースを変更すると、保存ダイアログがブランチを作成して保存に置き換わり、変更を新しいブランチに保存する必要があります。
リベースと競合の解決
このブランチに変更を加えている間に、ほかのユーザーが main に新しい変更を加えることもあります。リベースは、main の最新の変更を現在のブランチに取り込み、現在のブランチを最新の状態に保ちます。
グローバルブランチにオントロジーの変更が含まれていない場合、リベースは自動的に行われます。オブジェクトタイプのインデックス化を含め、オントロジーの変更をこのブランチに加えると、main に合わせてこのブランチを最新の状態に保つために、手動でリベースする必要があります。
ブランチをリベースする
main に新しい変更があると、サイドバーのメインブランチの更新タブに青いインジケーターが表示され、変更の確認を促します。
メインブランチの更新ページに移動して、前回のリベース以降に取り込まれる変更を確認します。初めて手動でリベースする場合は、ブランチの作成以降の変更が表示されます。ブランチをリベースを選択して、このブランチを main の最新バージョンに更新します。
競合やエラーがない場合、リベースは自動的に完了し、このブランチは最新の状態になります。
マージの競合を解決する
競合がある場合、リベースは進行中のままとなり、競合タブにリダイレクトされます。このタブで、このブランチと main の間で競合している変更を解決します。エラーのみがある場合は、代わりにエラータブにリダイレクトされます。
リベース中は、main の変更がこのブランチに読み込まれ、現在のブランチで以前に保存された変更が作業状態に再読み込みされます。これらは、すべての変更タブで確認できます。
この状態では、main とこのブランチの両方の変更を表示し、アクセスできます。オントロジーリソースに両方のブランチからの変更がある場合、デフォルトではこのブランチのバージョンが表示されます。
競合を解決するには、リソースごとにメインブランチの変更を使用または現在のブランチの変更を保持を選択できます。また、そのリソースに直接移動し、カスタムの変更を加えて競合を解決することもできます。
この例では、Palantir employee オブジェクトタイプの表示名が main ブランチとこのブランチの両方で変更されているため、競合しています。この競合を解決するには、このオブジェクトタイプのどちらのバージョンを保持するかを選択します。
カスタムの変更を加えて、この競合を解決することもできます。この例では、オブジェクトタイプに移動して、表示名を「Palantir employee」から「Current employee」に変更できます。このカスタムの変更により、競合が解決されます。
すべての競合を解決した後、リベースを完了する前に、エラーにも対処してください。
リベースを完了する
すべてのエラーと競合を解決したら、リベースを完了して保存を選択できます。これにより、このブランチは最新の状態になります。
このブランチで作業を続けながら定期的にリベースすることで、main ブランチの最新バージョンに合わせてこのブランチを最新の状態に保つことができます。
マージの要件
このブランチをレビューできる状態にする
変更を加えた後、このブランチを main にマージする準備ができたら、ブランチタスクバーの提案を作成アイコンを選択して提案を作成します。名前と説明を追加して、提案を設定します。
提案が作成されると、マージチェックが実行され、グローバルブランチ上のリソースを main ブランチにマージできるかどうかが確認されます。チェックの失敗には、このブランチと main ブランチの間の競合が含まれる場合があり、その場合はこのブランチをリベースする必要があります。
レビューを依頼する
ブランチタスクバー、Global Branching の提案ページ、またはオントロジーの提案ページから、提案にレビュー担当者を追加できます。
オントロジーの提案ページで変更を確認に移動し、レビュー担当者を招待を選択して、提案にレビュー担当者を追加します。プロジェクトに移行済みのオントロジーリソースについては、ポリシーを表示を選択すると、関連するプロジェクトポリシーに基づいて、そのリソースのレビューが必要な担当者を確認できます。
各オントロジーリソースは個別のタスクとして扱われます。リソース名の横にあるステータスタグは全体の承認ステータスを示し、右側のご自身のレビューセクションではレビューを送信できます。
Global Branching ではオントロジーリソースが個別のリソースとして扱われますが、それらは1つのローカルオントロジー提案にまとめられます。そのため、1つのオントロジーリソースにレビュー担当者を追加すると、実質的にすべてのオントロジーリソースにその担当者が追加されます。
提案内のさまざまなタスクにコメントを残して、提案された変更の背景を伝えることもできます。右端のコメントサイドバーを選択すると、タスクのコメントセクションにアクセスできます。
提案をレビューする
変更を確認タブでは、レビュー担当者が個別のタスクを承認または拒否できます。権限のないユーザーも、たとえば変更に対する意見を伝えるためにタスクをレビューできますが、タスクの承認ステータスには影響しません。
承認権限を持つユーザーは、レビュー担当者として追加されていなくても提案を承認できます。レビュー担当者リストは、承認を制限するためではなく、変更をレビューすべき担当者を把握するために使用してください。
オントロジーの提案では、レビュー担当者が提案の詳細を表示し、変更されたすべてのリソース、または特定のオントロジーリソースに対する変更を承認または拒否できます。
ポリシーの要件が満たされると、承認されたリソースは進行中から承認済みに変わります。ほかのすべてのチェックにも合格していれば、提案をマージできます。
このブランチをマージする
変更を main にマージする準備ができたら、Global Branching の提案をマージする必要があります。これにより、オントロジーのマージプロセスが自動的に開始されます。
マージするには、ブランチタスクバーのマージアイコンを選択するか、Global Branching の提案ページに移動してマージを選択します。
既知の制限事項
- データソースの削除：
mainブランチで元データソースが置き換えられたか削除されたオブジェクトタイプに競合が発生した場合、このブランチの変更を保持することを選択すると、マージに失敗します。この場合は、mainブランチの変更を選択します。 - 条件付き書式設定の削除：
mainブランチで条件付き書式設定のルールセットが置き換えられたか削除されたプロパティタイプに競合が発生した場合、このブランチの変更を保持することを選択すると、マージに失敗します。この場合は、mainブランチの変更を選択します。 - Pipeline Builder のオブジェクトタイプ： Pipeline Builder で作成されたオブジェクトタイプは、ブランチ上の Ontology Manager では変更できません。
- インデックス化は変更として扱われる： オブジェクトタイプのインデックス化は変更として扱われます。リソースがプロジェクトポリシーによって保護されている場合、このブランチをマージするにはポリシーに基づく承認が必要です。この要件を回避するには、マージする前にインデックス化の変更を取り除きます。
- レビュー担当者はすべてのオントロジーリソースに適用される： オントロジーの変更はまとめて扱われるため、1つのオントロジーリソースにレビュー担当者を追加すると、提案全体に追加されます。特定のリソースを承認する必要があるのは、そのリソースのプロジェクトポリシーに含まれるユーザーのみです。