功能说明
- 平台可自定义搭建外部数据源,并作为数据源供关联控件选择使用。
- 外部数据源可为数据库或者是接口
操作步骤
一. 外部数据源为 数据库
1. 连接数据库
- 后台>>数据源管理>>数据库连接>>添加
b. 编辑数据库连接
- 填写编码
- 显示名称
- 数据库类型:选择 SqlServer
- 填写服务器名称:与数据库地址相同
- 数据库名称:填写需要连接的数据库
- 用户名:填写数据库登录名
- 输入密码
- 数据库描述
c. 填写完成后点击确认即可
2. 设置业务方法
a. 后台>>业务集成>>添加业务服务
- 适配器:选择Data Table Adapter
- 服务编码/显示名称:可自定义
- 业务数据库:选择第一步所连接的数据库
- TableName:选择需要操作的数据库
平台会自动生成增、删、改、查的相关sql语句,根据需求选择其中的一项,其余可以删除
b. 设置完成后点击保存即可
3. 创建表单
a. 进入功能模块,新建一个功能,功能类型选择“外部数据源列表”
b. 添加字段配置列表
- 外部数据源列表可以创建用户字段,用于列表设置,但前台列表不支持表单查看
- 外部数据源不存在系统字段
4. 绑定业务方法
- 外部数据源列表需要通过业务服务获取数据,无法主动添加
- 业务服务需要设置输出参数的映射关系,将业务服务获取的对应数据映射到列表的对应字段
a. 添加一个业务方法,绑定上一步在后台创建的业务服务
b. 设置好入参和出参
注:
- 在绑定输出参数时,在后台数据源里边编辑的sql语句可能只是查询数据库表中的某几个字段,但是在这个输出参数列表中,会将数据库中的所有字段显示出来,只需根据需求找到对应的字段并绑定即可
- 在设置输入参数,选择的映射方式为Const 时,如果常量为空,则前台表单中将不会显示数据,原因是:映射方式为const时 相当于 将控制区过滤了
5. 效果图
二、外部数据源为 接口
1.创建外部数据源的业务集成
业务集成使用说明参考:https://www.yuque.com/s2/wwugil/oq5qsh
1. 业务集成基本信息设置:
2.输出参数设置:
例如http:192.168.0.184:5001/api/Test/GetExDataSourceList代码:
[HttpGet()]
[RedirectReturn]
public List<UserInfoResponse> GetExDataSourceList(string a, string b, string c)
{
List<UserInfoResponse> list = new List<UserInfoResponse>();
for (int i = 0; i < 50; i++)
{
list.Add(new UserInfoResponse()
{
ObjectID = Guid.NewGuid().ToString(),
Name = $"user{i + 1}",
Email = $"user{i + 1}@qq.com",
SortKey = i + 1
});
}
return list;
}
接口返回的json
[{
"ObjectId": "xxxx",
"Name": "user1",
"Email": "user1@qq.com",
"SortKey": 1
}, {
"ObjectId": "xxxx",
"Name": "user2",
"Email": "user2@qq.com",
"SortKey": 1
}]
对应的输出参数设置如下:其中根节点Sub为子表类型,Sub名称可以任意取,子表类型子参数为接口返回的各字段。
2.创建外部数据源列表
1.添加外部数据源列表功能
在新增功能模块可添加外部数据源列表
2.添加字段配置列表
外部数据源列表可以创建用户字段,用于列表设置,但前台列表不支持表单查看,且外部数据源不存在系统字段
3.业务服务绑定
外部数据源列表需要通过业务服务获取数据,无法主动添加
业务服务需要设置输出参数的映射关系,将业务服务获取的对应数据映射到列表的对应字段
4.前台数据查看
外部数组源列表暂只支持列表模式查看,不支持数据的编辑及新增,也不支持数据搜索及排序