关联查询
使用场景:
在核心表单中通过关联查询其他表单数据,可应用于多种数据查询的场景,如:
● 人事 OA 管理系统中,在个人信息首页查看自己的员工档案信息、会议预约记录、考勤记录等数据;
Before(配置繁琐、数据条数存在上限、无法嵌套查询) 比如“产品”对应原材料的表,目前用子表的方案实现,子表数据量上限为500条,且子表无法再嵌套关联子表。 ![]() | After (简单、直接、高效、易理解、提高场景数据适配上限、支持递归嵌套查询) 直接引用“关联查询”组件,查出关联表的明细进行展示,无需用子表内每个字段默认值数据联动的方式 配置,提高最佳实践的配置效率,降低操作和理解成本,同时支持关联查询子表信息。 ![]() |
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1672228965112-c9a48069-e880-44bd-b72d-7243e0f31269.png)
组件功能使用说明
1. 字段简介
关联查询作为单独的查询展示功能,可以自动查询出其他表单中的一条或多条数据,且不做入库处理。
组件功能使用范围说明:
- 宜搭所有版本均支持使用。【双端适配】
- 适用于宜搭普通表单、流程表单页面类型,暂不支持在自定义页面内使用。
- 由于该组件的使用特性,适用于单纯的数据查询或查看的场景,不需要将数据提交入库。因此该组件目前仅适用于表单详情页,其他功能消费场域(如数据管理页等)暂不支持透出该组件。
- 单选下拉、多选下拉等组件显示/隐藏逻辑里可以消费“关联查询组件”
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1672228976391-775f6b95-3677-425e-b641-507ee275edfa.png)
2. 字段属性
2.0 通用属性
关联查询组件 通用属性包括:
- 标题
- 状态:普通/只读/隐藏
- 无数据时显示内容:支持自定义
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1672230524062-8a79708b-172b-48ee-ab7c-d4529262fafa.png)
2.1 关联属性
您可以选择关联表单,支持关联本应用表单和跨应用表单
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1672229002385-1e4b7348-7e85-4460-9f58-b85698326572.png)
2.2 显示字段
- 显示字段:关联查询某个关联表单的字段,进行调取显示。
- 注意:显示字段仅作为填写表单时展示使用,不会提交入库,也不能参与公式等逻辑运算。
- 添加好的“显示字段”支持排序、重命名、删除等操作
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1672229009944-3f051036-6b0a-4424-a738-295833c78ab4.png)
2.3 数据过滤
您可以对关联查询出来的数据进行数据筛选,符合过滤条件的数据将作为查询结果显示在相应字段中。
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1672230664715-19f238d3-5ab2-4f85-bf95-07aa21e3e7b8.png)
2.4 显示数据条数
您可以定义关联查询数据的现实效果:「单条」和「多条」
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1672229025346-d62207a1-4446-45b9-9b47-d47079f6b19d.png)
a. 「单条」:适用于关联详情查询,按照提交顺序显示最近提交的一条数据。
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1672229033577-547c67a7-761e-4cab-b186-6e370450d4e0.png)
b. 「多条」:适用于关联列表查询,符合筛选条件等限制的多条数据将一并在列表中进行呈现
i. 当选择关联流程表单时,关联的流程表单数据仅能查询到实例状态为“已完成”的数据
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1672229041957-f2052a7c-7c21-4adf-9d71-5d5d097c95da.png)
2.5 关联表操作
当关联表单中无数据时,您可以在数据展示为「多条」的情况下,勾选「允许新增」关联表数据后,即可在列表内直接在目标表内新增数据。
⚠️注意:当前关联表单为流程表单,不支持新增,且关联展示的数据状态仅包括「已完结」。
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1672230551713-f487baf8-8b96-43e1-8444-68194271ef9b.png)
3. 注意事项
- 关联查询的列表数据最多展示5000条。
- 关联查询流程表单数据时,仅支持查询流程状态已完成的数据。
- 当页面内存在该组件时,无法开启公开访问。
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1672229066457-1a35a4b0-add0-45ae-b003-918397cebfff.png)
- 关联组件查询的数据继承表单字段/数据权限的范围。
- 当关联查询的表单被删除时,会出现异常提示:
- 当导航栏内表单删除时,已有的数据仍能查询到,访问态进入历史的表单详情页可以看到关联查询组件及数据
- 进入当前表单设计态时,直接点击保存,会校验存在相关报错信息,不能保存成功,需要用户自行校准配置功能,如果删除了这个关联查询组件,新增的数据其表单详情即无关联查询信息。
![](https://yida-support.oss-cn-shanghai.aliyuncs.com/static/png/1672229075822-d5678536-4dd9-400b-8641-06ee0f9c82a7.png)
本文档对您是否有帮助?