IDC资讯中心
<%@ LANGUAGE="VBSCRIPT" %>
<%
= = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = =
从ADO Recordset直接生成报表
= = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = = =
概念:
这个应用被设计成演示怎样从ADO Recordset生成报表。我们首先建立ADO Connection和
Recordset对象，然后用SQL语句从数据库中生成一个记录集。然后我们建立一个Crystal
Reports对象，并把这个这个对象指向ADO recordset。最后我们将Crystal Reports
Smart Viewer送到客户端显示这个报表。
第一步：建立ADO Connection and Recordset
一个ADO的数据库连接就是通过你已经存在的ODBC数据源（DSN）从象ASP这样的应用中来访问
数据的连接。为了达到这个例子的目的，我们将使用到用一个叫做"Xtreme Sample Data"的
连到Access数据库Xtreme.mdb系统DSN
建立ADO数据库连接:
Set oConn = Server.CreateObject("ADODB.Connection")
这里建立叫做"oConn"的ADO connection，我们将用这个ADO connection对象连接到上述的DSN
用 ADO connection 必须先要打开它:
oConn.Open("Xtreme Sample Database")
这里打开我们的ODBC的数据源，这个数据源指向Access数据库Xtreme.mdb
现在我们必须建立一个RecordSet对象：
set session("oRs") = Server.CreateObject("ADODB.Recordset")
在上面我们建立了一个session("oRs"). 这个session中存放一个RecordSet对象
将要包含用SQL语句返回的数据
定义和生成 recordset:
session("oRs").ActiveConnection = oConn
定义这个recordset将要使用的Connection 对象
session("oRs").Open "SELECT [Product ID], [Product Name] FROM Product"
用SQL语句从Xtreme.mdb库的"Product"表中取出两个字段
===================================================================================
建立Crystal Reports 对象
===================================================================================
你可能注意到，Crystal Reports对象被设为session，这是因为已经需求就会被一个叫做
"rptserver.asp"的ASP处理，为了让rptserver.asp能非常容易地访问Crystal Report对象，
我们把这些对象都设为session。这样任何ASP页都运行在这个session中，都能够直接访问这些对象
reportname = "ADORecordset.rpt"
这里建立一个字符串变量，指向Crystal Report文件(.rpt file)，再用这段代码的时候
换成你的Crystal Report文件名。
建立APPLICATION 对象
If Not IsObject (session("oApp")) Then
Set session("oApp") = Server.CreateObject("CrystalRuntime.Application")
End If
这个"if/end if" 结构用来每个session只建立一次 Crystal Reports Application对象o
建立application对象 – session("oApp")，将Crystal Report Design Component
automation server (craxdrt.dll)载入内存。
我们建立session变量是为了再asp session过程中都使用它们.这样可以减少将craxdrt.dll
载入和卸载的系统开销。在一个session中一旦建立了一个application对象我们就可以不必
重建对象运行更多的报表 。
建立REPORT 对象
这个REPORT 对象被Application的OpenReport方法建立
Path = Request.ServerVariables("PATH_TRANSLATED")
While (Right(Path, 1) <> "\" And Len(Path) <> 0)
iLen = Len(Path) – 1
Path = Left(Path, iLen)
Wend
response.Write path
这个"While/Wend" 循环被用来将当前文件从虚拟路径(eg: http://Domain/Dir)转换成Crystal
Report file的物理路径(eg: C:\)
打开REPORT (先清除以前的任何对象)
If IsObject(session("oRpt")) then
Set session("oRpt") = nothing
End if
On error resume next
Set session("oRpt") = session("oApp").OpenReport(path & reportname, 1)
这里用"PATH" 和 "reportname"变量计算出Crystal Report file的物理路径, 并打开它。
If Err.Number <> 0 Then
Response.Write "Error Occurred creating Report Object: " & Err.Description
Set Session("oRpt") = nothing
Set Session("oApp") = nothing
Session.Abandon
Response.End
End If
这个 On erro resume next 块检查在建立report对象时出现的任何错误，我们正明确的捕获任何
错误如果视图超过许可协议规定的最大并发用户数。
注意，我们并不只建立一次report对象。这是因为有了ASP session 你可以处理更多的超过一个报表
rptserver.asp将仅仅处理一个叫session("oRpt")的report对象。因此，你如果希望处理多个报表
的话，就要建立一个新的session("oRpt")对象。
session("oRpt").MorePrintEngineErrorMessages = False
session("oRpt").EnableParameterPrompting = False
这里不允许错误报告机制，包括Crystal Report Design Component automation server (craxdrt.dll)
内建的错误报告，这是因为两个原因：
1. 打印引擎是在Web Server上执行的, 所以任何错误信息都将被显示在服务端，如果在服务端报告出错了，
打印引擎将停止运作，你的应用将被“挂起”
2. rptserver.asp 已经有一些错误处理逻辑在里面了，可以捕获任何非致命错误，并显示在客户端。
**重要** 即使我们禁止了服务端引擎的错误处理，但是致命错误还是会在Web Server服务端被捕获，并
显示出错误提示对话框。所以我们建议，你在"World Wide Web Publishing" service (IIS service)设置
"Allow Service to Interact with Desktop"选项。这样如果你的ASP应用死了，你将能看到错误提示。
======================================================================================
======================================================================================
现在我们必须告诉report在ADO recordset中的数据
report建立在动态的ADO recordset的基础，我们必须基于我们建立的recordset来建立report
然后在运行时我们告诉report数据在ADO Record set中。report通常依靠数据库结构文件
(ADORecordset.ttx)建立，这个.ttx文件包含recordset的结构，不包含实际数据。
一个Crystal Report完全依赖将要使用的Report的数据结构，因此在运行时你的数据库结构文件(ttx file)
或真实反应ADO recordset包含的数据的DSN是十分重要的
session("oRpt").DiscardSavedData
set Database = session("oRpt").Database
实例化report用到的数据库
set Tables = Database.Tables
实例化数据库对象中的表
set Table1 = Tables.Item(1)
实例化第一张表，在这个实例中这个表对象指向ADORecordset.ttx文件
Table1.SetPrivateData 3, session("oRs")
"SetPrivateData"告诉report现在数据源是 recordset，现在report将要显示的数据包含在session("oRs")中
如果你的report中包含子报表将提供不同的recordset来指向子报表的数据
====================================================================================
重新得到记录和建立"Page on Demand" Engine Object
====================================================================================
On Error Resume Next
session("oRpt").ReadRecords
If Err.Number <> 0 Then
Response.Write "Error Occurred Reading Records: " & Err.Description
Set Session("oRpt") = nothing
Set Session("oApp") = nothing
Session.Abandon
Response.End
Else
If IsObject(session("oPageEngine")) Then
set session("oPageEngine") = nothing
End If
set session("oPageEngine") = session("oRpt").PageEngine
End If
实例化 CRYSTAL REPORTS SMART VIEWER
在ASP环境中使用Crystal Reports automation server, 我们用相同的页来通过Crystal Web Report Server调用
"Smart Viewers"
有四个 Crystal Reports Smart Viewers:
1. ActiveX Smart Viewer
2. Java Smart Viewer
3. HTML Frame Smart Viewer
4. HTML Page Smart Viewer
你使用的Smart Viewer将与你数用的浏览器兼容的，例如你将不会使用Java viewer如果你的浏览器
不支持Java applets。为此，在这个DEMO中，我们已经选择定义一个viewer，你可以通过代码决定
提出要求的浏览器的支持兼容性，无论如何，这个功能继承自Crystal Reports automation server，
超过了这个示例的范围。
基于简单的理由，我们已经选择通过ASP服务端包含的功能来实现这个功能，你可以选择不同的
SmartViewer*.asp文件送到不同的浏览器，简单的用你想用的Smart Viewer asp文件来代替。
这些选择是： SmartViewerActiveX.asp, SmartViewerJave.asp,SmartViewerHTMLFrame.asp,
and SmartViewerHTMLPAge.asp.注意，使用这些包含文件时，你必须把相应的.ASP文件放在同主
ASP文件相同的虚拟路径中。
*注意* 对于 SmartViewerHTMLFrame and SmartViewerHTMLPage,你必须在虚拟路径中有framepage.asp
文件和toolbar.asp 文件
viewer = Request.Form("Viewer")
上面读取被使用的viewer的值，并放入变量"viewer"中
If cstr(viewer) = "ActiveX" then
%>
<!– #include file="SmartViewerActiveX.asp" –>
<%
ElseIf cstr(viewer) = "Netscape Plug-in" then
%>
<!– #include file="ActiveXPluginViewer.asp" –>
<%
ElseIf cstr(viewer) = "Java using Browser JVM" then
%>
<!– #include file="SmartViewerJava.asp" –>
<%
ElseIf cstr(viewer) = "Java using Java Plug-in" then
%>
<!– #include file="JavaPluginViewer.asp" –>
<%
ElseIf cstr(viewer) = "HTML Frame" then
Response.Redirect("htmstart.asp")
Else
Response.Redirect("rptserver.asp")
End If
上面 If/Then/Else 被设计测试"viewer" 变量的值，基于这个值，送适当的Crystal Smart Viewer
%>
