Thingsboard规则链：Related Entity Data节点详解

引言

在复杂的物联网（IoT）生态系统中，数据的集成与分析是实现高效管理和智能决策的基础。Thingsboard作为一个强大的开源物联网平台，其规则链（Rule Chains）机制允许用户构建自定义的数据处理流程。其中，“Related Entity Data”节点是一个关键组件，它使用户能够从消息的发起者或相关联的实体中获取更广泛的上下文数据，如遥测、属性、关系等，进一步丰富数据处理的灵活性和功能性。本篇文章将全面介绍Related Entity Data节点的特性、使用指南、底层原理概览，并通过实例应用场景深入探讨其价值所在。

ThingsBoard从入门到实战课程，深入透析底层原理，快速搭建自己的IOT平台_哔哩哔哩_bilibiliThingsBoard从入门到实战课程，深入透析底层原理，快速搭建自己的IOT平台共计14条视频，包括：1、ThingsBoard项目介绍、2、ThingsBoard前端Vue版本代码编译、3、ThingsBoard本地后端源码编译等，UP主更多精彩视频，请关注UP账号。https://www.bilibili.com/video/BV1CH36egEDM/?spm_id_from=333.999.0.0&vd_source=5b535ac3589f53abe431d7f6afc44ff4

相关实体数据节点概述

“Related Entity Data”节点是一种高级数据检索工具，它允许用户在规则链中动态地获取与当前消息所关联的实体（不仅仅是设备，也包括资产、客户等）的各类数据。这些数据可以是实时的遥测信息、静态的属性配置，甚至是实体之间的关系信息，为消息处理提供丰富的背景上下文，进而驱动更为复杂的业务逻辑。

具体作用

• 数据集成：整合多实体的遥测与属性，形成全局视图，便于进行跨设备或跨资产的分析。
• 动态决策：基于实体的实时状态或历史属性，智能调整处理逻辑，如设备故障预测或资源优化。
• 关系分析：探索实体间的关系网，比如设备归属的资产或负责的客户，以实现更精细的管理控制。

使用教程

1. 启动节点： 在Thingsboard Web界面中，进入“Rule Chains”部分，选择或创建一条规则链。从节点库拖动“Related Entity Data”节点到规则链编辑界面。

2. 配置节点参数：

   • 目标实体类型：选择要查询数据的实体类型，如设备（Device）、资产（Asset）、客户（Customer）。
   • 数据类型：指定要获取的数据类别，包括遥测（Telemetry）、属性（Attributes）、关系（Relations）。
   • 数据键：如果需要特定的数据项，填写对应的键名。
   • 关联策略：定义如何确定目标实体，可以基于直接关系、父级关系或其他自定义条件。

3. 数据处理： 设定如何处理获取的数据，如追加到消息体、更新元数据或用作条件判断的依据。

4. 连接其他节点： 使用连线工具，将此节点与下游的处理节点相连，如“Script”节点进行复杂逻辑处理，或“Notification”节点发送警报。

5. 测试与部署： 通过模拟或实际数据测试规则链，确认无误后，部署到生产环境。

源码逻辑概览

虽然直接深入源码细节可能对非开发人员来说过于技术化，但简要说明其核心逻辑涉及：

• 实体识别：根据消息中的起源实体和配置的关联策略，确定需要查询的目标实体列表。
• 数据请求：向Thingsboard的后台服务发起请求，获取指定实体类型和数据类型的集合。
• 数据映射：将后端返回的数据转换为规则链可处理的消息格式。
• 异常处理：包含错误捕获和重试逻辑，确保数据处理的健壮性。

应用场景与案例

智能楼宇能源管理系统案例

场景描述：通过综合分析各个楼层的用电设备数据，实现能源的智能分配与节能优化。

实施步骤：

1. 数据收集：各楼层设备（如空调、照明）的能耗数据通过“Originator Telemetry”节点收集。
2. 楼层属性获取：使用“Related Entity Data”节点，针对每个设备所属的楼层实体，获取其面积、使用时段等属性。
3. 能耗分析：在“Script”节点中，结合设备能耗和楼层属性，计算单位面积能耗比，识别能耗异常。
4. 策略调整：根据分析结果，通过“RPC Call”节点向智能控制系统发送指令，动态调整设备工作模式，实现节能。

工业物联网供应链优化案例

场景描述：通过追踪产品从原料到成品的全链条数据，优化供应链效率，减少库存积压。

实施步骤：

1. 设备状态监控：通过“Originator Telemetry”节点监控生产线上的设备状态与生产速率。
2. 供应链实体数据整合：利用“Related Entity Data”节点，收集产品、原材料、生产设备等实体的属性和关系数据，如批次号、供应商信息、加工进度。
3. 数据分析与决策：在“Aggregation”或“Filter”节点中，分析生产速率与供应链状态，识别瓶颈。
4. 通知与调整：通过“Notification”节点向供应链管理团队发送库存预警或生产调整建议，同时使用“RPC Call”节点调整生产计划。

结论

“Related Entity Data”节点作为Thingsboard规则链的核心组件之一，极大增强了物联网应用的数据处理能力和业务逻辑复杂度。通过其灵活的数据集成与分析能力，企业可以构建出高度定制化、智能响应的物联网解决方案。无论是提高运营效率、优化资源配置，还是增强用户体验，深入掌握并应用这一节点，无疑将推动物联网项目的成功实施与发展。随着物联网技术的不断演进，其应用场景还将持续扩展，为数字化转型注入新的活力。