文档中心

概述

规则引擎采用一套平台定义的查询语法对原始数据进行格式转换和过滤，用户通过编写查询语句和过滤条件可将符合条件的数据转化为期望的目标格式后流转到其他云产品或服务进行进一步业务处理。

语法特点

• 允许以紧凑且直观的符号表示复杂的查询。
• 提供丰富的内置运算符和函数来处理和组合提取的数据。
• 可以使用熟悉的JSON对象和数组语法将查询结果格式化为任何JSON输出结构。
• 结合函数，可以构建高级表达式来处理JSON查询和转换任务。

支持查询语法和函数的功能点

• 查询语句

将原始消息中选择的数据、规则引擎预置函数返回数据、常量赋值给新的key并组装为需要输出的json格式对象。

• 过滤条件

从原始消息中过滤指定条件的数据，使用查询语法或预置函数编写一个可以输出布尔值的表达式。

语法示例

示例消息

除非另有说明，否则示例均使用以下JSON文档样本：

{
        "reqId":"442c1da4-9d3a-4f9b-a6e9-bfe858e4ac43",
        "method":"thing.event.post",
        "timestamp":1465376157007,
        "deviceName":"device001",
        "productName":"product001",
        "params":{
            "host":"192.166.1.1",
            "color":"red",
            "historydDatas":[
                {
                    "key":"temperature",
                    "value":50,
                    "time":1465376157007
                },
                {
                    "key":"humidity",
                    "value":80,
                    "time":1465376157337
                },
                {
                    "key":"pressure",
                    "value":8.5,
                    "time":1465376157337
                },
                {
                    "key":"speed",
                    "value":80,
                    "time":1465376157337
                }
            ]
        },
        "properties":{
            "temperature":35,
            "humidity":22
        },
        "other":{
            "Misc":null
        }
    }

过滤条件

以下是一个简单的过滤条件逻辑表达式，可以在规则编辑调试页面作为测试熟悉语法的使用

示例语句的含义是：

过滤原始消息中properties下temperature值大于20且humidity小于30 的消息，转发到规则的数据目的地

properties.temperature>20 and  properties.humidity<30

返回结果

true

表达式将返回一个布尔值，如果为true则继续进行格式转换并转发到数据目的地，返回为false时则该消息不会被继续转换和流转

格式转化

以下是一个简单的查询语句示例，帮助开发者快速入门，可以在规则编辑调试页面作为测试熟悉语法的使用

示例语句的含义是：

1. 将原始消息中key为 productName 的元素value赋值给目标对象的 device.product
2. 将原始消息中key为 deviceName 的元素value赋值给目标对象的 device.deviceName
3. 将原始消息中key为 timestamp 的元素value赋值给目标对象的 time

{
        "device":{
            "product":productName,
            "device":deviceName
        },
        "time":timestamp

    }

最终输出结果：

{
        "device":{
            "product":"product001",
            "device":"device001"
        },
        "time":1465376157007
    }

操作符

规则引擎查询语法支持以下操作符，可以在查询语句和过滤条件中使用操作符构建简单表达式。

常用语法

获取完整原始消息

使用$符号可以获得完整的原始消息。

查询JSON对象

“.”分隔的字段名称，可定位到任意深度嵌套的JSON对象结构中的。

1. 表达式返回定位到位置路径中的最后一步后引用的JSON值。
2. 如果在定位路径的导航期间未找到字段，则该表达式不返回任何内容（返回undefined）。
3. 由于输入文档中不存在数据，不会引发任何错误。

查询JSON数组

数组中的每个值都与索引相关联，通过在数组的字段名称之后使用方括号来完成的。

1. 如果方括号包含数字或计算结果为数字的表达式，则数字表示要选择的值的索引。
2. 索引从0开始，如果传入的索引不是整数，则向下取整。
3. 从数组末尾开始计数的负索引arr[-1]将选择最后一个值，倒数arr[-2]第二个。如果指定的索引超过数组的大小，则不会选择任何内容。
4. 如果没有为数组指定索引（即在字段引用之后没有方括号），则整个数组都将被选择。如果数组包含对象，并且位置路径选择了这些对象中的字段，则将查询数组中的每个对象以供选择。

查询顶级数组、嵌套数组和数组展平

规则引擎支持数组格式JSON数据查询，输入数据是一个数组而不是一个对象。

示例JSON文档：

[
        {
            "ref":[1,2]
        },
        {
            "ref":[3,4]
        }
    ]

如果要选择此顶级数组中的第一个对象，则没有要附加[0]到的字段名称。不能单独使用[0]，此时必须使用上下文引用 $ 符号来引用文档的开头。

常用函数

规则引擎支持多种内置函数，支持对原始数据查询结果进行多种变换和简单计算。

常用函数，及其用途和示例如下：

平台预置函数

日期和时间函数

数值处理函数

字符串函数

对象函数

数组函数

高阶函数