1.功能介绍
对数据库中表或视图的数据查询,数据查询出来可用在表单的下拉框、单选框,复选框等控件的动态选项中;
若想要查询外部数据库的的数据表或视图,需要先在【设计中心】→【外部数据源】中添加外部数据库的链接参数;
2.操作指引(数据源)
2.1 新增关联查询
第一步:【设计中心】→【元件管理】→【关联查询】,点击“添加”;
第二步:填写关联查询信息、设置关联查询属性、选择表;
第三步:点击设置列-进入设置列页面,设置关联查询的条件字段、返回字段等,设置完毕后点击保存;
第四步:设置完毕,点击保存;
添加对话框页面说明:
1、 名称、别名为必填项,且别名必须是唯一的;
2、 数据源的配置在【设计中心】→【外部数据源】模块,可设置外部数据表查询;
3、 选择数据源后,需要先点击查询表或视图后面的“查询”按钮;
4、 查询表或视图:在输入框中输入表名,可查询对应的表(查询结果在选择表或视图中显示),不输入表明,点击查询,查询该数据库中的全部表;
设置列页面说明:
1、 在左侧选择字段点击新增,便可添加在右侧列表;
2、 返回字段:即选择对话框的数据后,返回该数据中的哪些字段内容;
在表单中下拉框、单选按钮、复选框中的动态选项中使用该关联查询,设置方式如下图:
预览效果:
3、 条件字段:设置要筛选出特定信息的要输入的条件;
值来源:固定值,即根据设置的默认值筛选对话数据;
值来源:参数传入,即根据变量来筛选对话框列表数据;
使用方法:
在表单中绑定关联查询,选择要传入的参数。设置返回值,如下图:
预览效果:
4、 排序字段:设置可排序字段,可选择是升序还是降序;
5、 自定义SQL:可根据自己的需求来写SQL进行查询操作;
2.2 编辑关联查询
第一步:【设计中心】→【元件管理】→【关联查询】,点击关联查询名称;
第二步:修改关联查询内容;
第三步:修改完毕后点击保存;
注:1.关联查询绑定的数据源及选择的表不可修改;
2.点击设置列,可修改条件字段、返回字段等属性;
3.关联查询绑定表单的步骤在【业务表单】中的控件说明有详细介绍;
2.3 预览关联查询
第一步:【设计中心】→【元件管理】→【关联查询】,点击列表操作列的“预览”按钮,即可预览关联查询中查询出来的结果;
4 删除关联查询
勾选需删除的关联查询(可多选),点击“删除”,可删除关联查询。如下图所示:
注:删除关联查询时请确认该关联查询没有在表单中绑定使用,否则在打开表单中会中提示该关联查询不存在;
5 添加为对话框
将中的关联查询配置同步添加为对话框:
第一步:【设计中心】→【元件管理】→【关联查询】,点击列表操作列的“添加为对话框”;
第二步:在弹出的“确认添加为对话框?”提示框中,点击“确定”;
注:添加为对话框后,可在对话框列表中查看该数据;
3.rest接口示例
说明:示例仅供参考,
3.1 Post请求:示例--获取某个组织下的用户
l 关联查询配置说明:
请求地址:${uc}/api/org/v1/orgUsers/getOrgUserPage
请求类型:POST
列表(KEY): rows(如果返回的数据为复杂结构,请输入列表数据的key;支持多级嵌套结构,例如result.rows)
配置如下图:
设置列配置如下:
① 添加字段orgid_(组织id)、userId(用户id)、fullName(用户名称)
② 将userId(用户id)、fullName(用户名称)添加到返回值列表
③ 将orgid_(组织id)添加到条件字段列表
④ 输入POST请求参数(POST方式请求接口时传入的参数,参数中可以通过${field}传入条件字段中定义的参数)
{ "groupRelation": "AND", "pageBean": { "page": 1, "pageSize": 10, "showTotal": true }, "params": {}, "querys": [ { "group": "main", "operation": "EQUAL", "property": "org.ID_", "relation": "AND", "value": "${orgid_}" } ]
} |
表单配置说明:表单中有三个字段(组织名称、组织id、用户名称),输入组织id后,用户名称中只能选择属于所填写组织id下的用户
预览效果:
3.2 Get请求:示例--获取某个用户拥有的角色;
l 关联查询配置说明:
请求地址:${uc}/api/role/v1/role/getRolesByUser
请求类型:GET
列表(KEY):此处不需要填写(如果返回的数据为复杂结构,请输入列表数据的key(支持多级嵌套结构,例如result.rows))
配置如下图:
设置列配置如下:
① 添加字段name(角色名称)、code(角色编码)、account(用户账号)
② 将name(角色名称)、code(角色编码)添加到返回字段列表
③ 将account(用户账号)添加到条件字段列表
l 表单配置说明:
表单中有三个字段(用户名称、用户账号、用户所属角色),输入用户账号后,用户所属角色会筛选出所输入账号的角色
预览效果:
4注意事项
1、 如果是在本系统中的数据库中直接添加的数据表或视图,表或视图中都需要加上tenant_id_ ,里面放租户id(平台租户是 -1);如下图:
2、 如果是使用建模新增的表,则不需要添加tenant_id_,新增建模时会自动添加该字段;
3、 使用外部数据源的表,也不需要添加tenant_id_;