> ## Documentation Index
> Fetch the complete documentation index at: https://help.dingtalk.io/llms.txt
> Use this file to discover all available pages before exploring further.
# 关联查询
> 本文介绍了关联查询组件在表单中的应用，包括其使用场景、功能说明、字段属性以及注意事项。该组件支持高效的数据查询展示，适用于人事OA管理系统等多种数据查询场景。
## 使用场景：
在核心表单中通过关联查询其他表单数据，可应用于多种数据查询的场景，如：
● 人事 OA 管理系统中，在个人信息首页查看自己的员工档案信息、会议预约记录、考勤记录等数据；
| **Before（配置繁琐、数据条数存在上限、无法嵌套查询）**
比如“产品”对应原材料的表，目前用子表的方案实现，**子表数据量上限为500条**，且**子表无法再嵌套关联子表。**
 | **After（简单、直接、高效、易理解、提高场景数据适配上限、支持递归嵌套查询）**
直接引用“关联查询”组件，查出关联表的明细进行展示，无需用子表内每个字段默认值数据联动的方式 配置，提高最佳实践的配置效率，降低操作和理解成本，同时支持关联查询子表信息。
 |
| ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
### 组件功能使用说明
### 1. 字段简介
关联查询作为单独的查询展示功能，可以自动查询出其他表单中的一条或多条数据，且不做入库处理。
**组件功能使用范围说明：**
1. 宜搭所有版本均支持使用。【双端适配】
2. 适用于宜搭普通表单、流程表单页面类型，暂不支持在自定义页面内使用。
3. 由于该组件的使用特性，适用于单纯的数据查询或查看的场景，不需要将数据提交入库。因此该组件目前仅适用于表单详情页，其他功能消费场域（如数据管理页等）暂不支持透出该组件。
4. 单选下拉、多选下拉等组件显示/隐藏逻辑里可以消费“关联查询组件”
### 2. 字段属性
#### 2.0 通用属性
关联查询组件 通用属性包括：
1. 标题
2. 状态：普通/只读/隐藏
3. 无数据时显示内容：支持自定义
#### 2.1 关联属性
您可以选择关联表单，支持关联本应用表单和跨应用表单
#### 2.2 显示字段
#### 2.3 数据过滤
您可以对关联查询出来的数据进行数据筛选，符合过滤条件的数据将作为查询结果显示在相应字段中。
#### 2.4 显示数据条数
您可以定义关联查询数据的现实效果：「单条」和「多条」
a. 「单条」：适用于关联详情查询，按照提交顺序显示最近提交的一条数据。
b. 「多条」：适用于关联列表查询，符合筛选条件等限制的多条数据将一并在列表中进行呈现
i. 当选择关联流程表单时，关联的流程表单数据仅能查询到实例状态为“已完成”的数据
#### 2.5 关联表操作
当关联表单中无数据时，您可以在数据展示为「多条」的情况下，勾选「允许新增」关联表数据后，即可在列表内直接在目标表内新增数据。
⚠️注意：当前关联表单为流程表单，不支持新增，且关联展示的数据状态仅包括「已完结」。
### 3. 注意事项
1. 关联查询的列表数据最多展示5000条。
2. 关联查询流程表单数据时，仅支持查询流程状态已完成的数据。
3. 当页面内存在该组件时，无法开启公开访问。
4. 关联组件查询的数据继承表单字段/数据权限的范围。
5. 当关联查询的表单被删除时，会出现异常提示：
