Lookup Asset


Lookup Asset 节点让集成流可以根据所配置的查询方法在 EnOS 中查询资产数据,并在输出中使用指定的数据记录。当前仅支持 JSON 作为输入。

节点类型

IoT Hub。

输入和输出能力

该节点具有 1 个入口点和 1 个出口点。输入和输出都是 JSON 格式。

节点属性

../../_images/lookup_asset.png


名称

该节点的名称。


查询方法

节点选择拟在输出中使用的数据资产所用的方法。可以使用以下方法。

  • 按 Device Key:Device Key 与表达式中的返回值相匹配的任何资产。
  • 按属性:属性与表达式中的返回值相匹配的任何资产。你需要指定拟使用的模型属性。不支持带有 timestampdatearrayfile 数据类型的属性。
  • 按标签:标签与指定标签的键和值相匹配的任何资产。
  • 按高级方式:用于查询资产的其他选项,包括使用条件。条件的最大数量为 5。
    • 指定:有两个选项,分别是 按模型按产品。所选模型或产品下的所有资产都将会被使用。
    • 自定义:有五个可用选项,分别是 按 Device Key按属性按标签按模型 ID按产品 Key。如果选择 按 Device Key按模型 ID按产品 Key,模型 ID 或 产品 Key 与表达式中的返回值相匹配的资产都将会被使用。


表达式

如果选择以下所列查询方法之一,则为必填字段。

  • 按 Device Key
  • 按属性
  • 按模型 ID
  • 按产品 Key


参见以下示例。

  • 查询方法:按 Device Key。

    ${msg.electricMeter}

    节点搜索记录并返回 Device Key 与 electricMeter 相匹配的资产。

  • 查询方法:按属性。

    属性:maxPower。

    ${msg.maxPower}

    节点搜索记录并返回属性与 maxPower 相匹配的资产。


输出

查询所返回资产的值,使用 key:value 格式存储在输出消息中。当前支持 assetId。如果返回多个资产,将使用第一个结果。如果消息已有相同的 key,该 key 将会被结果覆盖。


描述

该节点的描述。

使用限制

  • 按高级方式 方法的最大条件数量为 5。

示例

输入示例

{
    "externalId":"externalId",
    "timestamp":24214324324,
    "measurepoints":{
        "speed":32,
        "heat":40
    }
}

输出示例

Lookup Asset 节点使用表达式 ${msg.measurementpoint.speed}按属性 选项,搜索速度测点与 32 的值相匹配且在输出中包含资产 ID 的任何资产。

{
    "externalId":"externalId",
    "timestamp":24214324324,
    "measurepoints":{
        "speed":32,
        "heat":40
    },
    "assetId":"assetId"
}