產(chǎn)品節(jié)點(diǎn),即當(dāng)前服務(wù)所在項(xiàng)目下的產(chǎn)品。主要用于向設(shè)備下發(fā)設(shè)置屬性或調(diào)用服務(wù)的指令、查詢?cè)O(shè)備屬性快照值或歷史值,和查詢?cè)O(shè)備其他信息,如基本信息、物模型詳情、事件數(shù)據(jù)等。

您在當(dāng)前服務(wù)所屬項(xiàng)目的產(chǎn)品頁,導(dǎo)入或新增的產(chǎn)品將自動(dòng)顯示在功能節(jié)點(diǎn)設(shè)備頁簽下。

導(dǎo)入新增產(chǎn)品

如果您沒有為當(dāng)前項(xiàng)目添加任何產(chǎn)品,則設(shè)備頁簽下沒有任何產(chǎn)品節(jié)點(diǎn)。

設(shè)備

節(jié)點(diǎn)配置

配置項(xiàng) 描述
節(jié)點(diǎn)名稱 設(shè)置節(jié)點(diǎn)名稱。支持中文漢字、英文字母、數(shù)字和下劃線(_),長(zhǎng)度不超過30個(gè)字符。
選擇要控制的設(shè)備 選擇控制對(duì)象。可選擇:
  • 來自其他節(jié)點(diǎn)的參數(shù),即控制對(duì)象為該產(chǎn)品節(jié)點(diǎn)之前的某個(gè)節(jié)點(diǎn)中的參數(shù)。
  • 選擇為當(dāng)前產(chǎn)品下的某個(gè)設(shè)備。
選擇操作類型 選擇要執(zhí)行的操作類型。可選:
  • 設(shè)備動(dòng)作執(zhí)行:設(shè)置屬性或調(diào)用服務(wù)。
  • 查詢?cè)O(shè)備屬性:查詢?cè)O(shè)備的屬性快照值或歷史值。
  • 查詢?cè)O(shè)備其他信息:查詢?cè)O(shè)備的基本信息、物模型詳情、事件數(shù)據(jù)等。
下發(fā)數(shù)據(jù) 當(dāng)操作類型選擇為設(shè)備動(dòng)作執(zhí)行時(shí)出現(xiàn)的字段。

下發(fā)設(shè)置某個(gè)屬性或調(diào)用某個(gè)服務(wù)的指令給設(shè)備。

說明 所選屬性必須為讀寫型。

下發(fā)設(shè)置屬性的數(shù)據(jù)格式如下:

{
   "properties": {
    "目標(biāo)屬性1的標(biāo)識(shí)符": "目標(biāo)值",
    "目標(biāo)屬性2的標(biāo)識(shí)符": "目標(biāo)值"
   }
}
選擇要查詢的屬性 當(dāng)操作類型選擇為查詢?cè)O(shè)備屬性時(shí)出現(xiàn)的字段。

可選擇全部屬性或某個(gè)具體屬性。

查詢維度 當(dāng)操作類型選擇為查詢?cè)O(shè)備屬性時(shí)出現(xiàn)的字段。
  • 快照值:查詢?cè)O(shè)備最近一次上報(bào)的屬性值。
  • 歷史值:查詢單個(gè)屬性在指定時(shí)間段內(nèi)上報(bào)屬性的歷史記錄。需設(shè)置查詢起止時(shí)間、要查詢的記錄數(shù)量、和排序方式。

    下發(fā)的數(shù)據(jù)格式示例如下:

    {
       "start": 1526900000000, // 查詢歷史數(shù)據(jù)的起始時(shí)間(毫秒單位的時(shí)間戳)
       "end": 1526900000001, // 查詢歷史數(shù)據(jù)的終止時(shí)間(毫秒單位的時(shí)間戳)
       "pageSize": 10,  // 要查詢的記錄數(shù)
       "ordered": true // 查詢順序(true - 正序,false - 逆序)
    }
    說明
    • 如果排序選擇為正序,則查詢從開始時(shí)間算起的前10個(gè)屬性記錄。
    • 如果排序選擇為逆序,則查詢從開始時(shí)間到結(jié)束時(shí)間之間的最后10個(gè)屬性記錄。
查詢類型 當(dāng)操作類型選擇為查詢?cè)O(shè)備其他信息時(shí)出現(xiàn)的字段。

在下拉框選項(xiàng)中,選擇要查詢的信息類型,并根據(jù)信息類型傳入?yún)?shù)。各類型需傳入的具體參數(shù),請(qǐng)參見物的管理服務(wù)中各API的參數(shù)。

參數(shù)可設(shè)置為變量。IoT Studio內(nèi)置了如下全局變量:

  • 來自上個(gè)節(jié)點(diǎn)的輸出數(shù)據(jù):payload。支持使用payload.payload對(duì)象中的某個(gè)key來訪問指定key的數(shù)據(jù)。
  • 來自服務(wù)輸入節(jié)點(diǎn)的數(shù)據(jù):query。例如,HTTP請(qǐng)求節(jié)點(diǎn)的入?yún)ⅲO(shè)備觸發(fā)節(jié)點(diǎn)的設(shè)備數(shù)據(jù)。支持使用query.參數(shù)名來訪問指定數(shù)據(jù)。
  • 來自指定節(jié)點(diǎn)的輸出數(shù)據(jù):node.節(jié)點(diǎn)ID。支持使用node.節(jié)點(diǎn)ID.節(jié)點(diǎn)輸出對(duì)象中的某個(gè)key來訪問指定key的數(shù)據(jù)。

示例:

{
   "productKey": "{{payload.productKey}}",  // 上一個(gè)節(jié)點(diǎn)的輸出為:{productKey: '值'},取productKey的值
   "deviceName": "{{query.deviceName}}", // API請(qǐng)求節(jié)點(diǎn)的入?yún)⒅校x了一個(gè)名稱為deviceName的入?yún)ⅲ∪雲(yún)eviceName的值
   "pageNum": "{{node.node_399591c0.pageNum}}" // 節(jié)點(diǎn)node_399591c0的輸出為pageNum,取pageNum的值
}

如果需要調(diào)用某參數(shù)的子集,可按如下示例方式調(diào)用:

使用{{payload.props.PM10.value}},表示上一個(gè)節(jié)點(diǎn)props對(duì)象中屬性PM10的值。

使用{{query.deviceContext.deviceName}},表示第一個(gè)節(jié)點(diǎn)的輸出內(nèi)容中deviceContext對(duì)象的deviceName變量。

設(shè)備動(dòng)作執(zhí)行配置示例。

設(shè)備動(dòng)作執(zhí)行

查詢?cè)O(shè)備屬性示例。

查詢?cè)O(shè)備屬性

查詢?cè)O(shè)備其他信息示例:

查詢?cè)O(shè)備其他信息

輸出數(shù)據(jù)

根據(jù)指令進(jìn)行操作后,返回的結(jié)果數(shù)據(jù)作為節(jié)點(diǎn)的輸出數(shù)據(jù)。

輸出數(shù)據(jù)結(jié)構(gòu),可在調(diào)試成功后,節(jié)點(diǎn)日志中查看。

日志