数据管理

数据管理模块可对上传至大屏的本地文件、建立的API连接、数据库连接进行统一管理，可视为可视化大屏的“数据网盘”。

该模块共分为三部分：API、文件、数据源。接下来会分别进行介绍这三部分的数据管理的操作步骤与区别。

API

API模块可以新建API连接，从数据库或者OTC数据获取所需数据，并通过API地址的形式被组件引用，从而将数据导入组件进行可视化呈现。在此模块，用户可以创建API，并对已创建API进行统一管理。

（1）创建API

API创建过程共分为三步，分别为录入API基础信息，设置API参数和测试API。

①录入API基础信息

API基础信息包括API名称、地址、请求方式和返回类型，请求方式支持POST和GET两种方式，返回类型支持JSON类型。API名称可自定义，支持输入汉字、英文、数字、下划线的组合，名称必须以英文或汉字开头，长度限制为4~50个字符。API地址可自定义，支持输入英文，数字，下划线，连字符的组合，长度限制为不超过200个字符。设置完成后可以再次修改。

②设置API参数

API支持从数据库获取数据表，也支持获取通过文件模块上传的本地表格，选择数据表后，用户可根据需要灵活勾选输入字段，并点击“一键添加SQL”或者“添加带别名SQL”生成SQL语句，也可以自己编写SQL查询语句，并切换代码页签为参数页签，对参数进行调整。

一键添加SQL：生成SQL语句时，字段名称根据数据表的字段名生成；

添加带别名SQL：生成SQL语句时，字段名称根据数据表字段的描述生成。

自行编写参数语句时，如需要在SQL中添加参数参照语法，可设置多个参数，语句编写示例如下：

正常数据库查询指定条件的sql：select 字段,字段1,字段2 from table_name where 字段='XXXXX'

在Max后台将指定条件换为动态参数的写法：select 字段,字段1,字段2 from table_name where 字段={{.参数名称自定义即可}}

如果需要在参数入参值为空时，返回全部数据，可改为：select 字段,字段1,字段2 from table_name where case when {{.参数名称自定义即可}} is null then 1=1 else 字段={{.参数名称自定义即可}} end

③测试API

此页面可测试API连接，如需要调试参数，需先输入参数。点击“开始测试”按钮，即可调试API，并在右侧窗口查看返回数据。返回数据无异常，即可点击“完成”保存API数据，如有异常，可点击上一步重新调整API参数。

快速任务

此处以获取财芯平台数据网盘数据为例，进行API创建过程讲解与演示。

操作指引

操作一

依次点击“数据管理”“API”“创建API”，进入API创建页面。

操作二

输入自定义的API名称和地址，请求方式选择“POST”，返回类型选择“JSON”，点击“下一步”。

操作三

点击第二步页面左上方“上传的文件”输入框，选择“智算网盘”，在下方列表中选择需要的数据表，并勾选字段，点击“添加带别名SQL”，生成SQL语句，点击“下一步”。

操作四

点击“开始测试”，在右侧窗口查看返回数据，返回数据无异常，即可点击“完成”保存API数据。

（2）API管理

添加完成的API可以进行分组管理，复制API地址给组件输入数据使用，还可以查看API详情，调整API配置，以及删除API数据。

文件

文件模块可以上传本地文件，并对文件进行统一管理。上传的文件可以通过API连接生成API地址，再被组件引用，从而将数据导入组件进行可视化呈现。用户可以对上传的文件进行分组、查看、数据替换和删除等操作。

快速任务

上传一份本地表格文件。

操作指引

操作一

依次点击“数据管理”“文件”“上传文件”，打开新建工作表页面。

操作二

工作表类型选择“EXCEL”，上传文件，点击下一步。

操作三

设置标题行为0（输入为0时取表格第1行数据），修改表名称、字段名称和字段类型，并选择上传的工作表。配置完成后，点击“保存”，完成文件上传。

数据源

数据源模块可直接连接数据库，并对已经建立好的数据库连接进行统一管理。连接时需要数据库类型、服务器地址、端口、数据库、用户名、密码等信息。连接完成后，即可在API模块从数据库中获取数据表，并通过API地址的形式将数据输入组件使用。

API#

（1）创建API#

①录入API基础信息#

②设置API参数#

③测试API#

（2）API管理#

文件#

数据源#

API

（1）创建API

①录入API基础信息

②设置API参数

③测试API

（2）API管理

文件

数据源