通用查询的调用-报表展现标签与API
目录

通用查询的调用

产品提供了通用查询调用接口,开发者可以在自己的程序中或jsp页面调用指定的通用查询。

SR模式调用

如果是调用SR模块展现通用查询与报表,SR模块封装了相应参数,用于设置需要调用的通用查询。

传通用查询资源ID调用

SR模块封装了参数cmq_id,可以通过该参数传入通用查询资源ID,完成对指定通用查询的调用。

例如,调用系统中某个单独定义好的通用查询资源,其资源ID为10456,设置cmq_id的值为10456即可。

传通用查询定义文件调用

SR模块还封装了一个参数commonQueryPath,可以通过该参数传入通用查询定义文件(.json文件)所在路径,完成对指定通用查询的调用。

例如,某个通用查询的定义文件位于:/mis2/commonQuery/json/11644.json,那么设置commonQueryPath的值为该路径即可。

具体SR参数设置方式可参考:报表展现客户化

标签调用

可以通过通用查询提供的标签,在自定义的jsp中调用通用查询。

首先在jsp中引入通用查询标签库文件:

<%@ taglib uri="/WEB-INF/tld/commonQuery.tld" prefix="commTag" %>

然后,就可以在jsp中需要展现通用查询的位置,通过标签调用指定的通用查询:

<commTag:commQryTag
      jsObjectName="query1"
      jsonContent="<%=commonQueryText%>"
/>

标签属性说明:

注意jsonContent的值必须为json串格式,其内容是通用查询的配置信息,开发者可以在jsp中自行通过程序从所需调用的通用查询定义文件中读取,然后设置给jsonContent属性。例如下面代码所示:

<%@ page import="com.runqianapp.commonquery.utils.ReadFile %>
    ……
    <%
          String jsonStr= ReadFile.getJsonContent(filePath); //从指定路径读取通用查询json文件中的配置信息
    %>
    ……
    <commTag:commQryTag
         jsObjectName="query2"
         jsonContent="<%=jsonStr%>"
     />
    ……