接口设计与开发

接口设计与开发

数据展示梳理

两层意思,提供一种在大屏上展示数据的思考方式。反过来以思考数据如何在大屏展示出发,可以反推调研时需要哪些信息。

image.png

主线是层级,3D场景与传统大屏很大一个区别是,有着不同的层级,地图、园区、建筑、楼层、房间、设备,这是产品默认的层级关系。还包括地图用户在地图层级还可以根据业务需求自定义层级。
层级
所以比较方便的方法是,按照不同层级规划场景中的数据展示。
中间
中间是我们的场景,3D场景伴随着交互。交互伴随着出现数据或动画。举例点击建筑出现孪生体面板,慢板展示建筑实时能耗和实时状态。
底部、顶部
底部、顶部一般以交互动作为触发方式然后有数据或者动画。
产品默认底部就是图层交互,显示数据。
顶部可以使用操作集或者定制化制作交互。

左侧、右侧图表
左侧、右侧一般展示数据会比较多,首先要考虑的是用什么类型的图表展示什么数据,数据是什么展示方式,图片?文字?曲线?还是数字指标?还是形状(环状等)?

接口设计逻辑方法

两层意思,一层是介绍一种接口设计时的思路,反过来,从接口设计出发可以反推接口调研时需要什么样的信息。

流程详细说明

image.png

  • 先调研对接数据类别:性能、告警、配置、log等。依据不同的数据类型类别选择接口协议。
  • 依据对接数据类别分别对应其数据源:数据库(ES/MYSQL等)、网络厂商(天旦、或客户自己接口等)。
  • 然后根据不同的数据源判断使用什么技术方法,网络协议(http、syslog、JDBC、中间件)等。然后调研字段映射(源字段:目标字段)、对接方式(数据库对接、网络接口对接;我方接收数据还是对方接收数据、我方发启请求还是对方主动推送;全量对接还是增量对接)、样例数据(接口规范:我方发起请求格式,返回值?如果是数据库,查询条件相对固定)。
  • 处理逻辑(告警信息是否压缩?例如对方推送过来是3条相同告警压缩成一条)。
  • DIX写接口读取数据和存储数据到数据库。
  • 产品可视化界面显示(左侧、右侧等)。

接口指标调研模板

接口指标调研模板

接口指标方案模板

接口指标方案模板

模拟数据制作指南

在数据接口实际对接之前,可对目标孪生体的“性能”及“告警“信息进行数据模拟,通过前台推送数据可实现该目标可视化性能展示及告警提示。一般性能大于到少或者低于多少会触发告警,所以一般告警和性能是相关的。
所以在产品中模拟数据功能设计逻辑是:
流程
新建性能指标->关联对应孪生体->模拟性能->模拟告警

推送前准备
在【字典管理】-“指标管理”中新建字典数据,
image.png
字典定义属性描述如下:

属性 描述
名称 必填项,用户可自定义指标名称
别名 小名
类型 目前仅支持选择“模拟数据”
来源 性能值来源目前只能选择模拟数据
单位 指标项所对应值得单位,如:指标名称“温度”—单位:“℃”
约束 不用填
关联分类 选择需要该指标的孪生体类
采集频率 性能接口采集频率,不用填
推送模拟性能数据

在【模拟数据】目标选择中,选择孪生体分类,和该类下的孪生体。
image.png
推送模拟告警数据
image.png

image.png
查看告警推送记录
历史的告警推送记录
image.png
举例
1.在字段管理下指标管理新建性能指标,关联建筑分类
image.png
2.在模拟数据性能下关联孪生体分类关联建筑分类、选择B003建筑
image.png
3.此时下载模板为可选,点击下载模板。下载性能模板。填写时间差和性能值。
image.png
4.点击发送提示发送成功
image.png

5.配置配饰取监控值
image.png

6.展示
打开告警开关建筑有红色顶牌,温度指标显示最近的性能值。
image.png

DIX使用指南

DIX使用指南