产品节点,即当前服务所在项目下的产品。主要用于向设备下发设置属性或调用服务的指令、查询设备属性快照值或历史值,和查询设备其他信息,如基本信息、物模型详情、事件数据等。

您在当前服务所属项目的产品页,导入或新增的产品将自动显示在功能节点设备页签下。

导入新增产品

如果您没有为当前项目添加任何产品,则设备页签下没有任何产品节点。

设备

节点配置

配置项 描述
节点名称 设置节点名称。支持中文汉字、英文字母、数字和下划线(_),长度不超过30个字符。
选择要控制的设备 选择控制对象。可选择:
  • 来自其他节点的参数,即控制对象为该产品节点之前的某个节点中的参数。
  • 选择为当前产品下的某个设备。
选择操作类型 选择要执行的操作类型。可选:
  • 设备动作执行:设置属性或调用服务。
  • 查询设备属性:查询设备的属性快照值或历史值。
  • 查询设备其他信息:查询设备的基本信息、物模型详情、事件数据等。
下发数据 当操作类型选择为设备动作执行时出现的字段。

下发设置某个属性或调用某个服务的指令给设备。

说明 所选属性必须为读写型。

下发设置属性的数据格式如下:

{
   "properties": {
    "目标属性1的标识符": "目标值",
    "目标属性2的标识符": "目标值"
   }
}
选择要查询的属性 当操作类型选择为查询设备属性时出现的字段。

可选择全部属性或某个具体属性。

查询维度 当操作类型选择为查询设备属性时出现的字段。
  • 快照值:查询设备最近一次上报的属性值。
  • 历史值:查询单个属性在指定时间段内上报属性的历史记录。需设置查询起止时间、要查询的记录数量、和排序方式。

    下发的数据格式示例如下:

    {
       "start": 1526900000000, // 查询历史数据的起始时间(毫秒单位的时间戳)
       "end": 1526900000001, // 查询历史数据的终止时间(毫秒单位的时间戳)
       "pageSize": 10,  // 要查询的记录数
       "ordered": true // 查询顺序(true - 正序,false - 逆序)
    }
    说明
    • 如果排序选择为正序,则查询从开始时间算起的前10个属性记录。
    • 如果排序选择为逆序,则查询从开始时间到结束时间之间的最后10个属性记录。
查询类型 当操作类型选择为查询设备其他信息时出现的字段。

在下拉框选项中,选择要查询的信息类型,并根据信息类型传入参数。各类型需传入的具体参数,请参见物的管理服务中各API的参数。

参数可设置为变量。IoT Studio内置了如下全局变量:

  • 来自上个节点的输出数据:payload。支持使用payload.payload对象中的某个key来访问指定key的数据。
  • 来自服务输入节点的数据:query。例如,HTTP请求节点的入参,设备触发节点的设备数据。支持使用query.参数名来访问指定数据。
  • 来自指定节点的输出数据:node.节点ID。支持使用node.节点ID.节点输出对象中的某个key来访问指定key的数据。

示例:

{
   "productKey": "{{payload.productKey}}",  // 上一个节点的输出为:{productKey: '值'},取productKey的值
   "deviceName": "{{query.deviceName}}", // API请求节点的入参中,定义了一个名称为deviceName的入参,取入参deviceName的值
   "pageNum": "{{node.node_399591c0.pageNum}}" // 节点node_399591c0的输出为pageNum,取pageNum的值
}

如果需要调用某参数的子集,可按如下示例方式调用:

使用{{payload.props.PM10.value}},表示上一个节点props对象中属性PM10的值。

使用{{query.deviceContext.deviceName}},表示第一个节点的输出内容中deviceContext对象的deviceName变量。

设备动作执行配置示例。

设备动作执行

查询设备属性示例。

查询设备属性

查询设备其他信息示例:

查询设备其他信息

输出数据

根据指令进行操作后,返回的结果数据作为节点的输出数据。

输出数据结构,可在调试成功后,节点日志中查看。

日志