实体参照
少于1分钟
1. 功能概念
业务中常见一种场景，当前页面需要引用其他实体的数据，该场景在低代码平台中定义为“参照”，如：在填写进货单时可以选择已有的商品，其中进货单和商品是两个不同的实体。
参照方案：本质是数据的查询方案，每个实体可以配置多个参照方案，会以参照方案的配置生成该实体的数据列表，供其他实体引用。
参照控件：是一种数据录入的基础控件，参照控件绑定关联实体的参照方案，运行态可以选择该参照方案查询的数据。请查看参照控件的详细介绍
在填写进货单时选择商品，演示效果如下：
2. 功能介绍
2.1 参照样式
在运行态选择参照方案的数据，有三种样式：列表、左树右列表、树表。
（1）列表：所有实体均可配置列表参照。
（2）左树右列表：实体中必须有字段关联了树形实体，才可展现为左树右列表样式。
比如：[商品]实体中有实体类型的字段“商品类别”，“商品类别"关联了树形实体[商品类别]，那么[商品]实体的参照可以设置成左树右列表样式，左侧是商品类别，右侧是商品列表。
（3）树表：仅树形实体可配置树表参照。
运行态列表参照：
运行态左树右列表参照：
2.2 参照方案配置
2.2.1 选择参照模板
（1）选择参照样式模板：列表、左树右表、树表。
（2）配置参照名称。运行态将在参照选择数据的弹窗中展示参照名称，所以，需要设置合适的参照名称。
（3）选择终端。 PC和移动端的参照是默认勾选且不可取消。
设计态配置界面：
2.2.2 设置参照内容
2.2.2.1 实体
- 首先需要理解参照驱动实体。参照驱动实体是指哪个实体的参照方案。主实体和一对多子实体都可以设置参照方案，他们都可以作为驱动实体。主实体作为驱动实体，参照列表是以主的维度展示数据；子实体作为驱动实体，参照列表是以子的维度展示数据。
- 进入参照内容设置中，“实体”会默认勾选驱动实体，且不可以取消， 还可以手动选择驱动实体的子实体。
设计态配置界面：
2.2.2.2 参照显示字段
- 参照显示字段是指选择参照方案后回写到参照控件中的数据。比如选择人员后，参照控件显示人员姓名。
- 参照显示字段只能选驱动实体的字段，但不支持实体、枚举、附件、多行文本类型的字段。
- 参照显示字段支持选择多个字段，比如人员实体的参照回显姓名和工号。参照显示字段还支持手动输入常量，比如想回显为“姓名+工号”，可在输入框中手动输入“+”。 注意：手动输入的常量不建议使用类似变量的文案，比如”姓名"，容易与变量混淆。
设计态配置界面：
2.2.2.3 参照下拉字段
- 参照下拉字段是指在参照控件中通过下拉框快捷选择参照数据时，在下拉框中展示每条数据的关键字段。比如选择商品，在下拉快捷选择时展示商品编号和商品名称。
- 未设置时默认使用参照显示字段。
- 参照下拉字段只能选到驱动实体的字段，但不支持实体、枚举、附件、多行文本类型的字段。仅PC端有该配置，移动端的参照组件交互不需要该配置。
设计态配置界面：
2.2.2.4 数据关联
- 数据关联是指驱动实体的数据和另一个关联了当前实体的实体数据取交集。
- 场景搭建举例：
前置：两个实体[商品]、[进货表]，[库存表]中有一个实体类型字段“商品编号”，该字段关联了实体[商品]且单选**（多选不支持数据关联)**。
需求：在出库单中，只选择库存表中的商品。
搭建：该需求的本质是选择商品，所以需要做商品的参照方案，但只能选择库存表中的商品。
在[商品]的参照方案中数据关联[库存表]。约束实体选择[库存表]，关联字段会默认使用[库存表]中的“商品编号"字段。
设计态配置界面：
2.2.2.5 显示列
显示列是指在参照列表中显示哪些字段。当参照方案是左树右列表样式时，需要分别配置树和列表。当参照方案是列表或树表样式时，只需要配置列表。
- 列表显示列字段的可选范围：
（1）驱动实体是主实体，“实体"只选了主实体，显示列只能选到”实体"的字段。如下图配置界面：
（2）驱动实体是子实体， “实体"选择了子实体和孙实体。参照显示列可选到“实体"中的字段（框红)， 也可以选到驱动实体的上级实体字段（框蓝)。如下图配置界面：
2.2.2.6 条件
设置参照列表的过滤条件，参照列表中仅展示满足条件的数据。条件左值可选字段范围与“实体”中的配置有联动关系。
设计态配置界面：
2.2.2.7 排序
对参照列表数据排序，排序字段可选范围与“实体”配置保持一致。
当有多个排序字段时，先按第一个字段排序，第一个字段相同的行再用第二个字段排序。
设计态配置界面：
2.2.2.8 搜索
- 参照列表进行搜索。搜索字段可选范围与“实体”配置保持一致。
- 支持多种搜索样式 。详细介绍请查看不同字段类型的搜索样式。
- 实体类型字段作为搜索字段时，需要选择参照方案。运行态搜索时，可以在下拉中快捷搜索或进入到参照列表中选择数据。
- 快速搜索：快捷搜索是指直接在参照控件输入框中进行搜索，仅支持使用文本类型字段做快捷搜索。
- 搜索匹配方式：文本类型字段用于搜索时，默认使用左匹配。
设计态配置界面：
运行态效果：
2.2.2.9 穿透页面
穿透页面只能是详情页面，且页面对应实体是驱动实体的主实体。
运行态点击参照控件回写的内容，或参照列表中点击参照显示字段所在列，都可以打开穿透页面；一般用于查看数据详情。
运行态演示效果：
2.2.2.10 新增页面
- 主要用于找不到预期的参照数据，可以打开新增页面新增一条数据。默认新增页面和穿透页面是同一个页面。
- 配置了新增页面，将默认在参照列表中展示新增按钮，点击按钮打开新增页面。
设计态配置界面：
运行态演示效果：
2.2.2.11 左树右列表参照配置
左树右列表参照方案，需要分别配置树和列表。
树的配置中，显示列、条件、排序、搜索的配置和列表是一致的。下面说明数据源和字段。
数据源：驱动实体中关联的树形实体，且该树形实体为当前应用中的实体。 运行态以该数据源的数据来渲染左树。
选择字段：当驱动实体中有多个字段关联了这个树形实体，运行态点击树节点对列表过滤时，按指定的这个字段进行过滤。
2.3 参照方案PC转移动
支持一键将PC端的参照方案配置转到移动端，提高搭建效率。
相同的属性是完全一致转换， 有个别特殊的转换规则说明如下：
（1）搜索配置：实体类型字段的参照方案会默认取PC已选的参照方案的对应移动端参照方案，如果未找到，则默认用移动端第一个参照方案。如果未配置参照方案，一致性检查会报错。
（2）穿透页面配置：会默认取PC端页面对应的移动端页面，如果页面入参一致，也会进行参数映射的转换。