产品定价 立即试用
社区版
文档 > 管理界面 > 资产
入门
指南 安装 架构 API 常见问题
目录

资产

资产是ThingsBoard物联网系统中的抽象实体,代表任何物理对象、空间或组织单位。 示例包括:建筑、房间、生产区域、场地、路灯、变电站或车辆。

资产的主要特征:

  • 本身不产生遥测数据,但可与产生遥测的设备关联。
  • 可有自身属性,如位置、类型或负责人。
  • 用于分组设备及其他实体。
  • 可参与层级结构,例如:变电站 ⟶ 线路 ⟶ 路灯。
  • 参与ThingsBoard业务逻辑,如规则链、告警和仪表板。

资产有助于以逻辑化、高效的方式组织物联网项目,便于管理和扩展。

ThingsBoard支持通过Web界面和REST API进行资产管理。


实践视频课程 🎥

观看本实践视频课程,了解如何配置和管理ThingsBoard仪表板、资源和设备,以及如何在实际场景中使用它们。

 

如何创建、编辑和删除资产

租户管理员及具有相应权限的用户可在ThingsBoard中创建、编辑或删除资产。

创建资产

创建新资产:

  • 进入 实体资产
  • 点击右上角的「+」图标,在下拉菜单中选择「添加新资产」。
  • 在资产创建表单中填写必填项:
    • 名称——资产的唯一名称。
    • 资产配置——默认使用「default」配置,可按需选择其他配置。
  • LabelDescription等可选字段可按需填写。
  • 点击「添加」。

资产创建成功后会在列表中显示。

编辑资产

编辑现有资产:

  • 资产列表中定位并点击目标资产。
  • 点击右侧的「铅笔」(✏️ 编辑)图标。
  • 在编辑窗口中可修改以下字段:
    • 名称
    • 标签
    • 资产配置
    • 描述
  • 修改完成后点击「应用更改」保存。

删除资产

删除资产:

  • 在列表中找到资产并点击其旁的"垃圾桶"图标。
  • 在弹出对话框中确认删除。

注意:删除资产不会删除与其关联的设备或其他实体,但会断开所有现有关系(如与设备、告警、仪表板等的关联)。

将资产设为公开

你可以将资产设为公开,使其数据对所有人可访问。 这适用于需要访问资产数据的公开演示仪表板或开放数据场景。

  • 点击目标资产旁的“Make asset public”图标。
  • 在弹窗中确认操作。

资产已公开。


如需取消公开并设为私有:

  • 点击资产旁的"使资产私有"图标。
  • 在弹出对话框中确认操作。

资产设为私有后将不再公开,引用它的公开仪表板也将无法访问其数据。

将资产分配给客户

你可以将资产分配给特定客户,以确保只有该客户相关用户可访问资产及其数据。

这是实现数据访问控制的关键步骤。客户用户只能看到自己被分配的资产,无法访问其他客户的资产或数据。

将资产分配给客户:

  • 在列表中找到目标资产。
  • 点击“Assign to customer”图标。
  • 从下拉列表选择目标客户。
  • 点击“Assign”确认。

该客户现在可访问资产及其数据。


之后可以按需取消分配或重新分配给其他客户。

  • 点击"从客户取消分配"图标。
  • 在弹出对话框中确认操作。

资产详情

点击资产可打开详情窗口,查看并管理该资产的各个方面。

复制资产ID
用于快速获取资产的唯一UUID。点击Copy asset Id即可复制到剪贴板。该ID用于API调用、集成与脚本。

属性

此选项卡显示与资产相关的客户端、服务端与共享属性,即静态或半静态键值对,如位置、类别、配置参数等元数据。

最新遥测

显示与资产关联的最新遥测值。遥测可来自关联设备,也可为建模手动添加。

  • 添加遥测:点击“+”图标,输入键名、值类型和值。
  • 删除遥测:点击垃圾桶图标,选择删除模式(全部数据、最新值、除最新外全部或按时间范围),并确认。

字段计算
显示通过公式基于现有属性或遥测计算得到的字段值,可在不修改设备固件的情况下派生参数。更多说明见字段计算

告警规则
包含为该资产配置的告警规则,可查看阈值、触发逻辑与告警动作。更多说明见告警规则

告警
显示与资产相关的全部当前及历史告警,用于跟踪警告、运行问题与关键事件。

事件
显示与资产相关的系统事件,如日志、警告、错误与生命周期活动,便于诊断与运维分析。

关系
显示该资产与设备、仪表板、资产、规则链等实体之间的有向关系,有助于理解系统结构中的交互关系。

审计日志
提供与资产相关的用户操作记录,包括创建、更新、配置变更与删除,用于审计与变更跟踪。

版本控制
支持使用基于Git的版本控制服务导出和恢复资产相关实体,用于备份、协作与配置版本管理。


管理资产关系:新增、查看、编辑、删除

在资产页面中,你可以创建、查看、编辑和删除资产与其他实体(资产、设备、客户等)之间的关系。详见实体与关系

管理指定资产与其他实体的关系:

新增关系:

  • 在Direction选择器中选择 From(出站)或 To(入站)。
  • 点击“+”图标(Add)。
  • Add relation 窗口中设置 Relation type(如 ContainsManages),并选择 To entity(实体类型与目标实体)。
  • 点击 Add 确认。
文档信息图标

说明: 关系有方向性。使用“From”定义从当前资产发出的关系,使用“To”查看指向当前资产的关系。

查看与筛选关系:

  • 在“From”与“To”之间切换查看出站/入站关系。
  • 使用搜索图标按关系类型或实体筛选。

编辑关系:

  • 在列表中点击“铅笔”图标修改关系类型或目标实体,然后 Save

删除关系:

  • 点击关系旁的“垃圾桶”图标并确认删除。
文档信息图标

说明: 删除关系不会删除关联实体,仅删除该关系。


后续步骤


您的反馈

欢迎在 GitHub 上为ThingsBoard点赞支持。 如有疑问,请联系我们