注: 以下の翻訳の正確性は検証されていません。AIPを利用して英語版の原文から機械的に翻訳されたものです。
派生プロパティは、ほかのプロパティやリンクされたオブジェクトからクエリ時に値が計算されるプロパティです。値を保存するのではなく、リンクをたどってリンクされたオブジェクトからプロパティを選択する、多数のリンクされたオブジェクトを集計する、算術演算で値を組み合わせるといった、値の計算方法を定義します。
派生プロパティは保存されるのではなく計算されるため、基になるデータが変化しても正しい値を維持します。たとえば、リンクされた Employee オブジェクトを数える派生プロパティには、入社や退職が自動的に反映され、パイプラインを再実行したり、更新ロジックを保守したりする必要はありません。
派生プロパティは、次の3つの方法のいずれかで値を計算できます。
Department オブジェクトタイプで、リンクされた Employee オブジェクトの平均給与を公開できます。Employee オブジェクトタイプで、リンクされた単一の Employee オブジェクトから選択した上司の名前を公開できます。Employee オブジェクトタイプで、salary と bonus を足し合わせて計算した報酬総額を公開できます。派生プロパティは読み取り専用です。アクションや関数では編集できず、オブジェクトストレージにも保存されません。
派生プロパティは、オントロジー内または実行時に定義できます。どちらの形式を使用するかによって、設定する場所、ほかに誰が参照できるか、利用可能な機能が決まります。

| オントロジーで定義 | 実行時に定義 | |
|---|---|---|
| 設定場所 | Ontology Manager | Workshop モジュール、Insight ワークブック、またはオントロジー SDK リクエスト |
| 格納先 | オントロジー定義 | オブジェクトセット定義 |
| 公開範囲 | オブジェクトタイプのすべての利用元 | 定義を宣言するリクエストまたはモジュール、およびその定義を含む保存済みオブジェクトセットにアクセスできるユーザー |
| リンク走査の最大回数 | 3 | Workshop、Insight:1、オントロジー SDK:固定の上限なし |
| 式 | 非対応 | 対応 |
| 開発状況 | ベータ版 | 一般提供 |
オントロジー定義の派生プロパティは、開発のベータ版フェーズにあり、お使いのエンロールメントでは利用できない場合があります。活発に開発が進められている間は、機能が変更される場合があります。実行時定義の派生プロパティは一般提供されています。
計算が組織におけるオブジェクトタイプのモデル化の一部であり、すべての利用側で参照できる必要がある場合は、オントロジー定義の派生プロパティを使用します。計算が単一のアプリケーションや分析に属する場合、または算術式や日付式が必要な場合は、実行時定義の派生プロパティを使用します。
利用可能な集計と式の完全な一覧については、派生プロパティのリファレンスを確認してください。
リンクベースの派生プロパティは、リンクされたオブジェクトから値を選択または集計します。オントロジー定義と実行時定義のどちらの派生プロパティも、リンクベースの計算をサポートしています。
式は、ネイティブプロパティ、またはリンクや集計による派生プロパティを使用して、算術計算や日付計算を行います。式は、実行時定義の派生プロパティでのみ利用できます。計算プロパティは、同じ withProperties 操作で宣言された別の計算プロパティを参照できません。代わりに、依存するプロパティを後続の操作で宣言します。
| アプリケーション | 対応状況 |
|---|---|
| Ontology Manager | オブジェクトタイプで、オントロジーで定義される派生プロパティを設定します。 |
| Workshop | オントロジーで定義された派生プロパティを使用するか、一部のウィジェット向けに、実行時に定義される派生プロパティをモジュールレベルで定義します。 |
| オントロジー SDK | オントロジーで定義された派生プロパティを使用するか、withProperties 操作で実行時に定義される派生プロパティを定義し、結果、フィルター、並べ替え、および集計で使用します。 |
| Insight | オントロジーで定義された派生プロパティを使用するか、実行時に定義される派生プロパティをテーブル分析に追加します。 |
TypeScript オントロジー SDK(OSDK 2.x)では、@osdk/client パッケージのサポート対象の最小バージョンは 2.2.0-beta.x です。リンクされたオブジェクトからのプロパティの選択、および算術式や日付式の使用には、バージョン 2.4.0 以降が必要です。詳細については、Developer Console の API ドキュメントを確認してください。
派生プロパティは、その計算に使用されるすべてのオブジェクトからセキュリティを継承します。アクセスチェックは、複数ホップの走査における中間オブジェクトも含め、計算に使用される各オブジェクトに対して、値が組み合わされる前に適用されます。
そのため、2人のユーザーに、同じオブジェクトの同じ派生プロパティについて異なる値が表示される場合があります。ユーザーごとの計算値には、そのユーザーに閲覧が許可されているソースオブジェクトと中間オブジェクトだけが反映されます。

値をリストやセットに収集する集計では、収集された各値のセキュリティマーキングが保持されるため、リスト内の個々の値にそれぞれのマーキングが付与されます。詳細については、プロパティのセキュリティマーキングを確認してください。
派生プロパティの値は、保存やインデックス化されるのではなく、クエリ時に評価されます。ただし、プラットフォームは、基になるオブジェクトのインデックスにフィルターをプッシュダウンすることで多くのクエリを最適化し、派生値を計算する前に処理が必要なデータを削減できます。
パフォーマンスは、フィルター適用後に残るオブジェクトの数、リンクされたオブジェクトの数と中間結果のサイズ、集計の種類、およびリンクをたどる回数によって異なります。派生値による絞り込みや並べ替えでは、通常、残っている候補オブジェクトについてその値を計算する必要があります。クエリによっては、一部の結合や集計もプッシュダウンできます。
実行のしきい値、フォールバック動作、クエリ設計のガイダンスについては、オントロジークエリの制限を確認してください。派生プロパティのクエリのコンピュートコストについては、クエリのコンピュート使用量を確認してください。派生プロパティとパイプラインで事前計算した値のどちらを選択するかについては、オントロジー構造のガイダンスを確認してください。
リストを収集とセットを収集の集計では、返す値の数に上限を設定できます。この上限は返される内容を制御しますが、プラットフォームが評価する対象を制限するものではありません。
収集されたプロパティに対するフィルター、並べ替え、集計は、切り詰められたリストではなく、値の完全な集合を対象に実行されます。そのため、受け取ったリストに含まれていない値によって、オブジェクトがフィルターに一致する場合があります。
収集されたプロパティに対するフィルターは、コレクションの上限内の値だけでなく、基になるすべての値をチェックします。つまり、フィルターの条件を満たした値が返されたリストに含まれていなくても、一致する場合があります。返されるリストは上限に合わせて切り詰められますが、フィルターの対象は制限されません。リデューサーも同様に動作します。リデューサーはコレクションの上限を 1 に設定することと同等ですが、返す1個の縮約値だけでなく、構成要素となるすべての値に対してフィルターを適用します。

派生プロパティは活発に開発が進められており、オントロジー定義の派生プロパティはベータ版です。以下の制限事項は、現在の動作を反映しています。
withProperties 操作内で宣言された別の式を参照することはできません。代わりに、依存する式を後続の withProperties 操作で宣言します。