Telerik报告?下载30天免费试用

Telerik报告REST服务概述万博体育手机版网址

Telerik Reporting REST服务通过HTTP向报表生成引擎提供一个应用程序编程接口(API)。该引擎允许以所有支持的呈现格式导出报表文档。服务器-客户端通信依赖于简单的数据传输对象(dto)。所有dto都是JSON编码的。

服务的主要用途是在HTML5报表查看器生态系统。它利用了查看器的纯客户端实现。

您可以在JavaScript应用程序中使用Reporting REST服务,而无需查看器。请参阅telerikReportViewer。ServiceClient类。

服务有针对不同web服务框架的几个实现,这些在本章中有描述。

它是如何工作的

Reporting REST服务将所有报表生成资产公开为可以从特定web端点访问的web资源。这些暴露的资产包括:

  • 报告实例

  • 报告文件

  • 图片

  • 其他呈现的报表元数据

要访问这些报表生成资产,客户端主机发出一组请求,并将它们包装在一个客户机会话中clientId

服务请求

下面的步骤描述了Reporting REST服务如何服务客户端的请求:

  1. 服务的客户端通过JSON对象请求一个报告客户端报告来源

  2. 服务将请求解析到.NET报表源.要做到这一点,它使用REST服务报表源解析器

  3. 该服务将呈现的报告作为web可访问的资源提供。

  4. 对象中缓存所有生成的资源REST服务存储的选择。

配置提示

您可以在应用程序的配置文件中配置报表服务——对于不同的服务实现,可以是.config或.json。有关更多细节,请参见restReportService元素

此外,上面列出的每个步骤都允许您进行额外的配置和定制,例如:

  • 客户端会话在特定的时间内过期,该时间可以配置。也就是说,在单个客户机会话中,相同的请求总是返回相同的缓存资源。

    一个例外是注册客户端端点,它可以强制重新生成以支持“刷新报告”功能。为此,在请求的主体中添加useCache = false设置。

  • 在某些情况下,你需要与多个应用程序共享服务。对于这些,你可能需要打开跨地域资源共享

  • 如果同时执行所有新的报告请求,则主机将过载。为了避免这种情况,该服务在任务队列中执行报告生成请求。同时呈现的报表的计数为可配置的

  • 在某些场景中,您需要在单个应用程序中托管两个或多个报表服务。万博体育手机版网址为此,为每个实现控制器分配一个唯一的HostAppId属性。这将为每个服务实例生成一个专用的任务队列。此外,您必须为每个队列设置适当的工作者计数,以避免系统过载。

在本文中
Baidu
map