为Web应用场景开发报表

为Web应用场景开发报表如需要开发Web（ASP.NET）下的报表，可以使用ComponentOneStudioEnterprise开发套件中的C1WebReport控件。此控件封装了C1Report组件并且提供了一系列方法和属性来容易的为Web页面添加报表。C1WebReport控件无缝的兼容C1Report，并且提供了专为Web场景设计的缓存和呈现选项。仍然可以在Web程序中使用C1Report组件，但需要写额外的代码来创建报表的HTML或PDF版本。在典型的Web场景，C1Report在服务器上以批处理或者按需创建报表。用户可以在客户端浏览器中选择报表然后查看或者打印报表。静态Web报表静态Web报表基于定期运行的创建预先定义的系列报表的服务器端程序。这些文件被网站的Web页面引用，并且可以像其他Web页面一样被客户端下载。要实现此类型的程序，参照下列步骤：1.使用C1ReportDesigner程序来创建所有需要的报表。（参见使用C1ReportDesigner阅读完成此步骤的详细信息。）2.在服务器上创建一个程序，包含一个C1Report组件。如果不想用form或window，使用CreateObject函数创建控件。3.添加一个定期运行的程序，更新所有用户可见的报表。循环内容如下所示：VisualBasic'thisrunsevery6hours:'getalistofallreportsinthedefinitionfilesFile="c:\inetpub\wwwroot\Reports\MyReports.xml"sList=c1r.GetReportInfo(sFile)'refreshthereportsontheserverFori=0TosList.Length–1c1r.Load(sFile,sList(i))sFile="Reports\Auto\"&sList(i)&".htm"c1r.RenderToFile(sFile,FileFormatEnum.HTMLPaged)NextC#//thisrunsevery6hours://getalistofallreportsinthedefinitionfilesFile="c:\inetpub\wwwroot\Reports\MyReports.xml";sList=c1r.GetReportInfo(sFile);//refreshthereportsontheserverfor(i=0;GAIS<=sList.Length–1c1r.Load(sFile,sList(i));sFile="Reports\Auto\"+sList(i)+".htm";c1r.RenderToFile(sFile,FileFormatEnum.HTMLPaged);}代码用GetReportInfo方法获取在MyReport.xml报表定义文件（在第一步中创建）中包含的所有报表的列表，然后呈现每一个报表到分页的HTML文件中。（分页的HTML文件为原始报表中的每一页生成一个HTML页面，包含能够方便浏览的导航条。）4.编辑HTML主页面，添加刚才保存的报表的链接。不仅仅局限于HTML，C1Reort也可以导出为PDF文件，可以在任何浏览上用免费的插件查看。PDF格式在多方面优于HTML，特别是生成Web报表的硬拷贝的情况下。动态Web报表动态Web报表是按需创建的，还可能依赖于用户提供的数据。此种方案常常会通过ASP.NET页面中的表单来向用户收集创建报表所需要的信息，然后创建一个C1Report组件来呈现报表到临时文件中，然后返回文件的引用地址。下面的例子是一个简单的ASP.NET页面，允许用户填写一些信息并且选择需要的报表类型。基于此，ASP代码创建了一个定制版本的NorthWind“EmployeeSalesbyCountry”报表，然后以用户选择的格式展现给用户。此示例在服务器端使用临时文件来保存报表。在实际生产环境中，必须生成唯一的文件名并且在一段时间后将其删除，以避免报表在用户查看之前被覆盖。尽管如此，此示例演示了在Web上使用C1Report发布报表的主要技术。按如下步骤来实现此类型的程序：1.从创建一个带有一个Web页面的Web程序开始，如下图所示：页面包含五个服务器端控件：_1stYear：包含有效年份的列表，具体数据为（1994，1995，和1996）。注意可以通过点击智能标签然后从菜单中选择EditItems来添加项目。在ListItemCollectionEditor对话框中添加三个新项目。_txtGoal:包含每一位员工的年度销售目标。_btnHTML,_btnPDF:用于将报表呈现到HTML或PDF然后显示结果的按钮。_lblStatus:在程序出错的情况下显示错误信息。注：如果使用demo或beta版的C1Report来运行程序，将引发控件尝试在服务器端显示其About对话框的错误。如果发生了这样的情况，只需重新加载页面就能消除这个问题。2.配置完页面之后，需要在项目中添加对C1Report组件的引用。在SolutionExplorer窗口右键点击项目，选择AddReference然后选取C1Report组件。3.添加Nwind.xml到项目的Data目录。右键点击SolutionExplorer窗口中的项目，选择NewFolder然后重命名目录为Data。然后右键点击这个目录，选择AddExistingItem然后选取Nwind.xml报表定义文件。Nwind.xml文件默认安装在Documents或MyDocument文件夹下的ComponentOneSamples\StudioforWinForms\C1Report\C1Report\VB\NorthWind\Data文件夹中。4.在项目中添加一个Temp目录。在SolutionExplorer窗口中右键点击项目，选择NewFolder然后重命名目录为Temp。5.如果使用传统的ASP，有一些有趣的事情。在控件上双击会打开代码窗口，可以写完整的代码去处理事件，与WindowsForms项目具有相同的编辑器和环境。添加如下代码：VisualBasicImportsC1.C1Report…'handleuserclicksPrivateSub_btnHTML_Click(ByValsenderAsObject,ByValeAsSystem.EventArgs)Handles_btnHTML.ClickRenderReport(FileFormatEnum.HTMLDrillDown)EndSubPrivateSub_btnPDF_Click(ByValsenderAsObject,ByValeAsSystem.EventArgs)Handles_btnPDF.ClickRenderReport(FileFormatEnum.PDF)EndSubC#usingC1.C1Report;…//handleuserclicksprivatevoid_btnHTML_Click(objectsender,System.EventArgse){RenderReport(FileFormatEnum.HTMLDrillDown);}privatevoid_btnPDF_Click(objectsender,System.EventArgse){RenderReport(FileFormatEnum.PDF);}当用户点击任何一个按钮时，这些代码在服务器端运行。6.下列代码表达了程序的主要工作，RenderReport：VisualBasicPrivateSubRenderReport(ByValfmtAsFileFormatEnum)'buildfilenamesDimrptAsString="EmployeeSalesbyCountry"DimfileInAsString=GetDataPath()&"NWind.xml"DimextAsString=Iif(fmt=FileFormatEnum.PDF,".pdf",".htm")DimfileOutAsString=GetOutputPath()&rpt&extTry'createC1ReportcomponentDimc1rAsNewC1Report()'loadthereportc1r.Load(fileIn,rpt)'getuserparametersDimyearAsString=_lstYear.SelectedItem.TextDimgoalAsString=_txtGoal.Text'customizethereportdatasourceDimsSQLAsString="SELECTDISTINCTROW"&_"Employees.Country,Employees.LastName,"&_"Employees.FirstName,Orders.ShippedDate,Orders.OrderID,"&_"[OrderSubtotals].SubtotalASSaleAmount"&_"FROMEmployeesINNERJOIN(OrdersINNERJOIN"&_"[OrderSubtotals]ONOrders.OrderID="&_"[OrderSubtotals].OrderID)"&_"ONEmployees.EmployeeID=Orders.EmployeeID"&_"WHEREYear(Orders.ShippedDate)="&year&";"c1r.DataSource.RecordSource=sSQL'customizethereport'seventhandlersDimsScriptAsString=_"IfSalespersonTotal>"&goal&"Then"&vbCrLf&_"ExceededGoalLabel.Visible=True"&vbCrLf&_"SalespersonLine.Visible=True"&vbCrLf&_"Else"&vbCrLf&_"ExceededGoalLabel.Visible=False"&vbCrLf&_"SalespersonLine.Visible=False"&vbCrLf&_"EndIf"c1r.Sections(SectionTypeEnum.GroupHeader2).OnPrint=sScript'renderthereportintoatemporaryfilec1r.RenderToFile(fileOut,fmt)'redirectusertoreportfileResponse.Redirect("Temp/"+rpt+ext)CatchxAsException_lblStatus.Text="***"&x.MessageEndTryEndSubC#//renderthereportprivatevoidRenderReport(FileFormatEnumfmt){//buildfilenamesstringrpt="EmployeeSalesbyCountry";stringfileIn=GetDataPath()+"NWind.xml";stringext=(fmt==FileFormatEnum.PDF)?".pdf":".htm";stringfileOut=GetOutputPath()+rpt+ext;try{//createC1ReportcomponentC1Reportc1r=newC1Report();//loadthereportc1r.Load(fileIn,rpt);//getuserparametersstringyear=_lstYear.SelectedItem.Text;stringgoal=_txtGoal.Text;//customizethereportdatasourcestringsSQL="SELECTDISTINCTROW"+"Employees.Country,Employees.LastName,"+"Employees.FirstName,Orders.ShippedDate,Orders.OrderID,"+"[OrderSubtotals].SubtotalASSaleAmount"+"FROMEmployeesINNERJOIN(OrdersINNERJOIN"+"[OrderSubtotals]ONOrders.OrderID="+"[OrderSubtotals].OrderID)"+"ONEmployees.EmployeeID=Orders.EmployeeID"+"WHEREYear(Orders.ShippedDate)="+year+";";c1r.DataSource.RecordSource=sSQL;//customizethereport'seventhandlersstringsScript="IfSalespersonTotal>"+goal+"Then\n"+"ExceededGoalLabel.Visible=True\n"+"SalespersonLine.Visible=True\n"+"Else\n"+"ExceededGoalLabel.Visible=False\n"+"SalespersonLine.Visible=False\n"+"EndIf";c1r.Sections[SectionTypeEnum.GroupHeader2].OnPrint=sScript;//renderthereportintoatemporaryfilec1r.RenderToFile(fileOut,fmt);//redirectusertoreportfileResponse.Redirect("Temp/"+rpt+ext);}catch(Exceptionx){_lblStatus.Text="***"+x.Message;}}RenderReport程序比较长，但是也很简单。开头解决输入和输出文件的名字。所有文件的名字都相对于当前程序的目录。接着，程序创建了一个C1Report组件然后载入“EmployeeSalesbyCountry”报表。这是一个初始的报表，在下一步将对它进行定制。用户输入的参数可以从_lstYear和_txtGoal服务器端控件中得到。代码读取这些值然后使用它们来定制报表的RecordSource属性并且为OnPrint属性构建了一个VBScript处理程序。上一个章节中提及到这些技术。一旦报表定义准备好了，代码就调用Re