資産タイプ

RealityTwin のアセットタイプは、作成時にアセットが保持するプロパティのセットを定義するために使用される定義済みのテンプレートです。アセットタイプをアセットに割り当てることで、関連するすべての事前定義プロパティが自動的にリンクされ、一貫性が確保され、強力な検索およびフィルタリング機能が有効になります。たとえば、「ポンプ」がアセットタイプとして定義されている場合、後でそのタイプでフィルタリングするだけで、プロジェクト内のすべてのポンプを検索できます。

アセットタイプとカテゴリの設定

アセットタイプを設定するには:

[組織設定] → [アセット設定] に移動します。
新しいアセットタイプ/カテゴリを作成するか、既存のアセットタイプ/カテゴリを編集します。
変更を加えたら、[ 公開] をクリックして適用します。

プロパティのセクションへの整理

アセットタイプ内では、プロパティを セクション にグループ化して、わかりやすさとデータ入力を向上させることができます。
各セクションには、1 つ以上の関連プロパティを含めることができます。

例：

識別:
技術仕様
監視と計測
メンテナンスとライフサイクル

プロパティ定義

アセットタイプで定義されている各プロパティには、次のものが含まれます。

キー – プロパティの名前/識別子。
値型 – プロパティが保持するデータの形式(次のようなもの):
- 番号(以下の more details を参照)
- 短いテキスト
- 愛着
- URL リンク
- トグル (ブール値)
- ドロップダウン (定義済みの選択肢は、以下の more details を参照)
- 統合項目 (外部システムにリンク)

手記
資産タイプ には、 これらのプロパティの実際の値は格納されません。
構造を定義するだけです。この値は、RealityTwin で資産が作成され、資産タイプが割り当てられるときに提供されます。

数値フィールドの単位の設定

[ 値タイプ] を [数値] に設定して新しいプロパティを作成する場合は、オプションで [単位] を定義できます。

単位フィールドは、任意のラベル (mm、°C、kg など) を入力できるフリーテキストフィールドです。
単位定義は資産タイプ構成の一部であり、そのタイプを使用するすべての資産に適用されます。

単位は、アセットのメタデータパネルに値が表示されるときにサ フィックス として機能します。

ドロップダウンオプションの設定

値タイプをドロップダウンに設定して新しいプロパティを作成すると、画面の右側にパネルが表示され、ドロップダウンオプションを定義できます。

各オプションを 別々の行 に入力します (各入力の後に Enter キーを押します)。
これらのオプションの編集は、プロパティの横にある オーバーフローメニュー をクリックし、[ 編集]ドロップダウンオプションを選択することで、いつでも編集できます。

外部統合によるプロパティの接続

通常のアセットタイプ設定に関しては、統合クエリにマッピングされるデータのセクションまたは個々のフィールドを作成できます。一般的な考え方は、特定のタイプのアセットがロードされるたびに、リンクが存在する場合は一連の統合クエリが生成されるということです。統合クエリが実行されると、結果はアセットタイプ内のセクションまたはフィールドに整理されます。

アセットタイプでプロパティをマッピングする前に、統合がすでに完全に設定されている必要があります。これには、統合サーバーのセットアップと外部システムとの接続の確立が含まれます。

ステップバイステップの手順については、 Integration Setup Documentationを参照してください。

統合セクションとフィールドについて

資産タイプは、外部システム(ERP、CMMSなど)からプロパティを自動的にリンクして入力する統合をサポートしています。統合を構成するには、主に 2 つの方法があります: 統合からのセクション & 統合フィールド。

統合クエリのセクション全体をアセットタイプのセクションにマップできます。たとえば、次のオブジェクトを返すクエリ:

{
  "TankLevel": {
    "value": 73.84190097508079,
    "uom": "%",
    "_p3d_type": "urn:primitive:obj:numeric"
  },
  "TankTemperature": {
    "value": 89.4061043417307,
    "uom": "degC",
    "_p3d_type": "urn:primitive:obj:numeric"
  }
}

アセットタイプのセクションに自動的にマッピングして、次のようにすることができます。

必要に応じて、クエリから 1 つの値を抽出し、1 つのフィールドにマップすることもできます。たとえば、圧力 834 を返す可能性のあるクエリは、次のように表され、通常の資産タイプフィールドと混在できます。

統合の構成セクション

統合から直接取得されるセクション全体を作成できます。

新しいセクションを追加するときに 、統合から を選択します。
目的の 統合リンクを選択します。
JSONPath を入力して、統合ペイロードのどの部分をこのセクションにバインドするかを定義します (詳細については、JSONPath Mapping を参照してください)。
このセクションには、リンクされた統合から取得したすべてのプロパティが自動的に入力されます。
統合からの更新は、同期設定に基づいてアセットのデータに反映されます。

構成統合フィールド

セクション全体をインポートする代わりに、個々のプロパティを統合にマッピングできます。

新しいプロパティを追加し、[ 値タイプ] を [統合] フィールドに設定します。
目的の 統合リンクを選択します。
JSONPath を入力して、統合ペイロードのどの部分をこのセクションにバインドするかを定義します (詳細については、JSONPath Mapping を参照してください)。
そのプロパティのみが外部システムと同期されます。

JSONPath マッピング

統合 からセクション と 統合フィールド の両方で、統合リンクによって返される JSON ペイロードからデータを選択するには 、JSONPath が必要です。

統合 (セクションレベルの JSONPath) から:
セクション全体にバインドするオブジェクトに解決される JSONPath を入力します。
例: $.Identificationは、Identificationオブジェクト全体をペイロードから [アセットタイプ] セクションにバインドします。
統合フィールド (プロパティレベルの JSONPath):
1 つのスカラー値 (文字列/数値/ブール値/日付) に解決される JSONPath を入力します。
例： $.Identification.serialNumber

ルールとヒント
JSONPath は標準構文に従います (JsonPath 構文の詳細については、 official RFCを参照してください)。
Prevu3Dは、個々のフィールドの複雑なオブジェクトや配列をサポートし ていません 。パスがオブジェクト/配列を返す場合は、それを単一の値(例: $.items[0].name)に絞り込むか、オブジェクト全体が必要な場合は[統合から]セクションに切り替えます。
JSONPath が統合のペイロードの構造と一致していることを確認してください。そうしないと、バインドされたフィールド/セクションは空で表示されます。

警告
統合のスキーマが変更された場合は、JSONPath を確認して更新し、マッピングの同期を維持します。

変更の公開

変更を公開すると、そのアセットタイプを使用している 既存のすべてのRealityAssetsにすぐに影響します 。

例えば：

プロパティの名前を変更すると 、リンクされているすべてのアセットについてプロパティが更新されます。
プロパティを削除すると 、リンクされたすべてのアセットからその値が削除されます。

警告
意図しないデータ損失を避けるために、慎重に作業を進めてください。

アクセス制御

デフォルトでは、 スーパー管理者のみが アセットタイプを管理できます。
role customizationを通じて、必要に応じて、これらの管理権限を追加のメンバーに付与できます。

アセットタイプを使用する利点

一貫性 – 同じタイプのすべての資産は、同じプロパティ構造を共有します。
検索可能性 – "すべてのポンプを表示" などのクエリを有効にします。
組織 – カテゴリとセクションにより、情報が明確でアクセスしやすくなります。
スケーラビリティ – あるタイプの将来のすべての資産のプロパティ定義を簡単に更新します。