「查阅项」控件让填表人从已有数据中选择记录。例如,在采购申请中先选「产品分类」,再从该分类下选产品,并将单价带入表单。该控件可用于列表表单和审批表单。
使用查阅项字段的其他优势
多张表单可以引用同一份基础资料。例如,将产品集中维护在产品列表中,让多个采购表单引用这些产品。也可以把任务关联到项目,便于按项目查找任务。创建数据列表并关联记录
定义
项目 ID。源列表中每条记录的标识。查阅项按记录标识链接数据,可区分两条同名记录。
数据源。提供候选记录的列表,可以来自当前应用或有权配置的其他易企办应用。利用表单报表作为数据源
目标表单。放置查阅项的列表表单或审批表单。关联变量保存选择结果,其他字段可接收配置好的回填值。
如何添加查阅项
先准备源列表和几条可供选择的记录。在目标表单设计器找到「查阅项」,拖到画布上的区域或容器。若要先在数据列表里建立字段,请参阅数据列表中的查找字段。
查阅项控件的基础
选中控件,在「内容 → 基础」填写标题并检查「关联变量」。可编辑自动生成的变量,或通过「重置」关联已有的兼容变量。
选择「应用」和「数据源」。在采购申请中,将产品查阅项连接到维护名称、分类和单价的产品列表。
在「数据过滤」点击「过滤条件」。用表达式将源列表的产品分类与表单当前所选分类匹配。添加多条条件时,返回同时满足条件的记录。
按需要设置「首要排序」和「次要排序」。切换或清空分类,核对候选产品及已选值的变化。
查阅项控件的外观
在「内容 → 外观」中选择数据选择器或下拉菜单,按需要开启多选,填写占位符和提示,并决定是否允许评论。
在查阅项设置中调整选择器里的显示列和顺序。例如,同时显示产品名称和产品编号,方便区分同名记录。
要把资料带入当前表单,在「关联字段」中匹配同类型的源字段和目标字段。例如,把产品列表的「单价」带入采购表单的「单价」。预览时选择、更换和清空产品,核对回填值。字段回填实例
验证
在「内容 → 验证」设置只读、必填或自定义验证。分别用有值和无值的样例测试提交。
只读
启用「只读」后,用户可以查看已选记录。例如,审批人只需核对申请人选过的产品时,可在任务表单中将查阅项设为只读。
必填
启用必填后,表单会检查可见的查阅项是否已选择记录。未选择时会提示补填,提交受阻。控件可能被动态隐藏时,请分别测试显示和隐藏状态。动态显示规则
自定义验证
为业务条件设置自定义提示。用一条应通过的样例和一条应报错的样例测试,核对提示是否出现在正确的控件。自定义验证
查阅项的操作调用
在「内容 → 动作」选择已配置的表单动作。查阅项的值发生变化时会触发该动作,例如更换产品后重新计算当前表单里的金额。分别测试选择、更换以及清空记录。表单动作
样式化查阅项控件
在「样式 → 字段 - 可编辑」设置输入区域、按钮、占位符、已选项和错误提示。
输入区域。调整字号、颜色、边框及内边距。可分别设置普通和聚焦状态。字段宽度小于容器时,可调整字段本身的对齐方式。
按钮和占位符。选择清晰的颜色,预览打开选择器前后的状态。
已选项和错误提示。调整已选记录的间距和外观。开启多选时在窄屏核对换行。触发一次校验,确认提示文字清楚可见。
字段 - 只读
在「样式 → 字段 - 只读」调整已选项的字号、颜色、边框和间距。未单独设置时,会沿用可编辑样式中的选中项样式。
标题样式
在显示设置中决定是否显示标题,按需调整标题布局和宽度。字段控件标题设置
高级设置
用「高级」选项卡调整控件的排版、显示和其他通用设置。保存后,检查需要支持的设备尺寸和表单版本。高级设置选项卡
