piadmin数据接入操作手册

数据对接详解支持对接数据类型l http请求数据方式

l mysql数据库

l sqlserver数据库

l postgresql数据库

l excel/csv文本文件

l hikvision/海康综合安防数据源

l websocket

l oracle数据库

l mongodb数据库

l dm/达梦数据库

l kingBaseES/人大金仓数据库

l MQTT/物联网平台

数据对接• 登录piadmin平台后，选中数据管理-数据源选项，点击新增按钮

•

• 根据需要对接的数据不同，选择对应的数据源类型，HTTP数据源使用• 如果是服务端提供数据，使用http数据源方式，根据实际情况配置get或者post请求，填充对应参数以及需要鉴权登录提供鉴权参数等，编写好后保存，再次打开可点击预览按钮获取数据

新增好数据源后，打开数据管理-数据表页面，点击新增

点击数据源下拉框，选中创建的数据源，填写自定义名称，请求路径根据实际填写，填写完成点击确定保存

在列表中编辑项目，点击预览可以看到请求是否成功并且返回数据

数据库数据源使用数据库数据源包括（MySQL，SQL Server，PostgreSQL，Oracle，MongoDb，DM8，KingbaseES）

点击新增按钮，选中mysql数据源，数据源名称自定义填写，根据实际情况填写数据库ip,端口号，需要连接的数据库名称和用户名、密码等，填充好后点击测试`数据库是否连通`按钮测试下是否连接上

选中数据管理-数据表选项，点击新增按钮，选中新建的mysql数据源，选中数据源后，点击数据库表名下拉框，选中需要的数据表，点击预览就可直接看到数据库数据

其他数据库连接操作与此类似Websocket数据源使用选中数据管理-数据源选项，点击新增按钮，数据源类型选中Websocket类型，自定义起个数据源名称，根据实际情况填写请求域名，保存

选中数据管理-数据表选项，选中新建的websocket数据源，然后配置对应的请求路径

MQTT（物联网平台）选中数据管理-数据源选项，点击新增按钮，数据源类型选中MQTT类型，自定义起个数据源名称，根据实际情况填写客户端id,请求地址和用户名、密码，保存

选中数据管理-数据表选项，点击新增按钮，选中新增的MQTT数据源，自定义起个数据表名称，填写订阅主题

海康摄像头数据源接入点击数据管理-视频源，点击新增，按照实际参数填写地址，key,账号，密码等

点击确定保存，

点击测试可以获取当前连接的摄像头

点击数据管理-视频摄像头

点击新增，选中刚刚新增的视频源，等候摄像头下拉列表刷新出来后，选择想要连接的摄像头，按照实际情况填写其他信息，确定后保存

最后选择编码类型后，可直接预览到摄像头视频的播放

数据管理下的类型结构和对象类型的使用可以先在类型结构自定义结构属性模板或者使用公共模板，根据需要的数据格式类型，自定义添加属性名和数值类型

对象属性新增，可直接编辑属性名称和数值类型以及属性名的值对应的数据表的具体字段值，也可以直接引用类型结构后，再编辑对应的数据表的具体字段值

项目的编辑项目页面中的信息栏里面的问题和渐变文字等组件都有对应的类型结构模板，请求方式选择数据对象后，只能选择依据对应的类型结构模板新增的对象类型，就可以直接接入使用

数据使用新建项目使用数据操作登录piadmin平台后，选中项目管理，点击创建空白项目，按表格填写。

新建项目成功后，鼠标移动到新建的项目上，点击编辑项目

跳转到webui的二维编辑页面，

点击左侧第三个图标，图表选项，选择需要的图表，点击会自动生成到中间网格画布上，点击选中画布上的图表，右侧可以看到基础设置，点击数据栏，点击请求方式下拉框，选中数据表

选中数据表后，点击数据表下拉框，选中之前在数据源、数据表那边配置好的数据表选项，就可以获取到数据了

请求间隔可以设置定时去获取新的数据，实现数据动态更新

大部分时候数据返回的格式不是当前需要的值，所以当数据展示不是想要的时候，点击新增过滤器，进行自定义编辑，返回需要的数据

编辑器新增过滤器的使用规则统计图表：根据选中的图表，点击数据，请求方式选择静态数据，看下面的数据内容格式，

复制静态数据的数据格式，

{

 "dimensions": [],

 "source": []

}

然后点击新增编辑器，定义一个对象值为这个需要转换的格式，取对应需要统计的值，这里是取source下的data数据组进行统计，统计里面的日期时间和tem值，也就是统计图表的x轴和y轴的概念，按照这个格式可以过滤自己想要的数据进行图表统计，可以一个y轴也可以多个

return {

   "dimensions": ["日期","tem"],

   "source": data.source.data.map(function(item) {

             return {

               "日期": item.date,

               "tem": item.tem

               }

           })

}

数据的x轴和y轴名称都是可以自定义取名

其他图表都是一样的操作

信息、列表、小组件等数据对接使用文字组件使用选择信息里面的文字组件，点击右边的数据栏，选择数据表，选好需要对接的数据表数据，默认数据会取第一个的值

需要指定值展示，点击新增过滤器，通过返回的数据格式一层一层去获取想要的值

其中遇到【】中括号的取值要用[ ]包裹，里面的数字是代表它是第n个减去1，例如上面的是第一个，减去一，就是1-1=0，所以取值就是[0]图片，远程网页，视频，视频流，摄像头的使用图片和视频都是上传后直接显示

或者直接填充正确的能显示的图片路径或者视频路径

远程网页和视频流都是可以直接填充实际地址使用

摄像头直接就点击选中摄像头组件，在最右测摄像头下拉框选择自定义好的摄像头数据就可以接入使用

列表和小组件的使用和图表以及文字类似视频流支持的协议类型支持的协议：HTTP-FLV(.flv)、HLS(.m3u8)、MPEG-DASH(.mpd)、rtsp/rtmp

数据接入异常排查流程HTTP数据源接入异常1. 检查http路径是否正确

2. 确定http请求方式是否正确

3. 检查http是否需要鉴权校验之类的

4. 确定http参数正确及有效数据库（MySQL，SQL Server，PostgreSQL，Oracle，MongoDb，DM8，KingbaseES）数据源接入异常1. 检查数据库连接路径是否正常

2. 检查账号，密码，端口等是否正确，oracle数据库确定下SID是否·正确

3. 检查数据库是否允许连接，数据库服务正常运行海康api数据源接入异常1. 检查平台是否和所需要请求的一致

2. 检查host，key,hkAppSecret等参数是否正确

3. 检查api地址，请求方式和请求参数格式海康摄像头数据源接入1. 检查地址，key,账号，密码等信息是否正确

2. 检查编码类型是否匹配