资产类型

RealityTwin 中的资产类型是预定义的模板，用于定义资产在创建时将携带的一组属性。通过为资产分配资产类型，所有相关的预定义属性都会自动关联，确保一致性并启用强大的搜索和筛选功能。例如，如果将 “Pump” 定义为资产类型，你以后只需按该类型筛选即可搜索项目中的所有泵。

配置资产类型和类别

要配置资产类型：

转到组织设置 → 资产设置
创建新的资产类型/类别或编辑现有的资产类型/类别。
进行更改后，点击 Publish 以应用它们。

类别

资产类型可以归类到类别下以便更好地组织。
类别纯粹是结构性的——它们本身不携带属性，但有助于组织相关的资产类型。

示例：

Mechanical（类别）
- Pump（资产类型）
- Motor（资产类型）
- Valve（资产类型）

你可以通过按资产类型页面右上角的 “New” 按钮创建新类别。

将属性组织到分区中

在资产类型内，属性可以分组到分区中，以提高清晰度和数据录入效率。
每个分区可以包含一个或多个相关属性。

示例：

Identification：
Technical Specifications
Monitoring & Instrumentation
Maintenance & Lifecycle

属性定义

资产类型中定义的每个属性包括：

Key —— 属性的名称/标识符。
Value Type —— 属性将保存的数据格式，例如：
- 数字（请参阅下面的更多详情）
- 短文本
- 附件
- URL 链接
- 切换（布尔值）
- 下拉菜单（预定义选项，请参阅下面的更多详情）
- 集成字段（链接到外部系统）

为数字字段配置单位

创建 Value Type 设置为 Number 的新属性时，你可以选择性地定义单位。

单位字段是一个自由文本字段，你可以在其中输入任何标签（例如 mm、°C、kg）。
单位定义是资产类型配置的一部分，适用于使用该类型的所有资产。

当值显示在资产的元数据面板中时，单位充当后缀。

配置下拉选项

创建 Value Type 设置为 Dropdown 的新属性时，屏幕右侧会出现一个面板，允许你定义下拉选项。

在单独的行上输入每个选项（每次输入后按 Enter）。
你可以随时通过点击属性旁边的溢出菜单并选择 Edit dropdown options 返回编辑这些选项。

将属性与外部集成连接

对于常规资产类型配置，可以创建映射到集成查询的数据分区或单个字段。总体思路是，每当加载特定类型的资产时，如果存在任何链接，就会生成一组集成查询。当集成查询执行时，结果将组织到资产类型内的分区或字段中。

在资产类型中映射属性之前，集成必须已经完全配置。这包括设置集成服务器并与外部系统建立连接。

有关分步说明，请参阅我们的集成设置文档。

关于集成分区和字段

资产类型支持集成，以自动链接和填充来自外部系统（例如 ERP、CMMS）的属性。配置集成主要有两种方式：Section from integration 和 Integration field。

可以将集成查询的整个分区映射到资产类型的分区。例如，返回此对象的查询：

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

可以自动映射到资产类型的一个分区，如下所示：

如果需要，也可以从查询中提取单个值并映射到单个字段。例如，可能返回压力值 834 的查询可以这样表示，并与常规资产类型字段混合：

来自集成的配置分区

你可以创建一个直接来自集成的整个分区：

添加新分区时选择 From Integration。
选择所需的 Integration Link。
输入 JSONPath 以定义集成有效负载的哪一部分应绑定到此分区（有关详情，请参阅 JSONPath 映射）。
该分区将自动填充从链接的集成检索的所有属性。
来自集成的任何更新都将根据同步配置反映在资产的数据中。

配置集成字段

你可以将单个属性映射到集成，而不是导入整个分区：

添加新属性并将 Value Type 设置为 Integration field。
选择所需的 Integration Link。
输入 JSONPath 以定义集成有效负载的哪一部分应绑定到此分区（有关详情，请参阅 JSONPath 映射）。
只有该属性会与外部系统同步。

JSONPath 映射

From Integration 分区和 Integration field 都需要 JSONPath 来从 Integration Link 返回的 JSON 有效负载中选择数据。

From Integration（分区级 JSONPath）：
输入一个解析为你想要绑定到整个分区的对象的 JSONPath。
示例： $.Identification 将有效负载中的整个 Identification 对象绑定到你的资产类型分区。
Integration field（属性级 JSONPath）：
输入一个解析为单个标量值（字符串/数字/布尔值/日期）的 JSONPath。
示例： $.Identification.serialNumber

发布更改

发布更改将立即影响所有使用该资产类型的现有 RealityAsset。

例如：

重命名属性将为所有链接的资产更新它。
删除属性将从所有链接的资产中移除其值。

访问控制

默认情况下，只有 Super Admin 可以管理资产类型。
通过角色自定义，如有需要，可以将这些管理权限授予其他成员。

使用资产类型的好处

一致性 —— 相同类型的所有资产共享相同的属性结构。
可搜索性 —— 支持诸如”显示我所有的泵”之类的查询。
组织性 —— 类别和分区使信息清晰易访问。
可扩展性 —— 轻松为某个类型的所有未来资产更新属性定义。