您需要在控制台提交数据解析脚本。设备通过携带解析标记?_sn=default的自定义Topic上报数据，物联网平台收到数据后，调用数据解析脚本，将自定义格式数据转换为JSON结构体，再流转给后续业务系统。

说明

  • 仅华东2（上海）地域支持自定义Topic数据解析。
  • 仅通过MQTT协议接入的设备支持自定义Topic数据解析。
  • 仅解析设备上报云端的数据，不解析云端下行数据。
  • 解析上报数据的Payload，并返回解析后的Payload。
  • 解析前后，数据所在Topic不变。例如，设备发送到/${productKey}/${deviceName}/user/update的数据，解析后仍在该Topic中。

解析标记

配置设备端时，需在发布消息的自定义Topic后添加数据解析标记?_sn=default。物联网平台仅解析设备通过携带标记的Topic发布的数据。

例如，设备发送到Topic /${productKey}/${deviceName}/user/update的数据需要解析为JSON格式。在开发设备端时，就需配置该Topic为：/${productKey}/${deviceName}/user/update?_sn=default。

说明 在物联网平台创建自定义Topic时按正常Topic定义，不添加该解析标记。

操作步骤

  1. 登录物联网平台控制台。
  2. 在左侧导航栏，选择设备管理 > 产品。
  3. 在产品页，单击产品对应的查看。
  4. 在产品详情页，选择数据解析页签。
  5. 选择脚本语言，然后在编辑脚本下的输入框中输入脚本。

    目前支持三种脚本语言：JavaScript（ECMAScript 5）、Python 2.7和PHP 7.2。

    脚本中需定义调用函数：

    • JavaScript（ECMAScript 5）：transformPayload()
    • Python 2.7：transform_payload()
    • PHP 7.2：transformPayload()

    完整的示例代码，请参见JavaScript脚本示例、Python脚本示例和PHP脚本示例。

    说明 如果产品的 数据格式为 透传/自定义，还需编写物模型数据解析脚本。物模型数据解析脚本编写指导，请参见 物模型数据解析使用示例。
  6. 测试脚本。
    1. 模拟输入下，选择模拟类型为自定义，并选择设备和Topic。
    2. 输入模拟的设备上报数据，单击执行。
  7. 确认脚本可用后，单击提交，将脚本提交到物联网平台系统。