【乐吾乐3D可视化组态编辑器】数据接入

news2024/11/20 14:35:28

数据接入

本文为您介绍3D数据接入功能，数据接入功能分为三个步骤：数据订阅、数据集管理、数据绑定

编辑器地址：3D可视化组态 - 乐吾乐Le5le

数据订阅

乐吾乐3D组态数据管理功能由次顶部工具栏中按钮数据管理打开。

在新弹窗中选择数据订阅标签，新建数据订阅

数据支持3种类型协议，HTTP、MQTT、WebSocket。HTTP模式下系统会按照配置的轮询间隔定时向后端地址发送请求，MQTT和WebSocket则会等待后端推送数据。

数据订阅类型与参数

HTTP

名称：数据订阅的名称。
地址：后端接口地址。
方法：HTTP模式下请求的方法。有Get和Post两种。
参数项：HTTP模式下请求时携带的参数。支持请求Header、Query、Body三种参数

MQTT

名称：数据订阅的名称。
地址：后端接口地址。
主题：MQTT模式下订阅的消息主题。
客户端ID：MQTT模式下设置的客户端ID。
用户名：MQTT模式下设置的用户名。
密码：MQTT模式下设置的密码。

WebSocket

名称：数据订阅的名称。
地址：后端接口地址。
子协议：WebSocket模式下指定的子协议，多个子协议用英文逗号分隔。

后端数据格式

目前我们支持两种返回格式：

1.数组Array<{ id: string; value: any; }>。其中，id为需要更新的数据点号，value为更新的值。例如：

[
 { id: 'd-1-a-001', value: 120 },
 { id: 'd-1-a-002', value: 60 },
 { id: 'd-1-a-003', value: '开启' },
 { id: 'd-1-a-004', value: false },
 { id: 'd-1-a-005', value: 30 },
 { id: 'd-1-a-006', value: 22.5 },]

Copy

2.键值对{ [ id: string ]: any }。其中，键为需要更新的数据点号，值为更新的值。例如：

{
 'd-1-a-001': 120,
 'd-1-a-002': 60,
 'd-1-a-003': '开启',
 'd-1-a-004': false,
 'd-1-a-005': 30,jian
 'd-1-a-006': 22.5,}

Copy

值的类型需要符合数据集中对应数据点号设定的数据类型。例如数据点号为'd-1-a-001'的数据点，它的数据类型为数值（整数），那么后端也应该推送数值类型的值，如果推送的是非数值，那么系统会强制将其转换为数值，例如推送的是布尔值true，系统会强制转换为1。

生成数据集

数据订阅完成之后，此时网页已经拥有接收后端数据的能力，接下来需要将后端的每一条数据变成数据点。数据点的集合称为数据集，后端接口的数据是数据点的数组集合，数据点由数组中的每个数据的id构成数据点号，value或者值构成数据点的值。

生成数据点的方法有两种：新建数据点号、导入数据集

新建数据点号

打开数据管理弹窗后选择数据集标签，新建数据点号。

在新弹窗中设置数据点属性

数据点ID：数据点名称ID(为必填项)
设备名称：选填
数据点名称：选填
数据类型：包含字符串、整数、浮点值、布尔值
值：当前显示的默认数值
开启模拟：设置是否开启模拟数据
值范围：数据模拟的范围

（值的设置规则）

描述：对当前数据点的描述备注

设置完毕点击确认即可生成一条数据点

导入数据集

相较于单个新建数据点，导入数据集是更高效的方式；导入数据集支持三种方式：选择模板、在线数据、选择文件。

选择模板：选择右侧下拉框即可选择已保存的模板，快速打开数据集，前提为已有数据集信息被执行过保存为模板命令
。

在线数据：右侧输入在线接口地址点击图标
或回车获取数据。

选择文件：支持导入excel、json、csv格式文件。

保存数据集

保存当前数据集的方式有：保存为模板、下载JSON文件、下载EXCEL文件，当不同场景使用相同接口时，可以从模板中或导入文件中获取数据点号，方便快速复用。

数据绑定

完成前两步新建数据订阅、生成数据集后，接着编辑最后一步数据绑定后即可完成数据接入。

新建动态数据

动态数据的载体分为面板、模型两类，数据绑定逻辑相同，其主要运用场景不同，面板中绑定数据是以展示设备仪表的实时动态数据功能为主，如温度值、湿度值、压力值、功率、时间等具体数据的实时变化，当然也可以借此改变面板其它属性，如基本属性状态、动画状态等，只是实际运用场景不多；而模型中则是相反，依靠动态数据改变模型的属性状态、执行动作为主，如改变模型的基础属性状态、动画状态、自带动画状态以及自定义属性，下文将详细介绍其中差异。

面板

点击面板的数据标签，新建动态数据。

属性类型中包括5种：【自定义】、【属性】、【自定义动画】、【自带动画】、【内容】，其中【内容】为面板绑定数据的主要功能（实时动态数据），为本节主要讲解对象，其它四类详见下一小节模型的绑定数据教程。

内容（实时动态数据绑定）

新建编辑器内置面板，编辑文本信息，将需要进行数据绑定的文本框改为可识别名称（绑定数据会用到此名称），编辑完成退出界面。

点击面板的数据标签，新建动态数据。

在属性类型中选择【内容】（【内容】为面板数据绑定中特有类型），属性下拉框中则可选择上一步设置了名称的文本框（未设置名称默认为：内容1）。

文本框内可选择文字、颜色，这里选择文字点击确认。

在数据标签界面点击回形针按钮，弹出数据点弹窗，选择第二步生成数据集中合适的数据点，点击确定完成绑定。

此时，在数据订阅接口地址连接上且为面板文本框绑定了数据点的情况下，实时动态数据就完成了绑定，点击运行即可在面板观测后台发送的实时数据。

属性、自定义动画、自带动画、自定义

详见下一节模型数据绑定

模型

模型中

点击模型的右侧数据标签，新建动态数据。

属性类型中也包括5种，本节主要讲解【属性】、【自定义动画】、【自带动画】、【自定义】的设置方法。

属性

具体可绑定属性为经纬度、海拔、是否开启、透明度、模型基本信息、材质等，可设置参数包括当前值、过渡时间、过度模式。

这里以立方体的位置-X为例，设置完成后退回数据标签，点击回形针按钮绑定数据点，完成动态数据与立方体位置-X的绑定。这里需要注意的是物体属性值与数据点应为属性对应关系，否则不生效，如位置、缩放、旋转等信息应绑定浮点值、整数、字符串等表现为具体数值的数据点，如是否开启、开启辉光等则应绑定布尔值这种表现为只有true和false的数据点。