Derived series

derived seriesを使用すると、ユーザーは計算やトランスフォームを保存し、非derivedなtime seriesに通常適用される変換を複製することができます。このデータをPalantirリソースとして保存することで、derived seriesはオントロジーに共有および保存できます。一度オントロジーに保存されると、derived seriesは非derivedなtime seriesと同じように動作しますが、リアルタイムで計算されます。これにより、derivedデータの管理やプラットフォーム全体での計算の重複が不要になります。

以下のガイドでは、Quiverでderived seriesを作成し、プラットフォームで使用するためにオントロジーに保存する方法を説明します。

要件

以下のセクションでは、derived seriesを作成する際に従うべき要件を説明します。

論理要件

1. derived seriesのロジックはルートオブジェクトタイプに対してテンプレート化されているため、_単一_のルートオブジェクトで動作する必要があります。ロジックが別のオブジェクトタイプのtime series入力を必要とする場合、そのオブジェクトタイプは_センサー_オブジェクトタイプとして設定されている必要があります。

たとえば、QuiverのObject time series property cardでは、現在のオブジェクトタイプのtime seriesプロパティだけでなく、そのセンサーオブジェクトタイプのtime seriesデータも選択できます。

2. リンクされたセンサーでderived seriesを作成する場合、手動で検索するのではなく、Quiverのルートオブジェクトタイプからアクセスする必要があります。

3. time seriesプロパティ以外のプロパティリファレンスは、Time series formulaカードで@記号を使用して直接参照されている場合にのみテンプレート化されます。

権限要件

derived seriesを保存するには、バインドされたオブジェクトタイプに対するオブジェクトタイプ編集権限が必要です。

自動オントロジー保存を使用するには、必要なセンサーオブジェクトタイプとアクションタイプを設定するために同じ権限が必要です。また、アクションタイプの提出基準を満たす必要があります。さらに、ルートオブジェクトタイプとセンサーオブジェクトタイプの両方のオブジェクトを表示できる必要があります。制限付きビューのデータソースを持つオブジェクトタイプもサポートされていますが、ユーザーがルートオブジェクトを表示できる場合、リンクされたすべてのセンサーオブジェクトも表示できる必要があります（その逆も同様です）。

自動オントロジー保存のためのセンサーオブジェクトタイプ要件

1. オントロジーへの自動保存に使用されるセンサーオブジェクトタイプの主キーはStringタイプである必要があります。
2. センサーオブジェクトタイプはObject Storage V2で保存される必要があります。これは、アクションがtime seriesプロパティに書き込むために必要です。
3. センサーオブジェクトタイプは編集が有効である必要があります。
4. ルートオブジェクトタイプとセンサーオブジェクトタイプの間に、ルートオブジェクトタイプが「one」側にある単一の1対多のカーディナリティリンクが存在する必要があります。

自動オントロジー保存のためのアクションタイプ要件

derived seriesをオントロジーに自動保存するには、センサーオブジェクトタイプのアクションを介して行われます。

以下の要件のいずれかが満たされない場合、自動オントロジー書き込みのためのアクションタイプを選択することはできません。

1. 各アクションタイプには単一のルールが必要です。
2. アクションタイプのパラメーターは、提供できる値を制限する制約を使用してはなりません。同様に、アクションタイプのパラメーターは、値の制約をもたらすオーバーライドを使用してはなりません。これらは、制約が合理的であっても厳密に禁止されています。
3. アクションタイプには未使用のパラメーターがないこと。未使用のパラメーターは必須として構成することはできません。
4. 値が提供されていないプロパティは未マッピングと見なされます。未マッピングのセンサーオブジェクトプロパティのパラメーターは「必須でない」として構成する必要があります。ルートオブジェクトタイプ用でないセンサーオブジェクトタイプの外部キーのプロパティは常に未マッピングです。
5. アクションタイプの提出基準には、パラメーターに基づく条件を使用してはなりません。

作成、修正、削除の3つのアクションタイプを別々に作成する必要があります。これらのアクションタイプのルールは以下に記載されています。

Create objectアクションタイプ

ルール: 各プロパティタイプは同じタイプのパラメーターを使用し、オブジェクトタイプのすべてのプロパティを編集します。Ontology Managerを使用してアクションタイプを設定する場合、左のFormタブから主キー用の文字列パラメーターを手動で作成する必要があります。

Modify objectアクションタイプ

ルール: Create objectアクションタイプと同様に、Modify objectアクションタイプは関連するプロパティタイプと同じタイプのパラメーターを使用し、主キー以外のすべてのプロパティを編集する必要があります。

Delete objectアクションタイプ

ルール: Delete objectアクションタイプはセンサーオブジェクトタイプを削除するように構成します。さらなるプロパティまたはパラメーターの構成は必要ありません。

次のセクションでderived seriesを作成する方法についてさらに学びましょう。