跳转至

实体和关系

实体概览

YiCONNECT 提供用户界面和 REST API 来配置和管理 IoT 应用程序中的多种实体类型及其关系。支持的实体有:

  • 租户 - 您可以将租户视为一个独立的业务实体:它是拥有或生产设备和资产的个人或组织;租户可能拥有多个租户管理员用户以及数百万个客户、设备和资产;
  • 客户 - 客户也是一个独立的业务实体:购买或使用租户设备和资产的个人或组织;客户可能拥有多个用户和数百万台设备和资产;
  • 用户 - 用户能够浏览仪表板并管理实体;
  • 设备 - 可以生成遥测数据并处理 RPC 命令的基本 IoT 实体。例如,传感器、执行器、开关;
  • 资产 - 可能与其他设备和资产相关的抽象物联网实体。例如工厂、场地、车辆;
  • 实体视图 - 如果您只想向客户共享部分设备或资产数据,则非常有用;
  • 警报 - 识别您的资产、设备或其他实体存在问题的事件;
  • 仪表板 - 物联网数据的可视化以及通过用户界面控制特定设备的能力;
  • 规则节点 - 传入消息、实体生命周期事件等的处理单元;
  • 规则链- 定义规则引擎中的处理流程。可能包含许多规则节点以及到其他规则链的链接;

每个实体支持:

  • 属性 - 与实体关联的静态和半静态键值对。例如序列号、型号、固件版本;
  • 时间序列数据 - 可用于存储、查询和可视化的时间序列数据点。例如温度、湿度、电池电量;
  • 关系 - 与其他实体的定向连接。例如包含、管理、拥有、生产。

一些实体支持配置文件:

  • 租户配置文件 - 包含多个租户的通用设置:实体、API 和速率限制等。每个租户在单个时间点都有唯一的配置文件。
  • 设备配置文件 - 包含多个设备的通用设置:处理和传输配置等。每个设备在单个时间点都有唯一的配置文件。
  • 资产配置文件 - 包含多个资产的通用设置:处理配置等。每个资产在单个时间点都有唯一的配置文件。

本指南提供了上面列出的功能的概述、一些获取更多详细信息的有用链接以及它们的使用的实际示例。

关系

实体关系定义属于同一租户的两个 YiCONNECT 实体之间的连接。该关系具有任意类型:包含、管理、支持等。该关系也是有向的。您可以将 YiCONNECT 关系视为面向对象编程中的Has-a关系。

关系有助于在 YiCONNECT 中对物理世界对象进行建模。理解它们的最简单方法是使用示例。假设我们想要构建一个应用程序,从土壤湿度和温度传感器收集数据,在仪表板上可视化这些数据,检测问题,发出警报并控制灌溉。我们还假设我们想要支持具有数百个传感器的多个领域。