数据采集与业务集成由三部分页面组成:采集绑定(配置读数写回到哪)、采集记录(查看设备上报的每条读数),以及 MQTT / CoAP 的接入监控页面。
采集绑定
菜单位置:「物联网 → 数据采集绑定」。通用采集写回使用 HTTP 接入。MQTT/CoAP 监控和行业事件有各自入口。
以表格形式展示已配置的绑定规则,每行包含:
| 列名 | 说明 |
|---|---|
| 设备 | 采集来源设备 |
| 指标 | 设备上报数据中的指标名,如 weight、rfid_count |
| 写回目标 | 数据要写入的业务对象与字段 |
| 目标记录 | 固定的盘点明细 ID。显示「按上报指定」时,目标由每次上报提供 |
| 阈值 | 上下限与单位;未设时只写回、不做异常检测 |
| 说明 | 备注 |
| 时间 | 创建时间 |
筛选条件:指标、说明
操作:创建、编辑、删除所选、刷新、文档、筛选
新建绑定的步骤
- 点击右上角「创建」
- 选择设备,填写设备指标——指标名必须与设备上报数据中的
metric完全一致,填错时系统不报错,但规则将无法匹配 - 选择写回对象,再选写回字段。两个下拉框的选项来自平台的可写回清单,选定后即符合可写回清单要求,不需要也不能手填。若提示「暂无可绑定的写回字段」,说明当前组织没有可用目标,请先在「基础设置 → 行业能力」确认行业是否已开通
- 在目标记录 ID 输入盘点明细的 24 位十六进制 ID,或留空由每次上报指定。上报指定的有效目标优先,未指定时才使用此处的固定目标。
- 需要异常检测时填上下限与单位;两端都留空则只写回、不发送超阈值提醒
- 点击「提交」并返回列表,核对设备、指标、字段和目标记录。示例指标为
m05_count,写回字段为盘点实盘数量,目标留空显示「按上报指定」。
删除绑定后,设备仍可正常上报,但读数不再写回业务单据,只会留在采集记录里。
采集记录
桌面端菜单位置:「物联网 → 数据采集记录」。只读列表,按时间倒序。
| 列名 | 说明 |
|---|---|
| 设备 | 上报设备 |
| 指标 | 设备上报的指标名 |
| 读数 | 数值与单位;超出阈值时标红 |
| 阈值 | 本条读数适用的上下限 |
| 绑定规则 | 「已指定」表示上报已指定绑定规则;「自动匹配」表示按设备与指标查找规则。两种提示均不代表写回成功 |
| 目标记录 | 上报指定的目标记录编号;为空时还需检查绑定中的固定目标 |
| 时间 | 上报时间 |
筛选条件:设备、指标
排查「设备已上报但业务单据未更新」时,先核对设备、指标和绑定规则。上报的目标 ID 无效时跳过写回。目标盘点明细须属于同一组织,且盘点单仍处于「盘点中」。到目标明细核对实盘数量,采集记录只反映读数已接收。
MQTT
从「物联网 → MQTT → 工作台」先看汇总,再按设备、服务器、主题和时间到「连接」「已发布」「订阅」查看同一次接入。连接或订阅的结束由设备端操作产生,监控页只读。传输确认与业务返回分别检查:收到发布确认仍可能因业务校验被拒绝。
连接管理
以表格形式展示 MQTT 连接列表,每行包含:
| 列名 | 说明 |
|---|---|
| 服务器 | MQTT服务器地址 |
| 连接设备 | 连接的设备名称 |
| 协议等级 | MQTT协议版本等级 |
| 状态 | 连接状态 |
| 创建时间 | 创建日期 |
筛选条件:服务器、状态、日期(起止)
查看记录、刷新、文档、筛选;监控记录仅供查询。
发布管理
以表格形式展示MQTT消息发布记录,每行包含:
| 列名 | 说明 |
|---|---|
| Topic | 消息主题 |
| QoS | 服务质量等级 |
| Retain | 是否保留消息 |
| 设备 | 发布消息的设备名称 |
| 服务器 | MQTT服务器地址 |
| 发布时间 | 发布日期 |
展开查看:payload(消息内容)、客户端响应
筛选条件:服务器、Topic、设备、发布时间(起止)
查看记录、刷新、文档、筛选;监控记录仅供查询。
订阅管理
以表格形式展示MQTT订阅列表,每行包含:
| 列名 | 说明 |
|---|---|
| Topic | 订阅的主题 |
| 服务器 | MQTT服务器地址 |
| 订阅设备 | 订阅的设备名称 |
| QoS | 服务质量等级 |
| Retain | 是否保留消息 |
| 状态 | 订阅状态 |
| 订阅时间 | 订阅日期 |
筛选条件:服务器、Topic、设备、状态、订阅时间(起止)
查看记录、刷新、文档、筛选;监控记录仅供查询。
主题管理
以表格形式展示MQTT主题列表,每行包含:
| 列名 | 说明 |
|---|---|
| Topic | 主题标识 |
| 关键字 | 主题关键字 |
| 摘要 | 主题描述 |
| 状态 | 主题状态 |
筛选条件:关键字、摘要、Topic、状态
操作:复制地址、删除、刷新、文档、筛选
CoAP
从「物联网 → CoAP → 发包记录」按设备和时间定位;核对方法、路径、协议响应码及独立业务结果。协议应答成功后,再到对应业务记录核对实际写入。
数据包管理
以表格形式展示CoAP请求/响应记录,每行包含:
| 列名 | 说明 |
|---|---|
| 请求描述 | 请求的描述信息 |
| 请求路径 | CoAP请求的URI路径 |
| 请求方法 | GET / POST / PUT / DELETE |
| 响应状态 | 服务器的响应状态码 |
| 设备 | 发起请求的设备名称 |
| 服务器 | CoAP服务器地址 |
| 请求时间 | 请求日期 |
展开查看:host、端口、payload、请求参数、请求头
筛选条件:服务器、请求描述、设备、请求时间(起止)
查看记录、刷新、文档、筛选;监控记录仅供查询。
把接入、回填和硬件分开检查
| 检查点 | 成功判据 |
|---|---|
| 通用采集 | HTTP 读数可在数据采集记录查到,并在指定的进行中盘点明细回读实盘值;这不会完成盘点或自动过账。 |
| 本地协议 | MQTT 查看连接、订阅、发布及对应业务结果;CoAP 对照数据包和业务结果。可由本地合成客户端验证这些现象。 |
| 实体设备、RFID 与打印 | 在现场分别核对实体设备上报、真实标签写入与读回,以及实际打印。软件标识、合成协议回执和手工登记不能证明实体动作已执行。 |