# 提交数据解析脚本
设备通过携带特殊标记@sn=raw
的自定义 topic 上报数据,平台收到数据后, 调用用户上传的数据解析脚本,将自定义格式数据转换为 JSON 格式数据,再转发至后续的业务系统。
# 说明
- 仅解析设备上报到平台的数据,不解析平台下发的数据。
- 后续的业务系统收到的 payload 都是经由数据解析脚本转换后的数据。
- 后续的业务系统收到的 topic 不包含任何特殊标记。例如,设备上报的 topic 为
/$product_key/$device_name/user/xxx@sn=raw
,经由脚本处理后,转发出去的 topic 为/$product_key/$device_name/user/xxx
# 添加自定义 topic
在平台添加自定义 topic 时按照正常 topic 的格式来定义,不需要添加特殊标记。
# 操作步骤
- 登录平台
- 在左侧导航栏,选择设备管理 > 产品列表。
- 在产品页,单击产品对应的名称跳转至产品详情页。
- 在产品详情页,选择数据解析标签页。
- 选择编辑进入脚本编辑页,在输入框中输入脚本。
- 目前仅支持 JavaScript(ECMAScript 5) 脚本语言。
脚本中需定义调用函数:transformPayload(topic, bytes)
完整的示例代码,请参见JavaScript脚本示例。
- 测试脚本。
模拟输入下,选择模拟类型为设备上报自定义Topic,并选择自定义 topic。 输入模拟的设备上报数据,单击执行。 脚本正确执行并返回预期的 JSON 数据后,单击提交,将脚本提交到平台。
说明 只有脚本正确执行后,提交按钮才可用。脚本提交后才能生效。脚本未完成时,可以选择保存草稿。