# 4.1数据接入
Wemax支持数据接入,该菜单下主菜单下分别介绍了:数据源、数据表预览、数据授权预览、API管理、SQL 模型、桥接连接器、连接器API等功能的新建和操作
# 4.1.1 数据源
主要提供数据源新增、详情、修改、删除 常见的有MySQL连接 您需要准备MySQL相关的连接串、用户名、密码、数据库信息、Schema(DWS);
请确定您的数据库连接信息是公网地址能够访问的,如果不能访问请考虑私有化部署方案或者云桥方案;
您可以在此页面添加自己的数据源。
点击 过滤我创建的数据源
查询数据源和排序数据源列表
新增数据源
【数据接入】,点击按钮【+】,如下图 :
点击【新增数据源】按钮后,弹出会画框【新增数据源】,如下图:
在【新增数据源】对话框,选择基础信息 - 数据源类型【MySQL】然后配置数据源的相关参数;
例如,数据源类型选择【MySQL】
设置数据库连接参数
单击“确定”,保存并创建数据源连接。
创建数据源后,可以基于当前数据源新建SQL模型 。然后在屏幕设计器中,将组件绑定SQL模型,动态渲染组件。
修改数据源
可在输入框中进行数据源信息修改
查看数据源详情
鼠标移动至目标数据源并Hover其上,可查看【详情】;
点击【详情】按钮后,页面跳转至【数据表预览】菜单页,并关联显示上一步对应的数据源;
# 4.1.2 数据表预览
可以看到数据源相关的表数据,选择数据源+对应的数据库+数据表,即可执行并预览当前表数据
# 4.1.3 数据SQL模型
可以基于数据源的连接信息,在系统中编写 SQL 去获取数据。SQL 模型下,可以新建、删除、修改 SQL 模型。
在【SQL模型】列表页面,单击【+】。
在新建SQL模型弹窗,输入SQL模型名称,SQL模型描述,基于已有SQL模型新建,选择数据源+数据库
点击测试,动态参数相当于在SQL语句中添加了动态变量的占位符,方便屏幕运行时,组件动态传参,以便能够支撑动态查询数据的需求。
单击【确定】,sql模型创建成功。
# 4.1.4 数据授权明细
管理员可以在项目配置中设置数据授权明细规则,设置成功后在数据授权明细中进行预览,搜索,查询等操作
# 4.1.5 API连接器
Wemax对数据可启用代理进行服务转发,包括Roma、normalApi等, 要使用这些服务首先需创建桥接连接器 可以对第三方REST URL进行代理转发 桥接连接器和API管理中的启用代理配置配合一起使用 说明:在桥接器中默认配置完整REST URL的域名,那么不同REST URL,只要域名相同,即可在配置连接器API时只创建一个连接器共用 范例: www.baidu.com/wemax/rest/url,桥接器连接器可配置为:www.baidu.com,API管理中API接口为:/wemax/rest/url, 记住桥接连接器和API管理中设置的api接口一定是可拼接的完整REST URL(仅针对API管理中开启了启用代理的api)
当前支持新建、编辑、详情查看、删除
新建
如果您需要调用Roma平台的服务,那么可以使用Roma桥接方式。
您需要准备好调用Roma服务的服务地址、APPID、APPkey、API接口、调用方式 ,
创建成功后,在API管理中进行配置
# 4.1.6 API管理
Wemax支持创建可视API,将复杂的REST URL服务解析成,参数可视,结果可视,可复用的API模型;在设计器数据配置,选择API模型,选择对应的模型,将字段拖拽进维度或度量
Wemax也支持将第三方REST URL服务进行代理服务的转发操作(需要提前创建好API桥接器)
首先,我们来进行API模型创建和实操使用
即可快速展示数据,如下,我们以WeMAx大屏测试为例来创建操作,
第一步:【+】添加可视API
API名称:自定义
分组:自定义
请求方式:提供的API URL是GET/POST
可编辑人员:可对可编辑人员进行添加,默认为当前创建人
API URL: 为服务请求地址
描述:自行添加
创建可视API 一定要开启可视API 按钮
Path参数:当API URL 中配置了路径参数,那么Path参数可自动识别路径参数
如图配置,API URL中/后面接参数名称
例如:https://xxx/dmstenant/tenantManager/v1/operations/screens/list/${action}/${apiId}
当前url所传路径参数为action和appId,路径参数配置中可自动获取,若没有Path参数则不需要配置
请求参数配置等同于---》可视设计---组件设置---数据设置---API模型---过滤项
请求头设置,当前API URL服务支持请求头配置,
响应参数等同于
保存&发布---》可视设计---组件设置---数据设置---API模型---字段
可进行维度和度量的不同结果获取
保存后进行发布
发布后可在可视设计页面进行选择调试
字段为可视API的响应结果配置,根据不同筛选条件进行不同维度,度量的值返回
最终展示在页面上
其次,我们来针对服务代理转发配置的创建和实操指导
此页面一定要勾选启用代理
填写对用配置信息
API名称:可自定义
分组:可自定义
请求方式:GET/POST
可编辑人员:可做添加,若无添加默认为当前创建人
API桥接器:AIP桥接器中所创建的服务类型
鉴权方式:自动识别
API接口: API桥接器使用了REST URL完整地址的域名,这里为域名后半段
描述:可自定义
点击保存&发布
发布后,点击复制按钮,wemax对当前服务会生成新的REST URL,与当前环境同域名,权限由平台进行转发鉴权
或者在操作按钮下选择复制URL
进入可视设计中使用
选中组件,切换为REST URL 在数据服务URL中粘贴数据服务地址