本系统全部的列表页面,包括门户中的列表数据,均为列表组件配置并解析生成网页,网页的通用URL入口为:/list/page/{功能编码}?datasrc=dd&templid=100(有表头)和/list/noheader/{功能编码}?datasrc=dd&templid=100(无表头),两个接口功能一致,其中功能编码参数需要参考“系统管理”模块的“功能权限管理”列表页中的“编码”列,也可以参考软件帮助面板上方的“模块”编号;参数datasrc=dd表示列表页数据是通过windowdb_conf.{功能编码}_dd表中的templid=100的SQL语句获取的;如果没有这两个参数,系统会默认从windowdb_conf.{功能编码}_ld视图中获取数据。
该接口参数如下表所示:
序 号 | 列表组件接口地址:/list/page/{功能编码},/list/noheader/{功能编码} | ||
参数名 | 说明 | ||
1 | datasrc | dd | 该列表数据来源于 windowdb_conf.{功能编码}_dd 的配置库对象中记录的sql字符串,如果没有该参数则该列表数据来源于windowdb_conf.{功能编码}_ld的视图 |
2 | templid | 100 | 该列表数据来源于windowdb_conf.{功能编码}_dd表templid=100的记录值(sql)执行后的结果集(datasrc必须等于dd的前提下) |
3 | page | 1 | 当前页码 |
4 | rows | 20 | 每页显示行数 |
表 22
该接口涉及配置表如下所示:
序 号 | 列表组件配置库表清单 | ||
对象名 | 类型 | 说明 | |
1 | {功能编码}_dd | 表 | 表单项配置数据,以及列表页面查询数据。 |
2 | {功能编码}_ld | 视图 | 明细数据视图(视图查询为明细页面以及打印页面提供数据)。 |
3 | {功能编码}_ld_th | 表 | 列表表头配置 |
表 23
数据库配置表快速定位:windowdb_conf.{模块编号}_ld_th
描述:列表的表头定义配置表默认只有三行数据,必须带有一个id列。默认还会带有checkbox的描述列,用于描述列表的checkbox,其它列由设计人员自行定义,id=2 的数据为导出列定义。
导出按钮代码:
<a href="javascript:saveSearch();" title="将查询的单页或者多页数据导出为xls格式文件"></a>saveSearch方法导出的是被检索出的结果,包含第二页第三页...直到最后一页,而saveSelect方法必须要求选中数据行,才会导出数据。
导出列规则:id = 2 ,且值是”1,”为前缀的数据列,默认会被导出到excel文件中。其它数据不会被导入,但是会被解析到html网页中作为网页的一部分。
数据库配置表快速定位:windowdb_conf.{模块编号}_ld_th,windowdb_conf.{模块编号}_dd,windowdb_conf.{模块编号}_ld
描述:列表的表头定义配置表默认只有三行数据,必须带有一个id列。默认还会带有checkbox的描述列,用于描述列表的checkbox,其它列由设计人员自行定义,id=3 的数据为检索列定义。该列中的值如果包含input标签,则第一个input标签会自动加上字段名作为input的name,点击列表查询按钮,则会将该值传递后台检索处理。而该input的样式名即class=” .like.”表示模糊匹配(like ‘%%’),class=” .eq.”表示精确匹配(=),class=” .gt.”表示大于(>),class=” .lt.”表示小于(<),class=” .in.”表示包含(in(...)),class=” .between.”则表示SQL语句中的between and 第一个input的name后半部分等于.between.min.第二个input的name后半部分等于.between.max.,具体使用的方法请参考数据库中的示例。若该数据列表不需要额外的查询组件作为辅助,需要在第一列的第三行申明:“”则列表页面上方不会解析出一个默认的查询按钮。
代码:<script>$('#dg').datagrid({pageList: [10, 20, 30]});</script>
参数:pageList: 提供分页的列表行数
代码位置:windowdb_conf.{模块编号}_ld_th
描述:列表默认每页20行数据,该方法定义除了默认行数外,支持每页数据的可选行数数值。
代码:<a href="javascript:add({templid});" title="根据指定的格式弹出添加页面"></a>
参数:templid:模版id,对应的表单模版。
代码位置:windowdb_conf.{模块编号}_ld_th
描述:js方法add,调用弹出窗口,该窗口根据templid,解析windowdb_conf.{模块编号}_dd表中templid字段为add方法中参数传递的数值。
代码:<button onclick=’openurl(“窗口标题”,”${basePath}/datail/showAdd/page/{模块编号}/{templid}?id={数据主键id}”);’>修改</button>
参数:templid:模版id,对应的表单模版。
代码位置:windowdb_conf.{模块编号}_dd,windowdb_conf.{模块编号}_ld
描述:js方法openurl,调用弹出窗口,该窗口根据templid,解析windowdb_conf.{模块编号}_dd表中templid字段对应的数值。
代码:<a href="javascript:help({id});" title="弹出右侧帮助侧边栏内容"></a>
参数:id,windowdb_conf.{模块编号}_hp表中的id。
代码位置:windowdb_conf.{模块编号}_ld_th
描述:js方法help,调用对应模块的帮助窗口,该窗口根据id,解析windowdb_conf.{模块编号}_hp表中id字段为help方法中参数传递的数值的内容。
位置:windowdb_conf.{模块编号}_dd
描述:windowdb_conf.{模块编号}_dd表中templid对应值是列表接口url中传递过来的值,例如:url中传递templid=100,则windowdb_conf.{模块编号}_dd表中需要建立一行templid=100的记录,其value字段保存一段select查询语句,查询语句查询出的字段,需要和windowdb_conf.{模块编号}_ld_th表中的字段对应。
位置:windowdb_conf.{模块编号}_ld
描述:windowdb_conf.{模块编号}_ld视图。列表接口未指明datasrc为dd的情况下默认显示的数据,以及详细显示页面和详细打印的数据。
位置:windowdb_conf.{模块编号}_dd,windowdb_conf.{模块编号}_ld
代码:<button onclick="visible({业务表名},{id})">生效</button>
<button onclick="unvisible({业务表名},{id})">作废</button>
描述:设置业务表中visible字段的开和关,从而控制业务数据是否可见(是否生效)从而达到标记业务数据状态的目的。
位置:windowdb_conf.{模块编号}_dd,windowdb_conf.{模块编号}_ld
代码:<button onclick="showTask({模块编号},{taskid})">提交</button>
描述:根据模块编号和流程任务ID呼出流程面板。处理流程待办任务。
taskid:windowdb.wf_ins_task.id, 对应业务库中的流程实例表的主键ID
位置:windowdb_conf.{模块编号}_dd_pt,windowdb_conf.{模块编号}_ld
代码:<a href="javascript:printSearch({printid});" title="将查询的单页或者多页数据根据特定格式打印出来"></a>
<a href="javascript:printSelect({printid});" title="将勾选的数据根据特定格式打印出来"></a>
描述:根据打印模版编号弹出数据面板。打印业务数据。
printid:windowdb_conf.{模块编号}_dd_pt.id, 对应打印模版表的主键ID。