数据孪生体与物理设备之间是解耦关系，您可使用数据映射功能，将物理设备的原始数据映射到孪生体的业务模型中，即孪生节点的物模型属性上。本文介绍配置数据映射的具体操作。

前提条件

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

您需获取待添加数据映射的孪生节点ID，及其功能属性标识符，用于输出文件中数据映射的配置。

背景信息

数据映射由以下3部分组成：
  • 数据源：孪生节点数据所属的设备Topic，包含自定义Topic和物模型属性上报Topic。

    数据源作为脚本文件或输出文件的输入数据，其中自定义Topic数据是设备上报的原始数据格式，物模型属性上报Topic的数据格式，请参见设备属性上报。

  • 脚本文件：使用JavaScript语言编辑脚本，解析处理设备Topic的原始数据，最后输出JSON格式数据。文件大小不超过128 KB。
  • 输出文件：使用规定的JSON数据格式，将设备Topic数据或通过脚本处理后的数据，映射到指定孪生节点的物模型属性上。文件大小不超过256 KB。

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

数据映射使用场景如下：

  • 数据源为物模型属性Topic，无需脚本文件，使用输出文件完成数据映射，如下图所示。物模型Topic无脚本
  • 数据源为自定义Topic，数据格式为JSON格式，无需脚本文件，使用输出文件完成数据映射，如下图所示。自定义Topic无脚本
  • 数据源为自定义Topic，先使用脚本文件解析数据，再使用输出文件完成数据映射，如下图所示。自定义Topic有脚本

操作步骤

  1. 在数字孪生体详情页面，单击数据映射页签，然后单击添加数据映射。
  2. 在添加数据映射面板，配置以下参数，单击确定。
    参数名称 说明
    数据映射名称 自定义数据映射名称。支持中文、英文字母、数字、和特殊字符下划线（_）、短划线（-）、半角圆括号（()）和at符号（@），长度限制为4~30个字符，一个中文计为2个字符。
    Topic 选择数据来源的消息Topic。
    • 自定义：指定消息源是自定义Topic时，支持使用通配符（+）和（#）。
      • 全部设备（+）：指定产品下所有设备。
      • /user/#：指定设备的所有自定义Topic。

      自定义Topic说明，请参见自定义Topic。

    • 物模型属性上报：设备上报属性的Topicthing/event/property/post。
    脚本 单击对应的选择文件，上传.txt格式的脚本文件、.json格式的输出文件。
    输出
  3. 在数据映射列表，查看已添加数据映射脚本的解析状态。
    状态列显示解析完成，表示数据映射脚本添加成功。

    如果状态列显示解析失败，单击下载失败原因，根据文件中提示的错误信息，修正脚本。然后单击操作列的编辑，重新上传脚本。

  4. 在数字孪生体详情页面，单击运行状态。
  5. 在运行状态页签，单击孪生体节点，在物模型数据面板，可查看节点的属性数据。
    开启实时刷新开关，数据将实时刷新。运行状态

后续步骤

查看孪生体运行日志。