如何在PHP应用程序中使用FastReport报表|第2部分

原创|使用教程|编辑:郑恭琳|2019-10-17 15:07:28.370|阅读 14 次

概述:在本文的第1部分中,我们创建了一个ASP.Net Core应用程序,该应用程序中实现了以下方法:显示报表、显示报表设计器以及将设计器中更改的报表保存到服务器。但是,这些只是我们所说的两个功能。我们需要实现以pdf或html格式导出所需报表的方法,然后下载此报表。为了让用户知道哪些报表可供下载,我们将实现一种获取报表列表的方法。

相关链接:

本文的第1部分中,我们创建了一个ASP.Net Core应用程序,该应用程序中实现了以下方法:显示报表、显示报表设计器以及将设计器中更改的报表保存到服务器。但是,这些只是我们所说的两个功能。我们需要实现以pdf或html格式导出所需报表的方法,然后下载此报表。为了让用户知道哪些报表可供下载,我们将实现一种获取报表列表的方法。

将报表列表的数据结构添加到数据的模型(“Model”文件夹):

 public class Reports
 {
 // Report ID
 public int Id { get; set; }
 // Report File Name
 public string ReportName { get; set; }
 }

现在,我们可以在控制器中创建带有标识符的报表列表:

 // Fill in the list of reports
 Reports[] reportItems = new Reports[]
 {
 new Reports { Id = 1, ReportName = "Master-Detail.frx" },
 new Reports { Id = 2, ReportName = "Matrix.frx" }
 };

如上所述,我们需要客户端应用程序中的报表列表。这对于显示报表,在设计器中编辑报表以及下载pdf或html格式的报表很有用。

 // Get a list of reports in json format
 [HttpGet]
 public IEnumerable Get()
 {
 return reportItems; // Gets a list of reports
 }

这里的一切都很简单——json格式的报表列表。现在,我们正在实现一种相当复杂的获取报表导出的方法:

// Get the report file in pdf / html
 // Attribute has a required id parameter
 [HttpGet("{id}")]
 public IActionResult Get(int id, [FromQuery] ReportQuery query)
 {
 string mime = "application/" + query.Format; // MIME header with default value
 // Find the report
 Reports reportItem = reportItems.FirstOrDefault((p) => p.Id == id); // Get the value of the collection by identifier
 if (reportItem != null)
 {
 string reportPath = (webRoot + "/App_Data/" + reportItem.ReportName); // Determine the path to the report
 string dataPath = (webRoot + "/App_Data/nwind.xml");// Determine the path to the database
 using (MemoryStream stream = new MemoryStream()) // Create a stream for the report
 {
 try
 {
 using (DataSet dataSet = new DataSet())
 {
 // Fill the source with data
 dataSet.ReadXml(dataPath);
 // Turn on FastReport web mode
 Config.WebMode = true;
 using (Report report = new Report())
 {
 report.Load(reportPath); // Download report
 report.RegisterData(dataSet, "NorthWind"); // We register data in the report
 if (query.Parameter != null)
 {
 report.SetParameterValue("Parameter", query.Parameter); // Set the value of the report parameter, if the parameter value is transmitted in the URL
 }
 report.Prepare();//prepare a report
 // if pdf format is selected
 if (query.Format == "pdf")
 {
 // Export report to PDF
 PDFExport pdf = new PDFExport();
 // We use a stream to store the report so as not to create extra files
 report.Export(pdf, stream);
 }
 // if html report format is selected
 else if (query.Format == "html")
 {
 // Export report to HTML
 HTMLExport html = new HTMLExport();
 html.SinglePage = true; // Single page report
 html.Navigator = false; // Top navigation bar
 html.EmbedPictures = true; // Embeds images in a document
 report.Export(html, stream);
 mime = "text/" + query.Format; // Redefine mime for html
 }
 }
 }
 // Get the name of the resulting report file with the desired extension
 var file = String.Concat(Path.GetFileNameWithoutExtension(reportPath), ".", query.Format);
 // Download the report file
 return File(stream.ToArray(), mime, file);
 }
 // Handle exceptions
 catch
 {
 return new NoContentResult();
 }
 finally
 {
 stream.Dispose();
 }
 }
 }
 else
 return NotFound();
 }

此方法接收两个输入参数:id和query。第一个是我们列表中的报表标识符,第二个是我们在url中指定的报表参数集。我们将在下面查看此设置,但现在让我们继续使用Get方法。

如果需要,SetParameterValue方法设置我们传递给url的参数的值。这只是可能性的证明。

如您所见,从format参数中我们可以找到用户选择的内容。在我们的情况下,可以是pdf或html。根据格式,将导出报表。每种类型的导出都有自己的设置。结果,导出被保存到stream流中,然后被转换为文件以供下载。

现在回到Get-query方法的第二个参数。它具有一种ReportQuery。在数据模型中创建此类:

 // Report Request Structure
 public class ReportQuery
 {
 // Format of resulting report: pdf, html
 public string Format { get; set; }
 // Value of "Parameter" variable in report
 public string Parameter { get; set; }
 }

如您所知,Get方法是从WebAPI提取的。这个项目是一个混合项目。它同时具有View部分和WebAPI接口。

因此,为了获得显示报表的视图,必须形成以下形式的URL:

 https://localhost:44346/api/reports/ShowReport?name=ReportName.frx

为了与报表设计器进行演示,链接仅需在方法名称上有所不同:

 https://localhost:44346/api/reports/Designer?name=ReportName.frx

但是要获取报表的名称,您需要在客户端应用程序中提供可用报表的列表。您可以使用url获取json格式的报表列表:

 https://localhost:44346/api/reports/

要以选定的格式下载报表,您需要形成以下形式的网址:

 https://localhost:44346/api/reports/1?format=pdf

如果报表编号对应于服务器上报表列表中的ID,则格式可能具有pdf或html值。此外,如果报表模板中有任何参数,则可以指定一个报表参数。然后该网址将如下所示:

 https://localhost:44346/api/reports/1?format=pdf¶meter=REPORT

在这种情况下,报表中的参数本身应称为Parameter,其值取自url。通过类推,您可以在url中考虑任意多个参数。

我们已经完成了服务器端的工作。在本文的第3部分,我们将探讨在PHP的客户端应用程序中使用所有这些方法。

点击查看第1部分。

点击查看第3部分。



产品介绍 | 下载试用 | 优惠活动 | 在线客服



标签:

本站文章除注明转载外,均为本站原创或翻译。欢迎任何形式的转载,但请务必注明出处,尊重他人劳动成果

登录 慧都网发表评论


暂无评论...

为你推荐

  • 推荐视频
  • 推荐活动
  • 推荐产品
  • 推荐文章
  • 慧都慧问
相关厂商
相关产品
FastReport.Net

一款全功能的Windows Forms、ASP.NET和MVC报表分析解决方案。

FastReport Online Designer

一个跨平台的可视化Web报表设计器

在线
客服
在线
QQ
电话
咨询
400-700-1020
购物车 反馈 返回
顶部
在线客服系统
live chat