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

在本文的第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：

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

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

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

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

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

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

点击查看第1部分。

点击查看第3部分。

产品介绍 | 下载试用 | 优惠活动 |