功能说明

  • 平台可自定义搭建外部数据源，并作为数据源供关联控件选择使用。
  • 外部数据源可为数据库或者是接口

操作步骤

一. 外部数据源为 数据库

1. 连接数据库

  1. 后台>>数据源管理>>数据库连接>>添加

image.png

b. 编辑数据库连接

  • 填写编码
  • 显示名称
  • 数据库类型：选择 SqlServer
  • 填写服务器名称：与数据库地址相同
  • 数据库名称：填写需要连接的数据库
  • 用户名：填写数据库登录名
  • 输入密码
  • 数据库描述

image.png

c. 填写完成后点击确认即可

2. 设置业务方法

a. 后台>>业务集成>>添加业务服务

  • 适配器：选择Data Table Adapter
  • 服务编码/显示名称：可自定义
  • 业务数据库：选择第一步所连接的数据库
  • TableName：选择需要操作的数据库

平台会自动生成增、删、改、查的相关sql语句，根据需求选择其中的一项，其余可以删除

image.png

  1.  b. 设置完成后点击保存即可

3. 创建表单

a. 进入功能模块，新建一个功能，功能类型选择“外部数据源列表”

image.png

b. 添加字段配置列表

  • 外部数据源列表可以创建用户字段，用于列表设置，但前台列表不支持表单查看
  • 外部数据源不存在系统字段

image.png

4. 绑定业务方法

  • 外部数据源列表需要通过业务服务获取数据，无法主动添加
  • 业务服务需要设置输出参数的映射关系，将业务服务获取的对应数据映射到列表的对应字段

a. 添加一个业务方法，绑定上一步在后台创建的业务服务

image.png

b. 设置好入参和出参

image.png

注：

  • 在绑定输出参数时，在后台数据源里边编辑的sql语句可能只是查询数据库表中的某几个字段，但是在这个输出参数列表中，会将数据库中的所有字段显示出来，只需根据需求找到对应的字段并绑定即可

image.png

  • 在设置输入参数，选择的映射方式为Const 时，如果常量为空，则前台表单中将不会显示数据，原因是：映射方式为const时 相当于 将控制区过滤了

image.png

5. 效果图

image.png

二、外部数据源为 接口

1.创建外部数据源的业务集成

业务集成使用说明参考：https://www.yuque.com/s2/wwugil/oq5qsh
1. 业务集成基本信息设置：

image.png

2.输出参数设置：

例如http:192.168.0.184:5001/api/Test/GetExDataSourceList代码：

  1.    [HttpGet()]
  2.         [RedirectReturn]
  3.         public List<UserInfoResponse> GetExDataSourceList(string a, string b, string c)
  4.         {
  5.             List<UserInfoResponse> list = new List<UserInfoResponse>();
  6.             for (int i = 0; i < 50; i++)
  7.             {
  8.                 list.Add(new UserInfoResponse()
  9.                 {
  10.                     ObjectID = Guid.NewGuid().ToString(),
  11.                     Name = $"user{i + 1}",
  12.                     Email = $"user{i + 1}@qq.com",
  13.                     SortKey = i + 1
  14.                 });
  15.             }
  16.             return list;
  17.         }

接口返回的json

  1. [{
  2.     "ObjectId": "xxxx",
  3.     "Name": "user1",
  4.     "Email": "user1@qq.com",
  5.     "SortKey": 1
  6. }, {
  7.     "ObjectId": "xxxx",
  8.     "Name": "user2",
  9.     "Email": "user2@qq.com",
  10.     "SortKey": 1
  11. }]

对应的输出参数设置如下：其中根节点Sub为子表类型,Sub名称可以任意取，子表类型子参数为接口返回的各字段。

image.png

2.创建外部数据源列表

1.添加外部数据源列表功能

image.png

在新增功能模块可添加外部数据源列表

2.添加字段配置列表
外部数据源列表可以创建用户字段，用于列表设置，但前台列表不支持表单查看，且外部数据源不存在系统字段

image.png

image.png

3.业务服务绑定

外部数据源列表需要通过业务服务获取数据，无法主动添加
业务服务需要设置输出参数的映射关系，将业务服务获取的对应数据映射到列表的对应字段

image.png

4.前台数据查看
外部数组源列表暂只支持列表模式查看，不支持数据的编辑及新增，也不支持数据搜索及排序

image.png