自定义列表 #

简介 #

在项目开发过程中，需要写大量的列表功能用于数据展示 或数据统计 ，开发人员需要进行大量繁杂而又重复的开发，自定义列表可以通过配置实现多表增删改查，无需代码开发
自定义列表支持 单表，多表，视图 等复杂 sql 查询，支持 多数据源 可远程连接其他库进行数据查询或统计等
而且自定义列表可与流程数据完美融合，简单配置即可搭建不同的应用

应用 ：把表单数据和流程数据相结合，展示的列表数据分别为，待办视图，已办视图，抄送视图，我发起的，点击详情可跳转流程实例表单，查看流程审批进度等流程数据效果 如下图所示

数据列表 ：应用列表可与 在线表单 结合，快速配置出单表或多表增删改查页面

数据报表 ：新增数据报表 可用于数据统计，也可用于自定义图表的数据源

简单模式 #

基础配置 #

• 新建简单模式数据列表首先要选择 关联在线表单 按钮，页面会根据选择的表单加载出此图中的其他配置
• 图中左侧为预览区，右侧为配置区，点击图中红色标记不同区域，右侧配置区域会出现基础配置对应的配置
• 点击标记 ① 处，右侧可设置基础配置和查询条件配置
• 点击 ② 处，右侧可设置基础配置和按钮配置
• 点击 ③ 处，右侧可设置基础配置和列表字段配置
• 点击 ④ 处，设置基础配置
• 点击 ⑤ 处，可设置左侧点击预览区对应的配置，所有配置设置完后预览区立即生效

基础配置明细：

1. 名称 ： 该数据列表的名称，加入菜单后是菜单名称
2. 编码 ： 全局唯一编码
3. 主键 ： 数据库表的主键
4. 分页数量 ： 列表分页数量
5. 是否多选 ： 该列表是否支持多选，支持多选后才可以支持批量操作
6. 是否默认查询 ： 进入该列表后是否默认先查询
7. 显示行号/序号 ： 第一列是否展示行号
8. 固定操作栏 ： 右侧操作栏按钮是否固定
9. 是否启用 ： 是否启用该数据列表
10. 设置左边树 ： 左侧树配置可以实现左树右列，左右数据联动
11. 手机端设置 ： 手机端配置

左边树设置 #

• 配置左侧树后 列表左侧会有个树，并且点击左侧树会联动右边列表关联数据

  左侧树配置明细

  1. 开启左侧树 ：是否开启左侧树
  2. 数据来源类型 : 该树的数据来源
     1. 自定义对话框 : 选择一个自定义对话框作为数据来源，可以在 对话框返回字段 中设置点击树返回的字段
     2. 数据字典 : 选择一个数据字典，点击树会返回数据字典 key 赋值给查询条件
     3. 自定义列表 : 此处选择一个自定义列表，设置父 id 和树展示的键值对，返回这里设置的值给页面查询条件
  3. 选择数据来源 : 对应数据来源类型选择一个自定义对话框或者数据字典或者自定义列表
  4. 根节点名称 :
  5. 关联查询字段 : 点击树后返回的字段赋值到本查询列表的哪个字段中
  6. 对话框返回字段 : 如果设置了自定义对话框作为数据来源，这里要选择对话框返回字段作为查询条件

  手机端设置 #

  

• 手机端设置可以配置手机端该列表图标，选择手机端展示的表单，和手机端排班模式

查询条件配置 #

• 点击上图左侧蓝色虚线区域，右侧即为 列表查询条件 配置区域

• 图中红色标注处下拉框可选择本列表的查询条件

  列表查询字段配置明细：

1. 字段备注：该字段默认值为数据库表字段的备注，这里作为查询字段的 label，可灵活修改
2. 条件类型：该查询条件的匹配类型，支持：等于，大于，小于，相似，在...中，在...之间等
3. 格式化类型：该查询条件的数据展示形式，支持：单行文本框，日期空间，数据字典，自定义下拉框
4. 操作：可以拖拽查询字段的排序，或者删除该查询字段
5. 显示类型：该查询条件的显示类型，支持：显示，隐藏，禁用
6. 格式化数据：此处对应 格式化类型 配置，格式化类型为日期控件时此处可选日期格式
   类型为数据字典时此处可选具体展示的数据字典，数据字典以下拉框形式展示
   类型为自定义下拉框时这里可以手动添加下拉框键值对 直接展示
7. 默认值类型：可设置该查询条件的默认值，支持选择当前用户信息等信息
8. 变量类型：普通变量和 freemarker 变量，后者支持从 url 取值作为该条件查询参数或者 sql 中的查询参数，url 中参数和本参数名一致即可

按钮配置 #

• 点击上图左侧蓝色虚线区域，右侧即为 按钮 配置区域
• 按钮分为 全局按钮 和 行内按钮 在第一次加入菜单时会加入资源权限管理，后续新增按钮可以点击列表上的 按钮权限更新 按钮 更新权限

按钮属性明细：

1. 名称 ：按钮名称
2. 别名 ：按钮别名，需全局唯一
3. 操作 ：可移动按钮位置，删除按钮
4. 按钮类型 ：设置该按钮是全局按钮还是行内按钮
5. 是否必选 ：触发该按钮是否必选数据
6. 按钮样式 ：可选择按钮样式
7. 提醒内容 ：按钮点击后 执行前提醒内容，不填则不提示
8. 打开方式 ：
   1. 直接请求 ：支持配置路由或后台接口地址并传入当前列表页字段
   2. 事件按钮 ：支持配置式直接修改本自定义列表的主表字段
   3. 标签页/tab 页 ：打开一个标签页
   4. TOP 对话框 ：打开一个 TOP 对话框
   5. 新页面 ：打开一个新页面
9. 请求地址 ：支持配置路由或者后台接口
10. 显示条件 ：该按钮的显示条件返回 true 展示 返回 false 不展示
    eg:item.status==0 当 status 字段值为 0 时才展示该查询条件

数字段配置 #

• 点击上图左侧蓝色虚线区域，右侧即为 字段 配置区域
• 此处配置列表展示或导出的字段配置，字段展示样式，格式化，超链接等配置
• 数据库字段更新时点击 数据库字段更新 会把数据库字段变更信息更新到此处

字段属性明细：

1. 字段备注 ：该字段展示标头，默认用数据库字段注释
2. 可导出 ：该字段知否支持导出 excl
3. 是否隐藏 ：该字段是否展示
4. 格式化类型 ：
   1. 自定义格式化 ：可以手动配置格式化的键值对，用于格式化列表数据，在 格式化数据 中增加键值对
   2. 数字格式化 ：可以设置货币单位，设置小数点位数等，在 格式化数据 中配置具体展示规则
   3. 日期控件 ：选择日期控件后可以设置日期格式，在 格式化数据 中选择日期格式
   4. 数据字典 ：选择一个数据字典后，可以根据数据字典键值对自动格式化该字段，在 格式化数据 中选择一个系统中的数据字典
5. 格式化数据 ：跟格式化类型联动 不同的格式化类型对应这里不同的设置
6. 格式化样式 ：根据不同的 key 可以设置不同的样式
7. 对其方式 ：该字段的对其方式，支持居中，左对齐，右对齐
8. 可排序 ：该字段在页面是否支持排序
9. 打开方式 ：给该字段设置了 href 时, 点击该字段的跳转方式, 可选对话框/tab 页/新页面 , 选择对话框时,可以设置宽高
10. 脱敏 ：脱敏设置为两个数字如 3,3，表示前三个字符，后三个字符保持原值，中间的部分脱敏。
    比如字符：一二三四五六七八
    设置 3,3 后脱敏结果为： 一二三**六七八，
    设置 3 后脱敏结果为： 一二三

高级模式 #

高级模式支持根据自定义 sql，视图等复杂查询生成列表页，并且可以添加增删改查、状态变更等操作按钮，支持远程数据源

在 视图=》应用列表=》 点击【新增自定义列表】

字段属性明细(简单模式中重复字段不再做解释)：

1. 关联在线表单 ： 该配置为了使用列表上的 详情，编辑，等按钮，配置了关联在线表单 点击列表上的详情按钮时系统会跳转到该表单的详情页面
2. 解析(按钮) ： 在顶部代码编辑框中输入一个 SQL，并点击 【解析】后 会解析出 sql 的具体字段
3. 添加别名 ：自动给 sql 添加别名
4. 美化脚本 ：格式化 sql 语句
5. 数据源 ： 选择 sql 查询的数据源，数据源在 系统=》系统数据源=》 数据源 中配置

配置一个列表步骤如下：

1. 在顶部代码编辑框中输入一个 SQL，并点击 【解析】，输入必填项
2. 点击【列表字段设置】 配置需要展示那些字段，可对展示字段格式化，脱敏，设置跳转连接等
3. 点击【列表查询设置】设置查询条件，可根据数据字典或自定义数据设置下拉框，日期等
4. 点击【列表功能按钮】设置列表按钮，可设置增删改查修改状态等按钮，按钮支持自定义路由 也可以设置一些自定义跳转按钮