Grid++WEB报表插件介绍 - WEB报表API,Grid++

WEB报表插件介绍 - WEB报表Grid++Report 插件适用于开发 B/S 结构的网络报表系统，是软件开发人员开发WEB 报表的最佳选择。

支持 Asp, , Jsp, VbScript, JavaScript，PHP 等一切 Web 开发技术。

可以在浏览器中直接打印报表（非IE打印）与导出报表。

带有国际化数字签名，在 IE 中自动下载更方便，让用户使用更安全。

特点1.Grid++Report 插件与Grid++Report 组件构建在相同的报表引擎之上，两者具有相同编程接口与相同报表格式定义，以及相同的知识学习过程，让您开发B/S 系统与C/S 系统共享相同的开发经验与开发资源。

2.网络报表界面美观，具有与桌面报表一样的报表展现功能与操作体验，大大改善浏览器中报表功能。

3.支持丰富的报表数据来源，远程OLE DB数据源直接访问、服务端数据集载入、客户端数据集与XML数据载入、以及一切可访问数据的加载。

4.数据经过高效压缩，极大减小数据网络传输量。

5.插件是一个纯客户端软件，支持一切WEB 开发语言，如：ASP、、JSP、PHP等。

客户端脚本支持VBScript、JavaScript。

6.带有国际化数字签名，让用户使用的更安全、更放心。

7.Grid++Report 经过多年发展，用户数量众多，产品成熟稳定高效，易学以用。

组成部分：1.报表打印显示插件：以打印预览的方式在IE 浏览器中展现报表，并能打印输出或导出为多中格式文档(Excel、RTF、PDF、文本，CSV、图像等)。

2.报表查询显示插件：以类似数据网格(DataGrid)方式在IE 浏览器中展现报表，其数据展现功能比常规的数据网格要强大得多。

并可以打印或打印预览报表，或导出为多种格式文档(Excel、RTF、PDF、文本，CSV、图像等)。

3.报表对象：这是一个不可见的对象，也是本软件功能实现的核心对象，相当于报表引擎。

在网页中创建这个对象，可以实现无界面打印，将Web数据直接打印出来，也可以执行数据导出功能。

报表打印显示插件与报表查询显示插件都引用一个报表对象，在网页中与报表的交互主要就是访问报表对象及其子对象。

4.报表设计器插件：在网页中可视化设计报表模板，关联一个报表对象。

参考报表插件运行原理介绍 | 插件主要编程接口 | 向报表提供记录集数据 | 向报表统一提供记录集数据与参数数据WEB报表插件运行原理介绍 - WEB报表WEB报表插件负责在网页浏览器中完成报表展现与输出等一系列任务，而其展现的数据来自WEB服务器。

报表展现与输出需要的数据包括两部分：报表模板定义数据与报表运行数据(含明细记录数据与参数数据)，报表引擎根据报表模板与报表运行数据运算出最终的报表结果，每个报表都需要提供报表模板与报表运行数据。

这两部分数据就需要WEB服务器来提供，报表插件用两个属性来指定获取这两部分数据的URL值。

当在网页文件中加入插件时，通常会为插件的这两个属性设上相应的值。

报表模板一般是通过报表设计器应用程序可视化设计并保存到文件，只要将这些文件部署到WEB服务器的目录下，其就会有对应的WEB访问URL，报表插件通过对应属性关联这个URL就会自动从此URL读取报表模板数据。

报表插件对报表运行数据的格式进行了约定，是一种规定格式的XML数据。

报表开发者应该提供产生这样格式数据的WEB服务程序，WEB服务程序在WEB服务器中按照这种约定产生数据。

报表插件通过对应属性关联其URL，就会自动从此URL 读取报表运行数据。

报表运行数据通常从数据库中查询出来，在Grid++Report 提供的例子程序中，已经为产生这样的XML数据提供了通用的函数，所以编写这些提供数据的WEB服务程序也非常简单。

参考报表插件介绍 | 插件主要编程接口 | 向报表提供记录集数据 | 向报表统一提供记录集数据与参数数据WEB报表开发过程指导 - WEB报表用 Grid++Report 插件开发 B/S 报表的过程主要包括：报表模板设计，报表数据提供与展现，发布报表系统。

报表模板设计：在安装 Grid++Report 之后，用其报表设计器程序设计报表模板。

开发桌面报表与开发B/S报表采用相同的报表模板设计程序及报表模板格式，两种开发方式可以共享报表模板。

报表设计器程序是一个可视化工具，有关其使用帮助请参看《Grid++Report 帮助》。

安装目录下的例子模板也是我们学习报表模板设计的重要资料。

报表数据提供与展现：在设计好报表模板之后，接下来的任务就要在网页中展现报表。

首先在网页中插入报表插件，并设置相应的参数关联报表模板。

报表运行一般需要加载动态数据，报表数据与报表模板经过报表引擎的运算就会生成实际的报表。

一般是通过网页服务产生报表数据，报表插件从网页服务 URL 地址获取报表数据，接下来的帮助部分就会对各种加载报表数据的方式进行说明。

发布B/S报表系统：开发好的报表系统最后需要部署到用户实际使用的环境中，需要将报表数据库，报表模板文件，报表展现网页文件与报表数据提供网页程序文件部署到实际使用的服务器上。

另插件安装包文件也要拷贝到WEB服务器的网站某个目录下，用户初次访问报表网页时会在客户端机器上自动下载安装 Grid++Report 报表插件。

更多详细新戏情参考插件安装包文件说明。

在开发过程中采用相对路径，可以大大减小发布时需要进行的代码调整。

参考报表插件介绍 | 报表插件运行原理介绍 | 插件主要编程接口 | 向报表提供记录集数据 | 向报表统一提供记录集数据与参数数据Grid++Report 插件主要编程接口说明 - WEB报表Grid++Report报表插件与Grid++Report报表组件的接口几乎完全一致，在没有特别声明的前提下，帮助中内容适用于两者。

这里只是列出对插件起步使用比较常用的一些属性与方法进行说明。

报表打印显示插件与报表查询显示插件的属性与方法：以下属性与方法在两个插件中具有类似的功能与用法，更多关于这两个插件的编程接口请参考帮助中的 IGRPrintViewer 与 IGRDisplayViewer。

Report属性：指定插件关联的报表对象，通过此属性对报表进行访问。

ReportURL属性：指定插件要展现报表的报表模板所处的 URL 值，在运行时从此 URL 载入报表定义模板。

DataURL属性：指定插件要展现的报表数据来源 URL 值，在运行时从此 URL 载入XML格式的报表明细记录集。

AutoRun属性：指定插件在浏览器中显示后是否自动运行生成报表。

如果指定了ReportURL 属性，且本属性为 True，插件在浏览器中显示后自动运行生成报表。

Start 与 Stop 方法：Start 方法启动插件的运行，Stop 方法停止插件的运行。

如果没有指定 AutoRun 属性为 True，一定要调用 Start 方法开始插件的运行。

如果在插件运行之后，打算更新显示报表数据，应该首先调用 Stop 方法停止插件的运行，然后向报表定义新参数或重新向报表加载数据，最后调用 Start 方法开始插件的运行。

报表设计器插件的属性与方法：以下属性与方法在两个插件中具有类似的功能与用法，更多关于这两个插件的编程接口请参考帮助中的 IGRPrintViewer 与 IGRDisplayViewer。

LoadReportURL属性：指定插件要设计报表的报表模板所处的 URL 值，在运行时从此 URL 载入报表模板数据。

SaveReportURL属性：指定插件设计的报表模板数据提交保存的 URL 地址，由此 URL 网页服务完成报表模板的保存。

DataURL属性：指定插件要展现的报表数据来源 URL 值，当进入预览视图与查询视图时从此 URL 载入XML格式的报表数据。

报表引擎对象的属性与方法：报表引擎对象通过插件的 Report 属性访问，这个对象是访问其它报表子对象的最上级父对象。

更多编程接口请参考帮助中的 IGridppReport。

MyInterface属性：获取报表对象的接口引用。

如果要在网页中响应报表事件，必须在网页中显式定义报表，如果此报表要关联报表显示插件，将此属性值设定给插件的 Report 属性即可建立关联。

下面的示例代码实现了：显式定义报表、定义报表事件响应函数体、报表显示器插件关联报表对象。

FieldByName方法：根据字段名称找到对应字段对象，然后对子段进行访问。

ParameterByName方法：根据参数名称找到对应参数对象，然后对参数进行访问。

PrepareRecordset方法：准备向报表记录集加载记录数据。

准备通过脚本代码向报表加载一笔笔记录数据时，必须首先调用本方法。

LoadFromURL方法：从指定的 URL 地址载入报表模板数据。

SaveToURL方法：将报表模板数据提交给指定的 URL 地址，由此 URL 网页服务完成报表模板的保存。

LoadDataFromURL方法：从指定的 URL 地址载入报表明细记录集数据，数据必须为XML格式并符合约定的形式。

LoadDataFromXML方法：从XML文字串中载入报表明细记录集数据，数据应符合约定的形式。

报表记录集对象的属性与方法：报表记录集对象管理并存储报表的记录集，向报表加载记录数据就要访问这个对象。

通过插件的 Report.DetailGrid.Recordset 属性访问这个对象，更多编程接口请参考帮助中的 IGRRecordset。

Append方法：在记录集之后追加一条记录数据。

Post方法：将当前追加的记录数据提交到记录集。

Append 与 Post 方法成对使用，在两者之间一般是向记录集的各个字段设置值的语句字段对象的属性与方法：字段对象从属于记录集对象，更多编程接口请参考帮助中的 IGRField。

AsBoolean 属性：获取或设置字段的用布尔类型表示的值。

AsCurrency 属性：获取或设置字段的用货币类型表示的值。

AsDateTime 属性：获取或设置字段的用日期时间类型表示的值。

AsFloat 属性：获取或设置字段的用浮点数类型表示的值。

AsInteger 属性：获取或设置字段的用整数类型表示的值。

AsString 属性：获取或设置字段的用字符串类型表示的值。

Value 属性：获取或设置字段在运行时的值，值的数据类型不限。

参考报表插件介绍 | 报表插件运行原理介绍 | 向报表提供记录集数据 | 向报表统一提供记录集数据与参数数据向报表提供记录集数据 - WEB报表一般的报表都有一个明细表格，这个明细表格对应到一个记录集，这个记录集的数据也是报表的主体数据，如何向报表提供记录集数据就非常重要。