列表页面
百度已收录

列表页面模型是最常用的页面模型,本章介绍列表页面的基本信息、列表显示、查询条件和配置按钮四部分的主要功能。

一、基本信息

 

【数据源】:平台支持多数据源,有多数据源管理模块提供配置功能。建立数据集时可以选择相应的数据源,实现跨数据库读取数据。该值默认为本地数据源。

【自定义SQL】:该SQL是列表页面数据的来源,是一个select语句,执行数据查询时就是执行该SQL。该SQL较复杂时,可以手写,较简单时,可以通过按钮“从数据库选择表”或者“从实体模型选择表”自动生成。

【从实体模型选择表】:该按钮会弹出当前应用下实体模型的选择页面,找到实体模型后点击,系统会自动生成该实体模型对应表的“自定义SQL”。自动生成的SQL会过滤掉二进制和大文本类型的字段。

【从数据库选择表】:该按钮会弹出“选择数据库表”页面,输入表名模糊搜索,找到表后点击,系统会自动生成该表的“自定义SQL”。

【解析SQL】:该功能会解析“自定义SQL”中的语句,将SQL查询返回的可用字段自动填入第二页签“列表显示”和第三页签“查询条件”中。

解析SQL执行时,系统会找到SQL中的表对应的实体模型,将实体模型中配置的页面属性,自动同步到页面模型的列字段中。

【提示】:解析SQL执行后,会将解析出的表的信息在这里提示,在组合页面中进行列表联动时,会使用解析出的表的名称当作当前页面模型的key。若解析出多个表,则仅取第一个表。所以当自定义SQL使用多个表时,进行列表联动可能存在问题。

【默认查询】:页面打开时是否自动加载数据。

【是否流程】:页面模型是否是流程管理页面,若是流程页面,则会在查询框位置自动添加流程标识的查询下拉框,在列表的最后自动添加两列,分别是“流程状态”和“流程节点”,并控制删除按钮的使用范围,仅允许流程发起人删除自己发起的流程。

【复选框】:列表中是否显示复选框。

【行号】:列表中是否显示行号。

【分页】:列表是否分页展示。

【分页大小】:若列表分页展示,每一页显示的数据条数。

【加载前事件】:在列表加载数据前执行的一段自定义JS代码。

【加载后事件】:在列表加载数据后执行的一段自定义JS代码。

二、列表显示

 

【列标识】:列的标识,要求唯一,同自定义SQL能够返回的字段对应。

【列名称】:列的显示名称。

【列类型】:列的字段类型。

【对齐方式】:列数据显示时的对齐方式。

【列宽度】:列的宽度,默认不设置,自动平均宽度。

【显示】:当前列是否显示。

【可导出】:执行导出动作时,当前列是否可以导出。

【脱敏】:配置数据脱敏展示方式。

【数据转换配置】:数据转换配置是一个按钮,标有红星的表示已经配置过内容。当列表查询数据时,该功能会将数据库中的存储数据转换成显示文本。

打开数据转换配置页面,看到“从实体模型更新数据”按钮,当列表对应实体模型的当前字段的数据转换配置有更新时,用户可以通过该按钮将实体模型中数据转换配置的修改同步到列表模型中,避免重复配置出现误差。

三、查询条件

 

【查询列】:当前列是否作为查询条件。

【查询操作符】:查询使用的操作符。

【默认查询值】:列表打开时,给查询框的默认值。

【显示类型】:查询框的控件类型。

【控件显示配置】:控件显示配置是一个按钮,标有红星的表示已经配置过内容,若所选显示类型没有需要配置的内容,则按钮置灰。

打开控件显示配置页面,看到“从实体模型更新数据”按钮,当列表对应实体模型的当前字段的控件显示配置有更新时,用户可以通过该按钮将实体模型中控件显示配置的修改同步到列表模型中,避免重复配置出现误差。

【默认展开】:查询框是否默认展开。若不设置默认展开,则打开列表时,查询框默认是收起在隐藏区域中的,需要点击“展开”才会显示该查询框。

四、配置按钮

 

新增列表页面时,系统会自动初始化四个按钮,分别是新增、编辑、删除和批量删除,方便用户快速建模。

【操作类型】:按钮的操作类型,包括新增、发起流程、编辑、流程详细、详细、批量删除、删除、导出、导入、自定义。

新增是内置功能,会打开普通表单的新增页面,一般作为工具栏按钮,需要配置关联表单,也就是打开的表单。

发起流程是内置功能,一般作为工具栏按钮,需要配置关联表单,会打开关联表单对应流程的发起页面。

编辑是内置功能,会打开普通表单的编辑页面,一般作为行内按钮,若作为工具栏按钮,则只允许选择一条数据进行编辑,需要配置关联表单,也就是打开的表单。

流程详细是内置功能,一般作为行内按钮,若作为工具栏按钮,则只允许选择一条数据进行操作,需要配置关联表单,会根据所选数据的流程状态打开流程页面,若数据未启动流程,则会打开关联表单对应的发起流程页面,若数据已经启动流程,则会直接打开对应流程的审批页面。

详细是内置功能,功能同编辑,区别在于业务上一般使用详细按钮打开只读表单。

批量删除是内置功能,一般作为工具栏按钮,需要配置ER模型,删除数据时会根据指定的ER模型删除关联数据。ER模型的主表必须是当前列表对应的表。

删除是内置功能,一般作为行内按钮,若作为工具栏按钮,则只允许选择一条数据进行操作,功能同批量删除。

导出、导入是内置功能,将所选数据以excel的方式导出和将excel的数据导入。系统会根据列表显示页签中配置的字段可导出属性进行导出和导入。

自定义是用户扩展自定义按钮时使用,需要配置自定义脚本,也就是按钮要执行的JS脚本。

【按钮名称】:按钮的显示名称。

【按钮类型】:按钮类型指按钮的摆放位置,包含工具栏或者行内两个位置。

【按钮样式】:按钮的样式。

【按钮图标】:按钮的图标。

【关联表单】:按钮关联的表单,新增和编辑类的按钮,必须配置关联表单。

【ER模型】:按钮关联的ER模型,删除类的按钮,必须配置ER模型。

【自定义脚本】:编写自定义的JS脚本,自定义按钮调用。

【前后脚本】:按钮执行前和按钮执行后的自定义JS脚本。