1. 功能介绍

    用户可以自己定制查询条件的方案,保存为常用查询方案,可以对方案修改、删除等功能,不仅如此,还提供了定时导出和即时导出功能。

  2. 参数说明

    参数名 参数类型 是否必须 默认值 描述
    name java.lang.String   定制查询组件名称
    criterias com.linkage.appframework.data.IDataset   定制查询方案数据
    listener org.apache.tapestry.IActionListener类型   点查询按钮执行的方法
    open boolean     是否可以不需要查询条件执行查询动作。
    title java.lang.String     查询区标题
    align java.lang.String   left 查询区标题布局,可选值left|right|center
    exportSimplePath java.lang.String     即时导出的页面及方法,写法如:examples.basic.VipcustList@exportVipcusts,
    其中@之前的是页面名称,@之后的是页面方法
    exportConfigPath java.lang.String     定时导出的Bean路径及方法,写法如: com.linkage.quickstart.bean.examples.
    ExamplesBean@queryVipcusts, 其中@之前的是Bean的类路径,@之后的是Bean方法,
    注意:Bean方法必须约束为有参数pd, IData参数的,
    如public IDataset exportJobs(PageData pd, IData param)
    exportConfigFile java.lang.String     定时导出excel的配置文件,注意:不需要带扩展名xml,
    如job.JobList,实际访问的是export/job/JobList.xml
    refreshParts java.lang.String     需要刷新的区域
    conditionGroup java.lang.String     条件分组名,如cond,表示cond_XXX一组数据
    needLog boolean类型   true 定制查询和定制导出时,是否记录操作日志,默认记录日志,默认为true,需要记录日志
    criteriaPage java.lang.String     方案配置的页面地址,必需是在*.application里注册了的页面
    criteriaInit java.lang.String     方案打开时页面执行的事件
    criteriaTitle java.lang.String     方案弹出页面的标题
    criteriaWidth java.lang.String     方案弹出页面的宽度
    criteriaHeight java.lang.String     方案弹出页面的高度
  3. 主要特性

    1. 适应于动态条件的查询方案。
    2. 提供了定制导出管理功能,页面地址component.query.ExportList&listener=queryCriteriaExecs,[查看效果]
  4. 注意事项

    1. 去掉了老版本里的配置表td_s_qry_class;
    2. 初始化查询方案需实现查询方法criteriaInit,代码示例参看[代码片段]部分。
    3. 导出权限控制,由于定制查询组件有定时导出和即时导出两种权限,所以权限编码需要定义在Head组件中,如<head jwcid="@wade:Head" privs=" COM_CRITERIAEXP_TSK, COM_SIMPLEEXP_TSK">,其中,TSK对应定制查询组件的NAME属性值,前缀不能随意更改。
  5. 代码片段

    1. HTML写法

      <span 
      	jwcid="@component:Query" 
      	name="QRY" 
      	criterias="ognl:criterias" 
      	listener="ognl:listeners.queryVipcusts" 
      	open="false" 
      	exportSimplePath="examples.basic.VipcustList@exportVipcusts" 
      	exportConfigPath="com.linkage.quickstart.bean.examples.ExamplesBean@queryVipcusts" 
      	exportConfigFile="examples.basic.VipcustList" 
      	refreshParts="VipcustPart" 
      	conditionGroup="cond" 
      	needLog="true"
      	criteriaTitle="配置方案"
      	criteriaPage="examples.component.QueryCriteria"
      	criteriaInit="setConditionByInit"
      	criteriaWidth="480"
      	criteriaHeight="220"
      />
      
    2. 方案初始化方法

      /**
       * 设置初始条件
       * @param cycle
       * @throws Exception
       */
      public void setConditionByInit(IRequestCycle cycle) throws Exception {
      	PageData pd = getPageData();
      	setCondition(QueryFactory.getDataByEncodeStr(pd.getParameter("EXEC_CONDITION")));
      }
      
  6. 效果演示

    点击上图红色框内的图片可以查询当前已有的所有配置方案

    在方案列表内可以重命名方案、删除方案

    点击上图红色框内的图片可以查询当前已有的所有配置方案
    上图图中点击配置方案会弹出查询条件配置窗口,显示下图,当录入查询条件返回后,录入方案名称,点击保存方案,
    保存这次配置的查询条件,点击执行导出,选择是即时导出还是定时导出,然后选择导出的字段,就可以导出查询属性,
    点击执行查询,按查询条件查询出信息并显示。

    配置方案

    保存方案

    执行导出

    定时导出

    查看我的定制导出