文档

添加数据映射

更新时间:

您可配置设备Topic数据、API数据和自定义存储表数据作为孪生节点物模型属性的数据源。本文介绍配置数据映射的具体操作。

前提条件

  • 已为孪生节点配置功能属性。具体操作,请参见配置功能属性

  • 已获取待添加数据映射的孪生节点ID和名称,及其功能属性标识符,用于数据映射的配置。

操作步骤

  1. 进入孪生空间页面。具体操作,请参见查看孪生空间

  2. 在孪生空间页面左侧导航栏,单击数据接入

  3. 单击添加数据映射

  4. 添加数据映射面板,配置以下参数,单击确定

    参数名称

    说明

    数据映射名称

    自定义数据映射名称。支持中文、英文字母、数字、和特殊字符下划线(_)、短划线(-),长度不能超过32个字符,一个中文计为2个字符。

    数据源类型

    可选:

    • Topic:选择数据来源的消息Topic。

      • 自定义

        指定消息源是自定义Topic时,支持使用通配符(+)和(#)。

        • 全部设备(+):指定产品下所有设备。

        • /user/#:指定设备的所有自定义Topic。

        自定义Topic说明,请参见自定义Topic

      • 物模型属性上报

        设备上报属性的Topicthing/event/property/post

      • 数据服务:数据解析

        选择当前实例下对应的数据解析任务。

        数据解析的目标节点为当前IoT孪生空间时,才可将数据解析的输出数据设置为数据源。具体内容,请参见配置目标节点

    • API:选择API数据源的产品和设备,通过调用ImportDTData接口触发数据映射的脚本和输出文件执行。

    • 数据表:选择当前实例下数据服务中的自定义存储表。

      新建自定义存储表时,配置数据回流至IoT孪生引擎的孪生空间后,才可将该表数据设置为对应孪生空间的数据源。表字段数据可直接映射到孪生节点中。具体内容,请参见创建和管理自定义存储表

      重要

      一个数据表只能关联到一个数据映射中。

    脚本

    单击对应的选择文件,上传.txt格式的脚本文件、.json格式的输出文件。

    脚本和输出文件编辑方法,请参见脚本和输出语法

    说明

    数据源类型TopicAPI时,需设置脚本、输出的文件。

    输出

  5. 在数据映射列表,查看已添加数据映射脚本的解析状态。

    状态列显示:

    • 解析完成:表示数据映射脚本添加成功。

    • 解析失败

      1. 单击下载失败原因,根据文件中提示的错误信息,修正脚本。

      2. 在数据映射列表中,单击操作列的编辑,重新上传脚本,然后单击确定

后续操作

真实设备上报数据后,您可查看以下信息:

  • 孪生节点属性数据。操作如下:

    1. 在孪生空间页面左侧导航栏,单击孪生实体图

    2. 孪生实体图页签,单击孪生体节点。

    3. 物模型数据面板,查看节点的属性数据。

      开启实时刷新开关,数据会实时刷新。

      查看物模型数据
  • 孪生体中各孪生节点的运行日志。具体操作,请参见查看孪生体运行日志