本IOT中继平台面向业务平台提供数据转发功能,通过转发配置把从设备侧采集读取的数据转发到对应的业务平台或应用服务。数据转发有三种方式:
1)、http转发:通过http协议把数据转发至用户的http业务平台。
2)、kafka转发:把数据推送至用户部署的kafka消息服务器。
3)、RabbitMQ转发:把数据推送至用户部署的RabbitMQ消息服务器。
数据转发功能的使用需要先到本IOT中继平台–数据转发配置界面,根据界面配置要求选择要转发的数据的设备,选择转发属性或事件数据类型,选择转发方式,填写转发目标服务器鉴权账号和口令等参数保存配置即可。
数据转发鉴权是指本IOT中继平台转发数据需要连接目标服务器,目标服务器的鉴权要求。转发至用户的http业务平台,需要提供访问http业务平台的账号口令,访问地址等鉴权信息。
关于http协议转发,本IOT中继平台提供了两种鉴权服务支持,一是用户名+密钥基础认证方式;二是HTTP Bearer Token认证方式。
关于kafka、RabbitMQ转发,只需要按转发配置界面要求填写相应的服务器连接地址、端口号、账号和口令即可。
数据转发配置操作具体到数据转发配置界面进行。
数据转发topic: 关于数据转发topic,如果选择http协议转发,系统需要配置数据转发的请求地址,此请求地址后面的一串字符即为http协议转发的topic。 比如:设备温度属性的数据的转发地址为 “http://127.0.0.1:80/aaaa”,在此处的“/aaaa” 即为http协议转发的topic。这个topic需要在数据转发配置界面配置转发的数据明细时填写, 这个topic地址需要转发的目标业务平台提供。
特别说明:http转发,请求提交方法统一为post请求。
关于kafka、RabbitMQ转发,数据转发的topic格式为在本IOT中继平台–数据转发配置–选择转发明细项时填写的对应的topic 。
数据转发消息体内容为json格式数据,需要应用端平台对josn数据解析。
转发的消息体格式样例:
{ "createTime": "2023-11-26 23:11:16", "dataName": "温度", "dataResource": "1", "iotRelayDeviceSn": "202403200101001", "deviceId": "44080000001111000015", "forwardingDataType": "2", "integerValue": "19", "measurementUnit": "度", "propertiesId": "P_1697276433454", "propertiesValueDataType": "integer_value", "scaleFactor": "10" }
消息体参数说明:
参数名 | 类型 | 描述 |
---|---|---|
createTime | datetime | 数据时间 yyyy-mm-dd hh:mm:ss 格式 |
dataName | string | 数据属性名称,如黄色 "温度"为对应值 |
dataResource | integer | 数据来源类型(1、读;3、上报 ) |
iotRelayDeviceSn | string | IOT中继宝盒设备编号,黄色为IOT中继宝盒设备编号标识值 “202403200101001” |
deviceId | string | 接入设备ID标识,黄色为接入设备ID标识值 “44080000001111000015” |
forwardingDataType | integer | 转发数据类别:1、上报属性数据 2、读取的属性数据 3、上报的事件数据 |
integerValue | integer | 整型数据值标识, 如黄色值"19" |
propertiesValueDataType | string | 值数据类型标识,对应(integer_value/long_value/float_value/double_value/string_value/date_value/time_value/json_value) |
measurementUnit | string | 单位(如:度、米、转每分钟、流量单位、功率单位等) |
scaleFactor | integer | 数据精度(缩放因子),如黄色值"10" |
propertiesId | string | 物模型属性ID标识,黄色为接入设备物模型属性ID标识值 “P_1697276433454” |
{ "createTime": "2023-11-26 23:11:16", "dataName": "故障关机", "dataResource": "3", "iotRelayDeviceSn": "202403200101001", "deviceId": "44080000001111000017", "eventId": "E_1697248913306", "forwardingDataType": "3", }
消息体参数说明:
参数名 | 类型 | 描述 |
---|---|---|
createTime | datetime | 数据时间 yyyy-mm-dd hh:mm:ss 格式 |
dataName | string | 数据属性名称,如黄色 "故障关机"为对应值 |
dataResource | integer | 数据来源类型(1、读;3、上报 ) |
iotRelayDeviceSn | string | IOT中继宝盒设备编号,黄色为IOT中继宝盒设备编号标识值 “202403200101001” |
deviceId | string | 接入设备ID标识,黄色为接入设备ID标识值 “44080000001111000017” |
eventId | string | 物模型事件ID标识,黄色为接入设备物模型事件ID标识值 “E_1697248913306” |
forwardingDataType | integer | 转发数据类别:1、上报属性数据 2、读取的属性数据 3、上报的事件数据 |