设备触发节点是将设备上报的属性(读写型)或事件数据作为服务的输入,触发服务的后续逻辑。并且,支持通过虚拟设备上报属性或事件触发服务。

节点配置

配置项 说明
节点名称 设置节点名称。支持中文汉字、英文字母、数字和下划线(_),长度不超过30个字符。
产品选择 选择触发服务的产品和设备。可选择产品下的某个设备或全部设备。

选择设备后,系统将自动指定一个在线调试服务的设备。单击该设备名称,可进入在线调试页,为该设备开启虚拟设备,用于调试。

使用设备触发节点作为输入的服务的调试方法,请参见步骤3:调试

上报类型 选择触发服务的数据类型。可选:
  • 属性上报:即设备上报的属性数据触发服务。
  • 事件上报:即设备上报的事件数据触发服务。
  • 属性或事件上报:即设备上报的属性和事件数据均会触发服务。


节点输出

  • 属性上报类型的输出数据格式:
    {
            "deviceContext": {
                "productKey": "设备的productKey",
                "deviceName": "设备的deviceName",
                "gmtCreate": 设备的创建时间戳
            },
            "props": {
                "属性标识符": {
                "time": 设备上报信息的时间戳,
                "value": 设备上报的属性值
            }
        }
     }
  • 事件上报类型的输出数据格式:
    {
            "deviceContext": {
                "productKey": "设备的productKey",
                "deviceName": "设备的deviceName",
                "gmtCreate": 设备的创建时间戳
            },
            "event": {
                "事件标识符": {
                   "outputs": {
                       "出参标识符": 出参值
                   },
                   "eventCode": "事件标识符",
                   "eventName": "事件名称" ,
                   "eventType": "事件类型(信息/告警/故障)" 
                }
           }
    }
字段 描述 示例
deviceContext 设备信息。
{
  "productKey": "XXX", // 设备的porductKey

  "deviceName": "XXX", // 设备的deviceName

  "gmtCreate": 1538109258028 // 设备创建时间
}
props 设备上报的属性信息。当选择的上报类型中包含“属性上报”时,会出现该字段。

props字段内的具体内容,请在产品的功能定义页查看。

{
   "LightStatus":{  // 设备属性LightStatus
        "time":1538109258010,
        "value":0
    },
    "LightVolt":{ // 设备属性LightVolt
         "time":1538109258010,
         "value":1
    }
}
event 设备上报的事件信息。当选择的上报类型中包含“事件上报”时,会出现该字段。

event字段内的具体内容,请在产品的功能定义页查看。

{
    "Identifier1": {// 事件标识符
        "eventCode": "Identifier1", // 事件标识符 
        "eventName": "Warm", // 事件名称
        "eventType": "info", // 事件类型
        "outputs": { // 输出参数
            "outPara1": 2, 
            "outPara2": 0
        }
    }, 
    "Identifier2": {
        "eventCode": "Identifier2", 
        "eventName": "Warm", 
        "eventType": "info", 
        "outputs": {
            "outPara1": 2, 
            "outPara2": 0
        }
    }
}

后续节点使用该节点输出数据

如果该服务的其他节点需要调用设备上报的属性或事件,可以通过query访问具体参数,或者将本节点选择为后续节点的输入源。

  • 通过query访问。

    在配置后续节点,如脚本节点或钉钉机器人节点,编辑内容时,可使用query调用属性或事件数据。如:

    • query.props.属性标识符.value:调用设备上报的某属性值。
    • query.deviceContext.deviceName:调用设备名称。
    • query.props.event.事件标识符.eventName:调用设备上报的某事件名称。

    配置钉钉机器人调用设备上报的属性数据示例:



  • 通过配置项访问。

    在配置后续节点时,如条件判断节点或路径选择节点,选择数据源为设备触发节点的某类型数据。