1. 控件介绍
参照控件用于在当前页面中引用实体数据。控件需要绑定实体类型的字段,参照控件只能引用这个实体字段关联实体的数据。
2. 使用场景
场景举例:在费控应用中,成本中心、费用报销单是两个实体,在填写费用报销单时需要选择成本中心, 选择后在控件中回显成本中心名称。 选择成本中心就是使用参照控件。
3. 控件特性
3.1 绑定字段
可绑定字段数据类型:实体
参照单选或多选:绑定的字段如果是多选,那么该参照控件可选择多条数据,否则只能单选。可在实体的字段列表中确认配置的是否多选。
3.2 选择参照方案
3.2.1 选择参照方案
参照方案实质是数据查询方案。参照控件绑定参照方案,运行态可以选择该参照方案查询的数据。
每个实体可以创建多个参照方案。请查看参照方案的详细介绍
参照控件只能选择绑定字段关联的实体的参照方案。比如参照控件绑定了字段“采购物品",该字段关联了实体"物品",那么参照控件可选到实体“物品"的参照方案。
当关联实体创建了多个参照方案,此处会默认使用第一个参照方案,可以手动选择其他方案。也可以点击”新建"跳转到实体中创建参照方案。
3.2.2 页面自定义参照方案
点击选择参照方案旁边的
,可以修改该参照方案的配置,确定修改后会新生成一个页面自定义参照方案,该参照方案仅当前参照控件可以使用。自定义参照方案说明:
- 自定义参照方案仅当前参照控件可用,而实体中创建的参照方案是整个应用中都可以使用。
- 生成自定义参照方案,并不会对原实体的参照方案产生影响。
- 参照方案名称后有”自定义"标识,表示是自定义参照方案。
- 在PC转移动时,自定义参照方案不会转换。
- 在属性区修改参照显示字段、参照下拉字段,实际和进入弹窗修改是一样的,该参照方案会自动变成自定义参照方案。
3.3 参照显示字段
参照显示字段是指选择了参照数据后,回写到控件中的字段。
默认使用该参照方案中配置的显示字段,也可以在控件中自定义。
3.4 参照下拉字段
参照下拉字段是指选择参照数据时,下拉框中显示的数据。未设置时默认使用参照显示字段。
举例:下图中,设计态参照控件的下拉字段配置的是商品编号、商品名称两个字段。
运行态,可以看到下拉框中显示的是商品编号和商品名称。
3.5 参照携带
3.5.1 使用场景
参照携带是指将关联实体的某些数据带到页面控件中。
场景举例1:报销单中选择报销人,希望在其他控件中展示报销人的所属部门和所属岗位。
场景举例2:请购单中选择请购物品,希望在其他控件中展示物品编号和物品分类。
3.5.2 配置说明
(1)选择携带到控件
携带到控件是指将数据携带到当前页面中的哪个数据控件中。
可选范围:当前参照控件所在的数据控件和下一级数据控件(不是绑的孙实体及以下实体)。
举例说明:页面中有单一记录绑定主表,有重复表绑定子表,重复表就算是下一级数据控件。如果参照控件在单一记录中,那么可以往单一记录和重复表中携带数据; 如果参照控件在重复表中,那么只能往重复表中携带数据。
(2)携带映射
左侧:关联实体、关联实体的上级实体、关联实体的下一级实体的字段。
右侧:携带到数据控件中的子控件
将左侧数据携带到右侧控件中。比如将物品信息实体中的编码,携带到页面中的物品编码[单行文本]。
(3)携带映射匹配规则
参照映射时,左右值类型必须匹配,平台已做了自动过滤:
- 右侧可选项必须匹配左侧的数据类型,平台已经做了自动过滤。
- 左侧枚举、选项集、实体类型字段只能映射给右侧绑定了相同枚举、选项集、实体的控件。
- 左侧数据多选的字段不能映射给右侧数据单选的控件。
- 当前参照控件多选且要同级携带(同级携带是指参照控件在要携带到的数据控件中),左侧字段类型只能是文本、实体、长整数。
(4)携带映射条件
参照携带支持条件配置,当满足条件时才会执行。
如下图:携带到控件这里可配置映射条件,单条映射也可以配置条件。前者是前置条件,如果都无法满足,不会执行后面的单条映射。
(5)自动映射
当需要携带的控件很多时, 我们提供了自动映射功能,会根据左右值类型匹配规则做自动映射。
自动映射时,需要选择映射来源实体(关联实体、关联实体的上级实体、关联实体的下一级实体), 默认是关联实体。
自动映射时,如果发现右值的控件已经配置了映射,可以选择保留已有的映射或者覆盖已有的映射。
3.6 选多个插入多行
使用场景:参照单选,且在重复表中。运行态支持选择多条数据,在重复表中插入多行,插入时可复制上一行的内容。
前置条件:参照单选,且在列表中。
配置方式:开启属性“允许选多个插入多行",如果插入行时复制当前行其他列的数据,可以开启属性“插入行时复制当前行"。
运行态效果:
3.7 清空携带
使用场景:主表中选择参照,并携带数据到子表的多记录控件中。
开启“清空携带":表示修改参照,清空之前携带到多记录控件的数据。
不开启“清空携带":表示修改参照,不清空之前携带到多记录控件的数据,继续追加携带数据。
注意:清空携带是前端行为,如果携带数据已经保存,修改参照是不会清空携带数据的。
运行态效果如下:修改进货商品,删除之前已经携带的内容。
3.8 删除标识
当开启后,参照控件已选项后有“X"删除图标;如果不开启, 可通过快捷键delete删除
3.9 仅显示参照图标
参照控件配置中,可以设置开启仅显示参照图标,打开后,参照控件隐藏,仅图标显示。