通用查询标签属性介绍
润乾的通用查询标签提供了一个根据语意视图数据集、sql数据集生成通用查询界面的功能,在使用通用查询时,首先在jsp文件的头部引用标签库的定义,可以参看demo1Query.jsp。
<%@ taglib uri=”/WEB-INF/commonQuery.tld” prefix=”cq” %>
然后就可以使用标签了。
<!–通用查询表单生成标签–>
<cq:commonQuery
raq=”订单2.raq”
srcType=”file”
needSave=”yes”
needReload=”yes”
needQuery=”yes”
conditions=””
hiddenConditions=””
dataSets=”ds1,ds2”
macroNames=”macro1,macro2”
fieldColWidth=”15%”
setupIcon=”css/cq_setup.png”
multiIcon=”css/multi.png”
saveIcon=”css/cq_save.png”
reloadIcon=”css/cq_reload.png”
calIcon=”css/cq_cal.png”
queryIcon=”css/cq_query.png”
expandIcon=”css/zhankai.png”
collapseIcon=”css/heqi.png”
styleDefine=”css/comQuery.css”
displayMode=”normal”
resultPage=”reportJsp/demo1.jsp”
/>
下面具体介绍标签中每项的意义与用途。
1)raq: 部署到通用查询应用中的报表的名称,为必须项,格式要符合文件名或变量名规则通用查询面板的布局方式。
2)srcType:报表源的类型,默认值为file。
3)needSave:是否生成通用查询页面上的保存按钮,即保存当前查询设置的保存按钮,默认值是yes。
4)needReload:是否生成通用查询页面上的载入已定义按钮,即载入已有的查询条件设置的按钮,默认值是yes。
5)needQuery:是否生成通用查询页面下方提交查询设置的查询按钮,默认值是yes。
6)conditions:设置可见的预置条件,预置条件为预先设置查询条件作为默认查询条件。预置条件的固定设置格式为:数据集名称,(,字段名称,比较符,条件值1,条件值2,),逻辑符;
一个预置条件必须含有八项(其中括号”()”算一项且必须),包括:数据集名称、左括号、所选的字段名称、比较符(参见比较符对应表)、条件值1、条件值2、右括号、逻辑符(or或and);其中两个条件值是针对选择”在……之间”这种类型的比较符,若选择的是只需一个条件值的比较符,那么只设置条件值1,条件值2为空即可。
7)hiddenConditions:将预先设置的查询条件隐藏,这样进入通用查询页面时,预置条件不显示,在提交查询条件时,与用户设置的查询条件一同传入报表。不可见预置条件的设置方法与规则同可见预置条件的一致。
8)dataSets:生成通用查询面板所使用的数据集列表,设置报表模板中的数据集,设置格式为半角逗号分割的列表。
9)macroNames:若设计的报表模板含有宏,则在这个标签处设置报表中的宏,此处宏名称的列表要与数据集名称一一对应。
10)fieldColWidth:设置通用查询字段列表的宽度,格式是像素值,或者百分比。
11)setupIcon:”高级设置”功能键对应的图标路径,格式可以是绝对或相对URL地址。
12)multiIcon:”横向布局”功能键对应的图片路径,格式可以是绝对或相对URL地址。
13)saveIcon:”保存”功能键对应的图标路径,格式可以是绝对或相对URL地址。
14)reloadIcon:”载入已定义”功能键对应的图标路径,格式可以是绝对或相对URL地址。
15)calIcon:”日历编辑风格”对应的图标路径,格式可以是绝对或相对URL地址。
16)queryIcon:”查询”按钮对应图片路径,格式可以是绝对或相对URL地址。
17)expandIcon:数据集展开时数据集显示图片的路径,格式可以是绝对或相对URL地址。
18)collapseIcon:数据集折叠时数据集显示图片的路径,格式可以是绝对或相对URL地址。
19)styleDefine:通用查询的样式定义文件路径,润乾通用查询的样式是用css文件定义的,这里定义的是此文件的绝对或相对URL地址。
20)displayMode:通用查询面板的布局方式,分为normal、senior、mulit,默认值为normal。
21)resultPage:通用查询输出查询结果的jsp页面,若报表含有宏,且在macroNames标签处设置了与数据集一一对应的宏名称后,此时要用润乾通用查询应用包中提供的demo1.jsp文件来发布;若报表不带宏参数,即macroNames参数处是空的,则用润乾提供的demo2.jsp文件发布。发布jsp用户可自行编写,也可用润乾通用查询应用包中带有的例子。