创建新列表

属性

详细文档:列表属性说明文档

基本属性

  • 使用Session存储列表状态?: 如果选中此选项,则Joget将在以下元素上保留用户先前设置的数据列表设置:
    • 所有列过滤器值。
    • 每页数量。
    • 页码位置。
  • 仅在使用筛选器时显示数据?勾选后列表默认不加载数据仅在输入筛选内容后展示筛选内容
  • 获取记录总数时,参考过滤器的值?:勾选后数据总数参考筛选项值

响应设置

  • 禁用响应功能?:勾选后不对设配进行响应式适配
  • 搜索显示在弹出窗口中?:点击筛选项弹出窗显示
  • 查看设置:所示配置控制在手机或评判上的样式


数据源

配置当前列表的数据来源

配置文档链接:数据源配置说明


JDBC数据库绑定器

使用自定义SQL和数据库连接来灵活地设计数据列表。

  • 数据源:指定执行SQL的数据库信息
    • 默认数据源:使用joget平台配置的数据库连接进行查询
    • 客户化数据源:自定义其他数据库连接
      • JDBC驱动:定义对应数据库的驱动
        • MySQL:com.mysql.jdbc.Driver

        • SqlServer:com.microsoft.sqlserver.jdbc.SQLServerDriver

        • Oracle:oracle.jdbc.driver.OracleDriver

      • 客户化JDBC URL:
      • JDBC(数据库)用户名:数据库登录用户
      • JDBC(数据库)密码:用户密码
    • SQL查询语句
    • 主键:定义主键列,一般情况是id
    • 优化分页查询语句?选中后,绑定器仅获取选定页面的数据,而不返回整个数据列表,从而优化大量数据列表的分页性能。仅适用于MySQL和Microsoft SQL Server 2012及更高版本

Joget实体类绑定器

Joget实体类绑定器提供对与平台和系统级别相关的实体的数据访问

样例应用下载地址:Joget实体类演示应用(官方-英文)

配置

  • 实体类:具体类型如图
  • 筛选条件:添加数据筛选条件
  • 附加条件:筛选数据的附加条件,使用HQL语法

外部组织名录绑定器

Joget DX引入的一个新的数据列表数据源,称为外部组织名录绑定器,它从LDAP目录管理器中“拉出”用户数据

配置:

  • 配置前需要向在joget中配置好LDAP相关设置如图
  • 选择类型:如图
    • 部门
    • 员工详细信息
    • 岗级
    • 用户组
    • 组织
    • 用户

表单数据绑定器

用于从提交的表单返回数据的默认绑定器

配置:

  • 表单:选择数据来源表单(加载此表单的数据表的所有数据)
  • 格外的筛选条件:筛选数据的附加条件,使用HQL语法


高级表单数据绑定器

默认表单数据绑定器的扩展版本。以更友好方式指导使用者添加过滤条件

属性:

  • 表单:选择数据来源主表
  • 关联数据表:等同于SQL的 JOIN
    • 数据表名:要关联的数据表名
    • 字段:关联的数据表中的字段
    • 关联字段:主表和关联的表的关联字段
  • 筛选条件:筛选条件:添加数据筛选条件
  • 附加条件:筛选数据的附加条件,使用HQL语法
  • 聚合查询(Group By 语句):从左侧字段选则Group By的字段
  • 表达式列:自定义一个运算列,用来计算其他某些列的运算
    • 例:cast(column1 as long) - cast(column2 as long) customColumnName
  • 自定义复选框/选项钮值:自定义行操作是选项框传的值,默认ID

高级工具

详细文档:高级工具详细介绍文档


树状查看

概述:用于快速总览、修改当前表单的逻辑和设计;

可以修改列表、数据源、列的属性;

具体参见高级工具详细介绍文档

权限

为应用程序设计人员提供了对当前列表中每列的权限控制(页面显示、导出显示)。

具体参见高级工具详细介绍文档

  • 可以有多套权限方案(供不同权限用户查看)。
  • 多个权限时,列表设计器做隐藏设置是只修改默认权限的显示和隐藏,另加的权限在自行做修改。
  • 多个权限可以点击左侧进行拖动以调整权限优先级,优先级为:最上面的最高,默认最低。

引用查询

概述:可以快速查看当前列表都在哪里被引用。

具体参见高级工具详细介绍文档

  • 当需要删除列表或对当前列表做大的修改前可以查看都在那里引用,防止影响系统其它设计。

i18N

概述:列出当前列表的所有标签,方便可以对标签做国际化

具体参见高级工具详细介绍文档

注意:

  • 选择一个语言定义后切换另一个语言继续定义,所有都生效,并不需要必须选中

差异检查

概述:检查当前列表是否有人在自己保存前做了修改并且可以合并修改(不会自动保存)。

具体参见高级工具详细介绍文档

注意:

  • 差异检查页面不会实时加载信息,需要再次点击的差异检查选项

JSON代码

概述:可以查看当前表单的json代码,也可以直接修改json代码

具体参见高级工具详细介绍文档

列表

内容

  • 数据列
  • 筛选项
  • 操作(数据增删改查、超链接指向等)



数据列

列表主体,数据内容。

配置:

  • 拖动拖动列表设计器左侧的列名到中间数据列部分

属性

  • 名称:数据源中定义的名称(表单绑定器时为表单上的标签,JDBC绑定器是为SQL中定义的列名)
  • 标签:自定义列标签
  • 可排序:定义此列是否可以排序,如图勾选后单击列名后列表以此列排序
  • 译HTML代码值?:选择是否编译HTML代码
  • 隐藏:在页面是否隐藏
  • 排除加入导出文件?\加入导出文件?:根据隐藏状态显示,选择是否要在导出文件中显示此列
  • 宽度:列宽
  • 内嵌样式:定义此列的样式(css)
  • 字体对齐:值的对齐方式
  • 标题对齐:表头字的对齐方式
  • 配置动作:配置点击此列值是执行的操作详细。 详细配置参考:操作
  • 格式化:对列的值进行格式化


筛选项

筛选列表数据,不需要在SQL中写条件,只需要将相应的字段拖拽到如图红框位置进行配置。

详细文档链接:数据列表筛选项使用说明文档

属性:

  • 名称:字段名(SQL中查询时定义的列名,或者表单绑定器时为字段所在表单的标签)
  • URL参数:列表设计器生成唯一参数,可在别的地方跳转到此列表时用此参数名
  • 标签:自定义筛选项在页面的标签
  • 类型:
    • 数字范围:指定一个最小值和最大值筛选范围内的数据
    • 文本字段:文本框筛选,输入一段文本进行筛选,支持模糊筛选但是比指定列多时结果为0,例如:‘abc ’,输入 ’abcd‘ 如果没有abcd则返回0条数据
    • 日期:该筛选项指定一个准确时间进行筛选
    • 日期范围:指定一个时间范围进行筛选
    • 选项:定义筛选项的下拉框并可自定义选项值
  • 隐藏筛选项?:勾选后前端页面隐藏该筛选项

数据列表操作

数据列表列动作、格式化,多行操作

配置参考:

Bean shell

执行一段自定义java代码,方便对列表执行复杂逻辑操作。

详细文档链接:Bean Shell按钮使用说明

配置:

  • 可以在数据列的下方放置按钮进行多行操作;
  • 可以再数据行的后面放置按钮进行单行操作

配置项

  • 标签:按钮标签
  • 确认消息:点击按钮后的确认弹出框
  • 脚本:输入java脚本
  • 隐藏控制(满足条件是显示
    • 条件组合类型:多个条件时的组合类型,可以用英文小括号 () 进行优先级范围限定
      • 与(And)
      • 或(Or)
    • 字段:控制显示的字段
    • 条件:字段和值的关系
    • 值:支持Hash变量,正则。

注意:

  • 脚本中已经注入了以下参数可供直接调用
    • HttpServiceRequest httpRequest
    • DataList datalist
    • String[] rowKeys
  • 其他参数或方法按照java规范定义即可

超链接

指向一段URL

详细文档链接:超链接详细说明

属性:

  • 超链接:链接地址URL
  • 超链接目标:以什么方式打开链接
  • 超链接参数:
    • 参数名称:自定义名称
    • 列名:选择数据列
  • 标签:按钮标签
  • 确认消息:点击按钮后的确认弹出框
  • 隐藏控制(满足条件是显示
    • 条件组合类型:多个条件时的组合类型,可以用英文小括号 () 进行优先级范围限定
      • 与(And)
      • 或(Or)
    • 字段:控制显示的字段
    • 条件:字段和值的关系
    • 值:支持Hash变量,正则。

注意:

  • 如果是当前应用的链接可以使用用户界面设计器中定义的菜单ID
  • 如果是当前joget环境别的应用需要加上/jw/web/userview/appId/userviewId/_/菜单id
  • 其他非当前joget环境链接需要全连接。例:www.baidu.com

删除

删除数据按钮

详细文档链接:删除按钮操作说明

配置:

  • 可以在数据列的下方放置按钮进行多行操作,页面勾选多行后操作;
  • 可以再数据行的后面放置按钮进行单行操作

属性:

  • 标签:按钮标签
  • 表单:选择要删除内容存在的表单
  • 确认消息:点击按钮后的确认弹出框
  • 删除相关表格(Grid)数据:勾选后如果所选表单含有多行表格会删除表格数据
  • 删除相关子表单数据:勾选后如果所选表单含有子表单数据则会删除子表单数据
  • 删除已上传文件:勾选后如果所选表单有已上传文件则会删除已上传文件
  • 中断运行中的相关流程:勾选后则会删除与该条记录ID关联的流程
  • 隐藏控制(满足条件是显示
    • 条件组合类型:多个条件时的组合类型,可以用英文小括号 () 进行优先级范围限定
      • 与(And)
      • 或(Or)
    • 字段:控制显示的字段
    • 条件:字段和值的关系
    • 值:支持Hash变量,正则。

JDBC

点击按钮执行一段SQL

配置:

  • 可以在数据列的下方放置按钮进行多行操作,页面勾选多行后操作;
  • 可以再数据行的后面放置按钮进行单行操作

属性:

  • 标签:按钮标签
  • 确认消息:点击按钮后的确认弹出框
  • 数据源
    • 默认数据源:默认joget平台设置的数据库连接
    • 客户化数据源:指定与joget平台设置不同的数据源进行数据操作;
  • 查询语句:SQL语句

数据列格式化

使用列表格式化插件进行对数据格式化

配置:数据列-编辑-格式化选项框-选择格式化类型


Bean Shell 格式化

自定义java代码来格式化该列的值;

详情参考:Bean Shell编程指南-数据列表格式化


JavaScript规则格式化

自定义JavaScript规则进行格式化

属性:

  • 规则:条件语句,满足此条件执行
  • 格式:自定义数据格式



子列表格式化

在已有列上嵌套一个子列表,可点击后查看该条下面的子信息、不用做跳转动作来查看

属性:

  • 子列表:选择要嵌套的子列表
  • 子列表URL请求参数:选择打开子列表是传入的参数
  • 导出选项:选择导出格式
  • 在Excel和CSV, 为子列表后添加空行?:选中此选项可在嵌套数据列表之后为导出的Excel和CSV文件添加一个空行
  • 自定义标题颜色:定义子列表的标题颜色



日期格式化

自定义java日期格式对日期格式进行调整

属性

  • 数据日期格式:该列在数据库存的日期格式
  • 日期展示格式:自定义要展示的格式



流程状态格式化

任意选择一列拖拽到数据列区域格式化为选项值格式化后结果如图点击进度条后展示详细信息

属性:

  • 显示流程名称?:勾选后详细信息框顶部显示流程名称
  • 展示未来流程活动?:勾选后显示流程后续节点
  • 显示已略过的流程活动?:勾选后显示流程当前节点之前没有走的活动
  • 用户名显示方式:
    • 用户名
    • 姓名
    • 姓名(用户名)
  • Click 事件回调 (Javascript)在此处编写JavaScript,以在单击“已完成”和“进行中”活动状态时触发


选项值格式化

可数据列表列上的值转换为其相应的选项值和标签。

属性:

  • 选项:自定义值对应的标签
  • 选择选项绑定器:使用选项选择绑定器插件动态填充的选项




默认格式化

使用预设的一些格式化配置或自定义字体大小、颜色、值等

属性:

  • 格式化:预设的一些格式话选项
  • 字体大小:设置列的字体大小,单位像素
  • 字体颜色码:设置列的字体颜色,支持格式:#ff0000、red
  • 配置外键:配置后,当前列值将用作外键值,用于从其他表单数据表中检索对应字段值。



  • No labels