1. 课程概述:ThingsBoard规则链简介、调用外部HTTP服务的价值、课程目标与前置知识
1.1 ThingsBoard规则链简介
ThingsBoard规则链是平台核心的事件处理引擎,它允许用户通过可视化拖拽的方式构建业务逻辑,对设备上报的数据进行过滤、转换、持久化与外部系统集成。规则链由一系列相互连接的节点(Node)组成,每个节点执行特定的处理动作,数据以消息(Message)的形式在节点间流动。
核心概念:规则链本质是一个有向无环图(DAG),消息从根节点(Root Chain)进入,经过规则引擎节点的处理,最终到达输出节点或终止。每个节点可以产生成功(Success)与失败(Failure)两条链路,实现分支逻辑。
规则链节点分为六大类:
| 节点类别 | 典型节点 | 功能描述 |
|---|---|---|
| Filter(过滤器) | Message Type Filter, Script Filter | 根据消息类型、属性或脚本条件决定消息流向 |
| Transformation(转换器) | Script Transformation, Originator Attributes | 修改消息体、元数据或原始信息 |
| Action(动作) | Log, Save to Telemetry, RPC Call Request | 执行持久化、日志记录或远程过程调用 |
| External(外部集成) | REST API Call, Kafka, MQTT, Send Email | 与外部系统进行HTTP、消息队列或邮件交互 |
| Enrichment(丰富器) | Originator Telemetry, Customer Attributes | 从数据库或上下文获取额外数据附加到消息中 |
| Split & Join(拆分与合并) | Split Array, Message Aggregator | 处理数组消息的拆分与多路消息的合并 |
1.2 调用外部HTTP服务的价值
在物联网解决方案中,ThingsBoard很少独立运行,它需要与企业的业务系统(ERP、CRM、MES)、第三方API(天气、地图、短信网关)或云服务(AWS Lambda、Azure Functions)进行数据交换。规则链中的REST API Call节点提供了这一能力,其核心价值体现在:
- 数据联动:设备告警触发后,自动调用企业/钉钉机器人发送通知。
- 业务闭环:设备数据经过规则链处理后,将结果写入外部数据库或业务系统。
- 能力扩展:利用外部AI服务(如OCR、语音识别)对设备上传的图片或音频进行分析。
- 状态同步:设备属性变更时,通过HTTP PUT请求同步到第三方设备管理平台。
典型场景:温度传感器上报超阈值数据 → 规则链过滤 → REST API Call节点 → 调用企业Webhook → 运维人员收到告警卡片。整个过程无需编写一行后端代码,全部在ThingsBoard UI中配置完成。
1.3 课程目标
通过本课程的系统学习,学员将掌握以下核心能力:
| 能力维度 | 具体目标 | 对应章节 |
|---|---|---|
| 基础认知 | 理解规则链架构与REST API Call节点工作原理 | 第1-3章 |
| 配置能力 | 独立完成HTTP请求的Method、URL、Headers、Body配置 | 第4-6章 |
| 安全集成 | 掌握Basic Auth、Bearer Token、API Key等认证方式 | 第7-9章 |
| 数据处理 | 使用脚本节点预处理请求数据与解析响应结果 | 第10-13章 |
| 异常处理 | 设计超时重试、错误分支与告警通知机制 | 第14-17章 |
| 实战项目 | 完成3个端到端项目:告警推送、数据同步、AI服务调用 | 第18-26章 |
| 性能优化 | 掌握队列配置、并发控制与日志调试技巧 | 第27-30章 |
1.4 前置知识
为了确保学习效果,建议学员具备以下基础:
- ThingsBoard基础:了解设备配置、遥测数据、属性概念,能完成设备接入与数据查看。
- HTTP协议基础:熟悉GET/POST/PUT/DELETE方法、状态码(200/400/500)、JSON格式。
- 基础脚本能力:了解JavaScript基本语法(变量、函数、对象),规则链中的Script节点使用JS引擎。
- 环境准备:已部署ThingsBoard CE/PE 3.5+版本,或使用官方Demo环境;准备一个可调用的外部HTTP服务(如Postman Mock Server、本地Flask服务)。
注意:如果对ThingsBoard设备接入尚不熟悉,建议先学习官方文档的“Getting Started”章节。本课程默认学员已具备设备注册与数据上报能力,重点聚焦规则链的HTTP集成部分。
1.5 课程知识体系
本课程采用“基础→进阶→实战→优化”四阶段递进式结构,共30章,覆盖从原理到生产部署的全链路知识: