两种方法,轻松完成Telerik Reporting REST服务和报表服务器的切换!

Telerik Reporting拥有直观、无代码的Win、网页与PDF报表的创建功能,直观的设计与具有特定风格的报表,无代码数据打包、向导、语法开发工具、自动操作。分类整理、过滤、有条件格式化、转化器格式,活动报表,水晶报表,附加报表。

本文主要目的是展示在这两种呈现报表的方法(Telerik Report Server (TRS)和Telerik Reporting REST)之间切换是多么容易,我们还将展示每种方法的优缺点,以及如何同时运行两种解决方案并在两者之间切换。

需要注意的一点是:它需要一点设置,您需要有一个ASP. NET Core站点,这用于通过HTML5 Telerik Report查看器调用TRS 和REST报表实例。

获取Telerik Reporting新版下载(Q技术交流:726377843)

初始设置

对于在TRS和REST报表之间切换的初始设置,我们需要做以下工作:

TRS:设置TRS实例

确保版本与ASP.NET Core站点上的Telerik Reporting版本匹配。

  1. 要么在主站点外设置子域,要么在端口上运行localhost。注意:子域版本需要Telerik授权许可,而本地主机不需要。
  2. 将网站从安装文件夹复制到物理托管区域。
  3. 修改连接字符串区域,TRS实例应该开始工作。
REST报表:创建一个Telerik REST报表站点

1. 这涉及到创建一个Telerik Reporting REST服务项目,注意:在本例中创建了一个.NET Framework版本的Reporting REST服务,这是因为已经在.NET框架项目中使用了一些用户函数,这些函数在.NET Core环境中无法工作。另外注意:可以从.NET Core网站和.NET Core Worker调用.NET框架项目(也就是说不需要有一个UI来调用REST项目)。

(或者,您可以使用名为CSharp.NetFramework.ReportingRestServiceCorsDemo的项目。Csproj作为模板随产品安装一起分发,如果您不熟悉CORS配置这可能会加快速度。注意:这可以通过初始的Visual Studio Project对话框使用。)

有必要用下面的代码来修饰Controller类,否则就会出现CORS错误。

[EnableCors(origins: "https://staging.buku.uk"
, headers: "*", methods: "*")
]
public class ReportsController : ReportsControllerBase

2. 另外,有必要将一些报表放在项目根目录下的一个名为Reports的目录中,您可以使用子目录分隔报表。

3. 使用自定义报表解析器来修复由调用函数提供的连接字符串和参数。在大多数情况下,这是一个Telerik HTML5报表查看器,但是后台任务可以从始终在线的Worker进程中运行。

注意:Booking.Data.NET.Classes.Configuration. _sBookingConnectionString属性解析为基于_nServerInstance变量的连接字符串,即Dev, Staging或Live。

using System.Collections.Generic;
using System.IO;
using System.Linq;
using Telerik.Reporting;
using Telerik.Reporting.Services;
using Booking.Library.NET.Classes;

namespace Booking.Reporting.NET.REST.Classes
{
public class CustomReportSourceResolver : IReportSourceResolver
{
public string ReportsPath { get; set; }

public CustomReportSourceResolver(string reportsPath)
{
this.ReportsPath = reportsPath;
}

public ReportSource Resolve(string reportId, OperationOrigin operationOrigin, IDictionary currentParameterValues)
{
try
{
string reportPath = Path.Combine(this.ReportsPath, reportId);
var reportPackager = new ReportPackager();
Report report = null;
using (var sourceStream = System.IO.File.OpenRead(reportPath))
{
report = (Report)reportPackager.UnpackageDocument(sourceStream);
}
if (currentParameterValues.Any(CPV => CPV.Key == "nServerInstance"))
{
var lnServerInstance = currentParameterValues.Where(CPV => CPV.Key == "nServerInstance").FirstOrDefault().Value;
Booking.Data.NET.Classes.Configuration._nServerInstance = (int)(long)lnServerInstance;
}
ReportConnectionStringManager loReportConnectionStringManager = new ReportConnectionStringManager(Booking.Data.NET.Classes.Configuration._sBookingConnectionString);
ReportSource loReportSource = loReportConnectionStringManager.UpdateReportSource(new InstanceReportSource() { ReportDocument = report });
foreach (var parameter in currentParameterValues)
{
loReportSource.Parameters.Add(parameter.Key, parameter.Value);
}
return loReportSource;
}
catch (System.Exception loException)
{
Logger.LogException(loException);
}
return null;
}
}
}
优点和缺点

选择其中一个或另一个的利弊主要与成本有关。虽然TRS是物有所值的,但一些客户有预算限制,可能会在某些条件下妨碍销售。Buku平台被设计为在客户端基础设施上运行,客户端希望这样做(即,他们自己的服务器和网络,以及产品,可以完全运行在Windows笔记本电脑上)。所以,如果发现一个想要运行软件的客户,他们也必须购买TRS,他们的成本就会显著上升。

REST解决方案可以呈现与TRS解决方案相同的报表,客户端唯一的成本是硬盘空间和计算机功率。(在TRS下面是REST服务的实现,它使这种切换场景变得轻松。)请注意,还将有一个云版本,客户可以在其中注册使用该产品,并且数据位于安全的云中。

TRS解决方案在能够从服务器本身运行报表方面有一些额外的优势,尽管我们没有在Buku平台中完全使用这个特性,客户只能看到Buku平台报表引擎。目前官方正在计划一个额外的Reporting模块,它将允许用户根据预编程的数据源设计自定义报表。

因此 HTML5 Report Viewer 的配置方式是设计考虑的因素之一,它可以在TRS和REST之间来回切换。

下面是报表查看器的顶部,有几点需要注意:

1. TRS具有不需要登录凭据的来宾模式,从URL下面的行中可以看到这一点。

2. REST没有身份验证方法,但是将凭据行保留在原来的位置会被忽略。

3. TRS数据源由TRS数据连接器控制,它实际上是一个连接字符串。对于一些较小的报表,也有一些对象数据源。

4. REST程序总是使用_nServerInstance安排来确定连接字符串,这取决于是Dev、Staging还是Live。

5. 不同类型的报表具有不同类型和数量的参数,但是有些报表使用相同的参数和参数类型,可以对多个报表使用相同的块将它们组合在一起。

$(document).ready(function () {
$("#rvMain").telerik_ReportViewer({
reportServer: {
url: "@this.Model._sReportingUrl",
username: null,
password: null
},
reportSource: {
report: '@this.Model._sReport',
parameters: {
@switch ((Booking.Library.Classes.Enums.Reports)this.Model._nReport)
{
case Booking.Library.Classes.Enums.Reports.AdHocSLInvoice1:
case Booking.Library.Classes.Enums.Reports.AdHocSLInvoice2:
case Booking.Library.Classes.Enums.Reports.AdHocSLCreditNote1:
case Booking.Library.Classes.Enums.Reports.AdHocSLCreditNote2:
case Booking.Library.Classes.Enums.Reports.AdHocPLInvoice1:
case Booking.Library.Classes.Enums.Reports.AdHocPLInvoice2:
case Booking.Library.Classes.Enums.Reports.AdHocPLCreditNote1:
case Booking.Library.Classes.Enums.Reports.AdHocPLCreditNote2:
case Booking.Library.Classes.Enums.Reports.AdHocPLPayment:
case Booking.Library.Classes.Enums.Reports.AdHocSLReceipt:
{

nServerInstance: @Booking.Data.Classes.Configuration._nServerInstance,
gTransactionId: '@this.Model._gId.ToString()',
gCompanyId: gCompanyId,
sCulture: sCompanyCulture

}
break;
case Booking.Library.Classes.Enums.Reports.AdHocDisbursementBatch:
{

nServerInstance: @Booking.Data.Classes.Configuration._nServerInstance,
gBatchId: '@this.Model._gId.ToString()',
sCulture: sCompanyCulture

}
break;
case Booking.Library.Classes.Enums.Reports.DisbursementBatch:
{

nServerInstance: @Booking.Data.Classes.Configuration._nServerInstance,
gCompanyId: gCompanyId,
dStart: kendo.parseDate('@this.Model._dStart.ToString("dd/MM/yyyy")', "dd/MM/yyyy"),
dEnd: kendo.parseDate('@this.Model._dEnd.Date.AddDays(1).ToString("dd/MM/yyyy")', "dd/MM/yyyy"),
bPosted: '@this.Model._bPosted.ToString().ToLower()',
nReport: @this.Model._nReport,
bAll: '@this.Model._bAll.ToString().ToLower()' == 'true',
sCulture: sCompanyCulture

}
break;
case Booking.Library.Classes.Enums.Reports.AdHocJournalBatch:

在某些方面,REST报表有一种更简单的机制来保持报告的最新状态,磁盘上的报表是最新的,并且总是保存回磁盘,TRS报告需要发布回服务器。

为了管理切换,我使用了两个控件,一个开关和一个TRS / REST Url字段。开关就是简单的TRS开或关,包含Url的字段将用于TRS https://trs.buku.uk和REST https://rs.buku.uk(报表暂存(RS))。

在使用REST后切换回TRS有点麻烦,因为报表在TRS上经常不是最新的,所以需要再次推送。

你可能感兴趣的:(服务器,界面控件,telerik,报表开发)