锐浪报表系统支持高效条件查询功能

        人事项目快要结束了，但是报表问题还是得不到解决。我们前台采用MVC开发模式，但是MVC和锐浪不能很好的结合。如果是一下查询所有的数据还是比较简单的，但是用户需求是能对报表直接操作，按条件查询。无奈，找到一个解决办法，那就是将报表单独发布一个系统，当人事系统调用报表时则跳转到报表系统的独立连接。下面来说说如何给锐浪报表单独发布。

       报表插件运行在客户端电脑上，可以用报表插件的编程接口将网页客户端上的数据加载到报表中，如将网页上的UI界面上的数据传入到报表中进行打印等。

       在设计报表模板时，通常会设置数据源连接串与查询SQL语句，如果在报表插件中没有为报表关联服务器URL数据，报表模板中的数据源设置将会被应用，报表插件将尝试从对应数据源中获取报表数据。此种方式会存在严重的弊端，因为连接串中的数据库用户与密码信息是固定的，客户端必须具有直接访问数据库的权限，这样会有很大的安全局限性，特别是对于Internet网(广域网)来说，客户端肯定不能直接访问数据库。WEB报表应该关联报表数据DataURL，从 DataURL 处获取 XML 数据, 这样客户端肯定能访问WEB服务器，这样肯定不存在访问权限限制。除此之外，这种方式获取报表数据需要Windows 客户端提供对应数据库的 OLE DB 驱动程序，如 Oracle、MySQL 等很多数据库在 Windows 下并没有直接安装有其 OLEDB 驱动程序，这样就需要为每个客户端安装 OLE DB 驱动程序，这样也会极大增加软件部署的难度。所以强烈建议不采用这种方式为WEB报表提供数据。

一、在网页中插入报表插件

        在网页中通过插入 object标签将各种浏览器插件嵌入到网页中,Grid++Report报表插件也是通过这样的方式将其嵌入到网页中。Grid++Report为此定义了专门的Javascript 函数来简化此任务，相关函数定义在例子程序的 CreateControl.js代码文件中，每个函数的参数说明在代码中都有详细注释说明。下面是CreateControl.js 代码：

//1、变量 gr_InstallPath 等号后面的参数是插件安装文件的所在的网站目录，一般从网站的根目
//   录开始寻址，插件安装文件一定要存在于指定目录下。
//2、gr_Version 等号后面的参数是插件安装包的版本号，如果有新版本插件安装包，应上传新版
//   本插件安装文件到网站对应目录，并更新这里的版本号。
//3、更多详细信息请参考帮助中“报表插件(WEB报表)->在服务器部署插件安装包”部分
var gr_InstallPath = "grinstall"; //实际项目中应该写从根目录寻址的目录，如gr_InstallPath="/myapp/report/grinstall"; 
var gr_Version = "6,0,15,0819";

//以下注册号为本机开发测试注册号，报表访问地址为localhost时可以去掉试用标志
//购买注册后，请用您的注册用户名与注册号替换下面变量中值
var gr_UserName = '锐浪报表插件本机开发测试注册';
var gr_SerialNo = '8PJH495VA61FLI5TG0L4KB2337F1G7AKLD6LNNA9F9T28IKRU6N33P8Z6XX4BUYB5E9NZ6INMD5T8EN47IX63VV7F9BJHB5ZJQQ6MX3J3V12C4XDHU97SXX6X3VA57KCB6';

//报表插件目前只能在32位浏览器中使用
var _gr_platform = window.navigator.platform;
if (_gr_platform.indexOf("64") > 0)
    alert("锐浪Grid++Report报表插件不能运行在64位浏览器中，相关报表与打印功能将无法正常运新，请改用32位浏览器！");

//区分浏览器(IE or not)
var _gr_agent = navigator.userAgent.toLowerCase();
var _gr_isIE = (_gr_agent.indexOf("msie")>0)? true : false;

var gr_CodeBase;
if( _gr_isIE )
    gr_CodeBase = 'codebase="' + gr_InstallPath + '/grbsctl6.cab#Version=' + gr_Version + '"';
else
    gr_CodeBase = '';

//创建报表对象，报表对象是不可见的对象，详细请查看帮助中的 IGridppReport
//Name - 指定插件对象的ID，可以用js代码 document.getElementById("%Name%") 获取报表对象
//EventParams - 指定报表对象的需要响应的事件，如：" "形式，可以指定多个事件
function CreateReport(PluginID, EventParams)
{
    var typeid;
    if( _gr_isIE )
        typeid = 'classid="clsid:396841CC-FC0F-4989-8182-EBA06AA8CA2F" ';
    else
        typeid = 'type="application/x-grplugin6-report" ';
    typeid += gr_CodeBase;
	document.write('');
	
	document.write('');
}

//用更多的参数创建报表打印显示插件，详细请查看帮助中的 IGRPrintViewer
//PluginID - 插件的ID，可以通过 var ReportViewer = document.getElementById("%PluginID%"); 这样的方式获取插件引用变量
//Width - 插件的显示宽度，"100%"为整个显示区域宽度，"500"表示500个屏幕像素点
//Height - 插件的显示高度，"100%"为整个显示区域高度，"500"表示500个屏幕像素点
//ReportURL - 获取报表模板的URL
//DataURL - 获取报表数据的URL
//AutoRun - 指定插件在创建之后是否自动生成并展现报表,值为false或true
//ExParams - 指定更多的插件属性阐述,形如: ""这样的参数串
function CreatePrintViewerEx2(PluginID, Width, Height, ReportURL, DataURL, AutoRun, ExParams)
{
    var typeid;
    if( _gr_isIE )
        typeid = 'classid="clsid:ABB64AAC-D7E8-4733-B052-1B141C92F3CE" ' + gr_CodeBase;
    else
        typeid = 'type="application/x-grplugin6-printviewer"';
	document.write('');
}

//用更多的参数创建报表打印显示插件，详细请查看帮助中的 IGRDisplayViewer
//PluginID - 插件的ID，可以通过 var ReportViewer = document.getElementById("%PluginID%"); 这样的方式获取插件引用变量
//Width - 插件的显示宽度，"100%"为整个显示区域宽度，"500"表示500个屏幕像素点
//Height - 插件的显示高度，"100%"为整个显示区域高度，"500"表示500个屏幕像素点
//ReportURL - 获取报表模板的URL
//DataURL - 获取报表数据的URL
//AutoRun - 指定插件在创建之后是否自动生成并展现报表,值为false或true
//ExParams - 指定更多的插件属性阐述,形如: ""这样的参数串
function CreateDisplayViewerEx2(PluginID, Width, Height, ReportURL, DataURL, AutoRun, ExParams)
{
    var typeid;
    if( _gr_isIE )
        typeid = 'classid="clsid:600CD6D9-EBE1-42cb-B8DF-DFB81977122E" ' + gr_CodeBase;
    else
        typeid = 'type="application/x-grplugin6-displayviewer"';
	document.write('');
}

//以 ReportDesigner 为 ID 创建报表设计器插件(Designer)，详细请查看帮助中的 IGRDesigner
//Width - 插件的显示宽度，"100%"为整个显示区域宽度，"500"表示500个屏幕像素点
//Height - 插件的显示高度，"100%"为整个显示区域高度，"500"表示500个屏幕像素点
//LoadReportURL - 读取报表模板的URL，运行时从此URL读入报表模板数据并加载到设计器插件
//SaveReportURL - 保存报表模板的URL，保存设计后的结果数据，由此URL的服务在WEB服务端将报表模板持久保存
//DataURL - 获取报表运行时数据的URL，在设计器中进入打印视图与查询视图时从此URL获取报表数据
//ExParams - 指定更多的插件属性阐述,形如: ""这样的参数串
function CreateDesignerEx(Width, Height, LoadReportURL, SaveReportURL, DataURL, ExParams)
{
    var typeid;
    if( _gr_isIE )
        typeid = 'classid="clsid:CE666189-5D7C-42ee-AAA4-E5CB375ED3C7" ' + gr_CodeBase;
    else
        typeid = 'type="application/x-grplugin6-designer"';


	document.write('');
}

//以 ReportViewer 为 ID 创建报表打印显示器插件(PrintViewer)，参数说明参考 CreatePrintViewerEx2
function CreatePrintViewerEx(Width, Height, ReportURL, DataURL, AutoRun, ExParams)
{
    CreatePrintViewerEx2("ReportViewer", Width, Height, ReportURL, DataURL, AutoRun, ExParams)
}

//以 ReportViewer 为 ID 创建报表查询显示器插件(DisplayViewer)，参数说明参考 CreateDisplayViewerEx2
function CreateDisplayViewerEx(Width, Height, ReportURL, DataURL, AutoRun, ExParams)
{
    CreateDisplayViewerEx2("ReportViewer", Width, Height, ReportURL, DataURL, AutoRun, ExParams)
}

//以 ReportViewer 为 ID 创建报表打印显示器插件(PrintViewer)，插件大小为100%充满位置区域，插件创建后会自动运行，参数说明参考 CreatePrintViewerEx2
function CreatePrintViewer(ReportURL, DataURL)
{
    CreatePrintViewerEx("100%", "100%", ReportURL, DataURL, true, "");
}

//以 ReportViewer 为 ID 创建报表查询显示器插件(DisplayViewer)，插件大小为100%充满位置区域，插件创建后会自动运行，参数说明参考 CreateDisplayViewerEx2
function CreateDisplayViewer(ReportURL, DataURL)
{
    CreateDisplayViewerEx("100%", "100%", ReportURL, DataURL, true, "");
}

//以 ReportDesigner 为 ID 创建报表设计器插件(Designer)，插件大小为100%充满位置区域，参数说明参考 CreateDesignerEx
function CreateDesigner(LoadReportURL, SaveReportURL, DataURL)
{
    CreateDesignerEx("100%", "100%", LoadReportURL, SaveReportURL, DataURL, "");
}

    CreateDisplayViewerEx2方法是向网页中插入报表查询显示插件(DisplayViewer)，CreateDisplayViewerEx 与 CreateDisplayViewer 是CreateDisplayViewerEx2 的简化版本，目的是为了减少调用参数。开发者应该统一采用 CreateControl.js中的函数来向网页中插入报表插件。

二、在网页中插入报表对象

     Grid++Report报表对象是一个不可显示的控件，报表对象在网页中没有直接的显示输出，但调用其方法可以实现很多与报表生成与输出相关的任务。如实现无界面的打印报表，导出报表数据等。报表对象不要求插入在网页BODY 节中，我们一般将其插入在 HEAD 节中。如下代码所示：

三、在网页中插入报表设计器插件

    Grid++Report报表设计器插件是一个可视化控件，报表设计器插件在网页中可视化地设计报表模板，为用户提供可视化的自定义报表设计功能。下面是在网页中插入设计器插件：

CreateDesignerEx可以通过最后一个参数可以在创建插件时指定插件的属性值

四、插件安装包文件部署至服务器

        在部署用 Grid++Report开发的WEB报表时，需要将插件安装包文件一同分发在WEB服务器上，将两个文件(grbsctl6.cab 与grbsctl6.exe)复制到WEB服务器的可下载目录。

        另还要根据实际情况，调整 CreateControl.js文件中的插件部署目录变量值，这样才能保证客户端能找到插件安装包的下载位置。打开 CreateControl.js，将开始处的 gr_InstallPath变量值修改为插件安装包文件所在的网站目录(特别注意：不是文件的磁盘目录)，一般采用相对目录或从网站根目录进行寻址的目录。

         举例说明：如将插件安装包复制到网站根目录的 grinstall 子目录下，则CreateControl.js 中 gr_InstallPath 变量应该修改为(vargr_InstallPath = "/grinstall";)。假设服务器 IP 为192.168.1.10，则在浏览器中输入“http://192.168.1.10/grinstall/grbsctl6.cab”，如果能正常下载文件就说明插件安装包已经在服务器成功部署。

五、创建报表门户(入口)网页

    报表门户(入口)网页是指在打开各个具体报表网页前的目录(索引/导航)网页，在此网页中实现插件是否已经安装的判断，并实现插件的下载安装。插件在此安装成功后，再打开其它的报表展现网页就可以让报表成功显示出来。

报表门户(入口)网页既可以是一个专门的网页，也可以是其它目录(索引/导航)网页中加入插件安装的代码。

六、浏览器下载安装报表插件说明

    如果已经将插件安装包部署到服务器，且已经创建报表门户网页，则未安装插件的客户端电脑在访问报表门户网页时将会出现插件安装的相关提示界面。以下内容就是对插件自动下载安装的说明，也是对插件部署是否正确的检验。锐浪报表插件支持多浏览器，在不同的浏览器下安装行为有所区别。

    至此为止，锐浪报表系统就做好了，接下来将其发布到IIS即可使用。