函数列表

您可以在编写解析器脚本时使用以下函数，实现多样化数据处理。函数列表包括数据类型转换函数、流转数据到数据目的函数和基础数据类型的函数等。本文介绍函数的表达式及其使用说明。

数据类型转换函数

时间类型转换函数

基本数据类型支持的函数

Map类型

Array类型

String类型

流转数据到数据目的函数

writeResponse(“key”,data)

对HTTP数据源的请求进行响应

• key： 响应数据key
• data：写入到响应中的数据

writeHttp(destinationId,params,headers,data)

数据转发到HTTP请求

• destinationId：数据目的ID
• params：HTTP请求参数
• headers：HTTP请求头
• data：流转的HTTP的数据

writeIotTopic(destinationId, “topic”, payload, deviceId)

数据转发到另一个Topic

• Topic：数据转发目的地Topic，支持以下Topic。

  • 自定义Topic：该自定义Topic的设备操作权限需为订阅，即所属设备可订阅这个Topic，获取转发的消息。
  • 物模型数据下发Topic：/${productId}/${deviceId}/thing/property/down。该Topic为设备接收设置属性值指令的Topic，设备从该Topic接收转发数据，并根据数据内容，设置属性值。用于目的地Topic所属设备根据转发的数据更改属性值的场景。

  Topic中${productId}必须与destinationId对应数据目的中设置的产品相同。函数中Topic必须指定具体Topic，不支持使用通配符。

• deviceId：非必填。若产品为网关的子设备，在消息流转数据到另一个Topic时，需传入该参数（例如BLE MESH子设备）。其他业务场景不可以传入该参数。数据格式为Map类型，Key为"deviceId"，Value为deviceId()，表示发送该Topic消息的设备名称。

重要
目的地Topic所属设备若未订阅该Topic，则收不到转发的消息。
例如使用MQTT.x工具接入物联网平台的设备A，不会自动订阅设备Topic，若设备B向设备A的Topic：thing/service/property/set转发数据，而设备A未手动订阅该Topic，则设备A收不到设备B转发的消息。

其他函数

endWith(input, suffix)

判断字符串input中是否以字符串suffix结尾。返回结果类型为布尔型。

productId()

返回当前产品的ProductId值。

getDeviceTag(key) —— 暂不支持

返回key所对应的设备标签。如果设备没有该key对应的标签，则返回值为空。

getOrNull(data, “items”, ……)

返回JSON格式数据data中指定字段的值。

该函数中传入的字段个数没有限制，但必须逐级传入。函数返回最后一个字段的值，若最后一个字段不存在或值为空，则函数返回值为null。

例如data中数据：

"items": {
    "Humidity": {
        "value": 25,
        "time": 1626948134319
    }
}

函数示例如下：

• getOrNull(data, "items")返回字段items值"Humidity": {"value": 25,"time": 1626948134319}。
• getOrNull(data, "items", "Humidity", "value")返回字段value值25。
• getOrNull(data, "items", "Temperature")，字段Temperature不存在，返回值null。

payload(textEncoding)

返回设备发布消息payload的转义数据。textEncoding表示payload的转义字符编码，取值如下：

• 不传入参数：默认按照UTF-8编码转换为字符串，即payload()等价于payload('utf-8')。
• json：将payload数据转换成Map格式变量。如果payload不是JSON格式，则返回异常。
• binary：将payload数据转换成二进制变量进行透传。

parseNumber(numberString, radix)

将字符串numberString按指定的进制radix转换为数字。

radix为可选参数，取值如下：

• 10（默认）：将字符串转换为十进制数字。
• 2：将字符串转换为二进制数字。
• 16：将字符串转换为十六进制数字。

例如：

// 设备上报数据。
var content = '0xFF';
// 获取待转换字符串FF.
var x = content.substring(2);
// 将FF转换为16进制数字。
var value = parseNumber(x, 16);

getThingModelProperty(modelProperty)

获取设备物模型属性数据。其中modelProperty表示属性的标识符，默认为default模块。若属性在自定义模块下，则格式为：${模块标识符}:${属性标识符}（中间为英文冒号）

例如：

• color：表示default模块的color属性
• test:color ：表示test模块的color属性

相关文档

您可结合支持的脚本语法，调用函数将数据流转到数据目的地。脚本的使用说明，请参见脚本语法。