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

派生プロパティを設定する

ベータ版

オントロジーで定義する派生プロパティは、開発のベータ版段階にあり、お使いのエンロールメントでは利用できない場合があります。開発が進行中のため、機能が変更される場合があります。

派生プロパティは、リンクされたオブジェクトの値に基づいて実行時に計算されます。データを直接保存するのではなく、リンクタイプを介して接続されたオブジェクトから情報を取得し、必要に応じて平均、件数、値をリストに収集するなどの集計を適用します。

このページでは、Ontology Manager でオブジェクトタイプにオントロジーで定義する派生プロパティを設定する方法を説明します。派生プロパティとは何か、セキュリティをどのように継承するか、パフォーマンスに関する考慮事項については、派生プロパティの概要ドキュメントを参照してください。利用可能な集計の一覧については、派生プロパティのリファレンスドキュメントを参照してください。

派生プロパティを設定する

オブジェクトタイプに派生プロパティを設定するには、以下の手順に沿って進めます。

1. プロパティの設定パネルを開く

オブジェクトタイプのプロパティタブで、新しいプロパティを選択するか、既存のプロパティを選択して編集します。プロパティの設定サイドパネルが開きます。

派生プロパティの選択肢が表示されたプロパティのソースタブ。

2. ソースタブに移動する

プロパティの設定サイドパネルで、ソースタブを選択し、プロパティの値の取得元を設定します。

3. ソースタイプとしてリンクされたオブジェクトを選択する

ソースタイプセクションで、リンクされたオブジェクトの選択肢を選択します。これにより、派生プロパティを設定できるようになります。

4. リンクタイプを選択する

リンクされたオブジェクトセクションで、ドロップダウンメニューからリンクタイプを選択します。これにより、プロパティの値を取得するオブジェクトが決まります。

  • ドロップダウンメニューには、現在のオブジェクトタイプから利用可能なすべてのリンクタイプが表示されます。
  • リンクタイプを選択した後、必要に応じてさらにリンクタイプを追加し、複数階層の接続をたどることができます(最大3階層)。
  • さらに1階層先のリンクされたオブジェクトをたどるには、リンクされたオブジェクトを追加を選択します。
派生プロパティのリンクタイプを選択する。

5. 集計を設定する

リンクチェーン内のいずれかのリンクで、到達先のオブジェクトが2個以上になる可能性がある場合は、値を組み合わせるための集計を選択する必要があります。

  • カウント: リンクされたオブジェクトの件数を数えます。
  • 平均: 数値の平均を計算します。
  • 合計: 数値の合計を計算します。
  • 最小: 最小値を選択します。
  • 最大: 最大値を選択します。
  • おおよそのカーディナリティ: 一意の値の数を推定します。
  • 正確なカーディナリティ: 一意の値の正確な数を数えます。
  • リストを収集: 重複を保持したまま、値をリストに収集します。
  • セットを収集: 一意の値をセットに収集します。

リンクチェーン内のすべてのリンクで、到達先のオブジェクトが最大1個の場合、集計は任意であり、プロパティを直接選択できます。

集計で使用できるソースのプロパティタイプについて、詳しくはこちら。

派生プロパティの集計の種類を選択する。

6. 導出するプロパティを選択する

リンクタイプと集計(必要な場合)を選択した後、リンクされたオブジェクトタイプから導出するプロパティを選択します。

  • ドロップダウンメニューには、リンクチェーンの最後のオブジェクトタイプで利用可能なすべてのプロパティが表示されます。
  • カウント集計では、プロパティを選択する必要はありません。オブジェクトの件数が自動的に数えられます。

7. 収集上限を設定する

リストを収集またはセットを収集を選択した場合、任意で収集上限を設定できます。上限のデフォルトは 10 です。最大 100 まで引き上げることができます。

セットを収集では、上限が適用される前に重複が除去されます。この上限は、処理対象の値の総数ではなく、返される異なる値の数を制御します。

収集上限は、評価される値の数ではなく、返されるプロパティ値の数を決定します。収集したプロパティに対するフィルターや並べ替えは、値の_全体_を対象に実行されるため、返されるリストに含まれていない値のフィルターにオブジェクトが一致する場合があります。収集したプロパティで絞り込む前に、収集上限について確認してください。

収集した値は、単一の代表値に縮約できます。詳細については、プロパティリデューサーを参照してください。

マルチホップ派生プロパティ

派生プロパティは、リンクされたオブジェクトを最大3階層までたどることができ、起点となるオブジェクトタイプに間接的に接続されたオブジェクトからプロパティを導出できます。

たとえば、Department オブジェクトタイプは、Employee オブジェクトを経由して、それらにリンクされた Project オブジェクトをたどることで、プロジェクト名を導出できます。この場合、リンクチェーンは Department → Employee → Project になります。

マルチホップ派生プロパティを設定する。

マルチホップ派生プロパティを設定するには、以下の手順に沿って進めます。

  1. 最初のリンクタイプを選択します。
  2. リンクされたオブジェクトを追加を選択し、さらに1階層追加します。
  3. 新しく接続されたオブジェクトタイプから、次のリンクタイプを選択します。
  4. 合計で最大3階層まで繰り返します。

たどる階層が増えるたびに、クエリのパフォーマンスが低下する可能性があります。必要なデータに到達できる最小限の階層数にしてください。

別の派生プロパティから値を導出する必要がある場合は、代わりにソースデータを直接たどるマルチホップ派生プロパティを作成します。派生プロパティは、別の派生プロパティから値を取得できません。

派生プロパティを見分ける

派生プロパティは、プロパティタブでネイティブプロパティと並んで表示され、値が保存されるのではなく計算されることを示すインジケーターが付いています。

オブジェクトタイプのプロパティタブ。派生プロパティには、ネイティブプロパティと区別するためのインジケーターが付いています。

制限事項

派生プロパティには、プラットフォーム全体に適用される機能上の制限があり、主キー、必須プロパティ、Value Types、表示の書式設定、および OSv1 を使用してインデックス化されたオブジェクトタイプに関する制限が含まれます。すべての制限事項については、派生プロパティの制限事項を参照してください。