オントロジーロールの移行 [レガシー]

オントロジーロールは、データソース由来の権限に代わる、オントロジーリソース向けのレガシーの認可モデルです。オントロジーロールは、オブジェクトタイプ、リンクタイプ、アクションタイプに適用され、これらは「オントロジーリソース」と呼ばれます。共通プロパティタイプやインターフェースなど、オントロジーの最新機能を使用するには、オントロジーロールが必要です。2023年9月以降に作成されたすべての新しいエンロールメントでは、デフォルトでオントロジーロールが使用されています。

オントロジーロールでは、各オントロジーリソースとそのメタデータにロールを_直接_付与できます。すべてのメタデータ権限は Ontology Manager で管理されます。オントロジーロールでは、オントロジーリソース（Aircraft オブジェクトタイプなど）を、オブジェクトのインスタンス（オントロジーオブジェクトとして表現された特定の飛行機など）やリンクのインスタンスといった、リソースの_データ_から切り離すことができます。これらのデータのインスタンスは、引き続き入力データソースの権限によって制御されます。オントロジーの権限について詳しくはこちら。

各オントロジーは、1つ以上の Foundry 組織にリンクされています。

ロールの権限については、オントロジーロールのドキュメントで詳しく説明しています。

オントロジーリソースをオントロジーロールに移行する際、特定の順序に従う必要はありません。そのため、データソース由来の権限を使用するオブジェクトタイプと、オントロジーロールを使用するオブジェクトタイプが混在することも可能です。したがって、この移行においては、オブジェクトタイプを編集できることを次のように定義します。

• データソース由来の権限を使用するオブジェクトタイプ： ユーザーが、そのオブジェクトタイプの入力データソースに対して編集者権限を持っていること。
• オントロジーロールを使用するオブジェクトタイプ： ユーザーが、オブジェクトタイプに対してオントロジー編集者権限を持っていること。入力データソースに対する権限は必要ありません。この権限は、オントロジーリソースとそのメタデータの編集のみを許可し、データやデータソース自体に対する権限は付与しません。オブジェクトの_データ_（_メタデータ_ではありません）へのアクセスは、引き続き入力データソースに付与された権限によって制御されます。

オントロジーロールに移行する

エンロールメントでオントロジーロールが有効になっているものの、所有するオントロジーリソースをまだロール認可モデルに移行していない場合、Ontology Manager に移行を促すバナーが表示されます。 また、オントロジーリソースのテーブルを表示しているときに、所有するリソースのうち、まだ「元データソースと同じ権限」を使用しているものに絞り込むこともできます。

オントロジーロールは、まだすべての Foundry エンロールメントで利用可能ではありません。オントロジーロールにアクセスできない場合は、Palantir サポートにお問い合わせください。

前提条件

移行を実行するには、ユーザーは次の権限を持っている必要があります。

1. Foundry オントロジーで変更を行う権限。

2. 個々のリソースに対する次の権限。

   • オブジェクトタイプの場合、ユーザーは入力データソースに対する所有者権限を持っている必要があります。
   • 一対多のリンクタイプの場合、ユーザーに追加の権限は必要ありません。リンクタイプが参照する両方のオブジェクトタイプに対する閲覧者権限のみが必要であり、ユーザーはリンクタイプ自体またはオントロジーレベルで所有者である必要があります。
   • 多対多のリンクタイプの場合、ユーザーはリンクタイプの入力データソースに対する所有者権限も持っている必要があります。
   • アクションタイプの場合、追加の権限は必要ありません。

移行の通知

オントロジーロールへの移行は、Upgrade Assistant を通じて管理されます。専用の Upgrade Assistant タスクには、移行が必要なオントロジーリソースの一覧と、移行を実行する権限を持つ担当者が表示されます。Upgrade Assistant からリソースを開くと、Ontology Manager アプリケーション内で移行するために、そのリソースのセキュリティタブに移動します。

ユーザーがオントロジーロールを設定する権限を持っている場合、まだ移行していないオントロジーリソースは、セキュリティタブの移行インターフェースに表示され、初めてオントロジーロールを設定できます。オントロジーリソースの移行後は、セキュリティタブにオントロジーロールピッカーが表示され、オントロジー所有者が更新できます。

Ontology Manager を使用して移行する

オントロジーリソース（オブジェクトタイプ、アクションタイプ、リンクタイプ）をロールに移行する方法は2つあります。オントロジーリソースの一括移行と、すべてのオントロジーリソースを対象とした個別移行です。

オントロジーリソースを一括移行する

オントロジーリソースをロールに一括移行できます。続行する前に、前提条件の一覧を参照してください。一度に移行できるリソースは500個までです。

一括移行するには、Ontology Manager のアドバンスドに移動し、移行セクションで移行アシスタントで続行を選択します。

移行ウィザードが表示され、次のステップに沿って進めます。

1. リソースを選択： 同じロールを適用するすべてのオブジェクトタイプ、リンクタイプ、またはアクションタイプを選択します。以下の画像は、移行ウィザードでリソースを選択するインターフェースを示しています。

2. 関連リソース： このステップは、移行できる関連リソース（リンクタイプまたはアクションタイプ）がある場合にのみ表示されます。
3. ロールの割り当て： これらのオブジェクトタイプに割り当てるグループ/ユーザーとデフォルトロールを手動で設定できます。ロール移行ツールは、現時点ではロールの候補を一括で提示できません。ロールを付与する際は、ユーザーよりもユーザーグループを使用することを強く推奨します。アクションタイプを移行する際は、参照先のオブジェクトタイプと、そのアクションタイプがデプロイされているすべてのユースケースについて十分に理解しているユーザーにのみ権限を付与してください。
4. 概要： 概要を確認し、移行の影響を了承したうえで、移行を完了してロールを適用します。

一括移行の例外

一部のアクションタイプは、追加の手順を実行しなければ一括移行できません。

次の場合、アクションタイプをロールに移行できません。

• アクションタイプに、現在のユーザーの権限を確認する実行条件がありません。
  • 解決方法：Ontology Manager でアクションタイプのセキュリティと実行条件タブ（実行条件セクション）に現在のユーザーに基づく条件を追加し、オントロジーに保存してから、移行を再試行します。
• アクションタイプが関数を元にしており、移行前に @edits decorators を使用して再公開する必要があります。
  • 解決方法：デコレーターのドキュメントに記載されている手順を参照してください。

これらの問題に対処するには、アクションタイプページに移動し、元データソースと同じ権限で絞り込みます。問題のために移行されていないアクションタイプが表示されます。未解決の問題をすべて解決し、残っているアクションタイプの一括移行を再度実行します。

すべてのオントロジーリソースを個別に移行する

Ontology Manager のホームページで、移行するオントロジーリソース（オブジェクトタイプ、リンクタイプ、またはアクションタイプ）を選択し、セキュリティ設定を元データソースと同じ権限、権限を所有者として絞り込みます。

移行するエンティティを選択し、ヘッダーのロールに移行するまたはセキュリティタブのロールの使用を開始を選択します。

移行ウィザードが表示され、ロールの選択肢としてデータソースのロールとオントロジー管理者とデータソースのロールの2つが提示されます。これらの選択肢を使用すると、既存のオントロジーの設定に合わせたロールを使用し、設定できます。いずれかの選択肢を選択すると、ロール候補の一覧が事前入力されます。これらのロールは後で変更できます。

• データソースのロール： この選択肢は、入力データソースで編集者または所有者ロールを持つすべてのユーザーとユーザーグループを追加します。
• オントロジー管理者とデータソースのロール： この選択肢は、データソース由来の権限に基づいて、指定されたオントロジーリソースを現在変更できるすべてのユーザーを追加します。これらのユーザーは、オントロジー管理者ユーザーグループに属し、入力データソースで編集者または所有者ロールを持っています。

以下の画像は、移行ウィザードのロール候補を示しています。

希望するロール候補を選択し、提示されたオントロジーロールとオブジェクトタイプのデフォルトロールを確認して、必要に応じて変更します。次に、概要を確認し、影響を了承したうえで、移行を完了してロールを適用します。

以下の画像は、移行ウィザードでロールを割り当てる方法を示しています。

例外

次の場合、アクションタイプのロールへの移行を試行できないことがあります。

• アクションタイプに、現在のユーザーの権限を確認する実行条件がありません。
  • 解決方法：Ontology Manager でアクションタイプのセキュリティと実行条件タブ（実行条件セクション）に現在のユーザーに基づく条件を追加し、オントロジーに保存してから、移行を再試行します。
• アクションタイプが関数を元にしており、移行前に @edits decorators を使用して再公開する必要があります。
  • 解決方法：デコレーターのドキュメントに記載されている手順を参照してください。

これらの問題が解決されると、アクションタイプをロールに移行できます。

一部のオントロジーリソースが不要になった場合はどうすればよいですか？

対応が必要なオントロジーリソースが不要になった場合は、オントロジークリーンアップツールを使用してリソースを削除できます。このツールを使用すると、さまざまな条件（たとえば、データソースがゴミ箱に移動されているか、非推奨日を過ぎているか、インデックス化に失敗しているか、オントロジーロールを使用しているかどうかなど）に基づいて、安全に削除できるオブジェクトタイプを特定できます。

関数ベースのアクションタイプを移行する

関数ベースのアクションタイプでは、元となる関数を移行する必要があります。Foundry は関数の自動移行を試みるため、アクションタイプも移行できるようになります。ただし、一部の関数は自動で移行されない場合があり、関数内で編集対象のオブジェクトタイプを手動で宣言する必要があります。アクションタイプをオントロジーロールに移行した後、関数ベースのアクションに失敗が発生する場合は、FAQ セクションを確認してください。

移行に関するよくある質問

オブジェクト対応アプリケーションに変更はありますか？

入力データソースへの閲覧者アクセス権がないために以前は閲覧できなかったオブジェクトタイプやリンクタイプのメタデータに、Ontology Manager でアクセスできるようになる場合があります。ただし、入力データソース内のデータにアクセスできるようになるわけではありません。データへのアクセスは常に、そのデータソースのロールによって管理されます。閲覧できるメタデータの詳細は、ユーザーのオントロジーロールによって決まります。

Object Explorer でも、オブジェクトタイプが移行されると、Object View を編集する際の権限チェックが更新されます。オブジェクトタイプの移行前は、Object View を編集するには、ユーザーが Object View 管理者グループに所属し、入力データソースへの編集者アクセス権を持っている必要があります。オブジェクトタイプの移行後は、Object Explorer はユーザーがオブジェクトタイプ自体に対するオントロジー編集者権限を持っていることのみを確認します。

移行後に失敗する関数ベースのアクションを解決するにはどうすればよいですか？

オントロジー編集関数が編集するオブジェクトタイプを Foundry が自動検出できなかった場合、アクションは実行後に次のエラーで失敗します。

このエラーを解決するには、Functions のドキュメントで説明されている手順に沿って進めてください。