HTML5报表查看器概述
HTML5报表查看器是一个纯粹的基于HTML5/JavaScript/CSS3 jquery的小部件,它支持在HTML页面中显示Telerik报表。
HTML5报表查看器通过报告HTML呈现机制.
布局和样式基于纯HTML5模板和CSS3样式,完全可定制。默认实现支持移动和桌面浏览器。响应式布局适应自己的设备显示,以获得最佳的观看体验。您可以使用剑道UI主题自定义它的视觉外观。
如果在使用HTML5 Report Viewer时遇到任何问题,请注意以下几点:
故障处理建议使用Telerik Fiddler无处不在或其他调试代理工具。Fiddler使您能够通过导航到来检查请求、它们的响应和状态检查员>请求/响应>生.通过这种方式,您可以检查向Reporting REST服务发出的请求,并确定其url是否正确,以及相对路径是否正确解析。根据应用程序的托管方式,您可能需要这样做调整相对路径.
或者,您也可以使用Telerik Fiddler Jam故障诊断的解决方案。Fiddler Jam作为浏览器扩展安装,并收集在浏览器中执行的请求和响应的日志。日志被安全地存储,以后您可以通过URL与第三方共享它们以进行检查。《Fiddler Jam》正在积极开发中,就部署和集成而言,它可能是比《Fiddler Everywhere》更好的选择。
报表预览区
报表预览区域为呈现的报表提供占位符。工具栏提供的所有命令都操作当前显示在此区域中的报告。
它内置了对终端用户交互的支持,比如向下钻取和穿透钻取,导航到报表中的书签和外部url。
工具栏
HTML5报表查看器的工具栏提供了与当前加载的报表交互的基本功能:
在历史中向前/向后导航 | |
停止渲染 | |
更新报告 | |
进入第一页,前一页,特定页/总页数,下一页,最后一页 | |
打印预览:切换逻辑而且物理页面渲染器。检查渲染和分页文章获取更多信息。 | |
出口:检查导出格式获取可用的导出格式。 | |
打印:检查打印报告文章获取更多信息。 | |
切换文档映射区域 | |
切换发送电子邮件窗口,该窗口允许将带有特定参数的报告作为附件发送到用户列表。检查发送电子邮件消息文章更多信息。 | |
切换参数区域 | |
缩放页面以获得最佳的观看体验,包括完整的页面,页面宽度或自定义比例因子. | |
切换允许在报告内容中搜索的搜索窗口小部件。检查搜索文章更多信息。 |
报表参数
参数窗格为用户输入提供了直观的UI。基于html5的报表查看器使用Kendo UI小部件用于开箱即用的参数编辑器。根据参数的类型,创建合适的编辑器UI。
不同报表参数类型的默认小部件列表:
DateTime:剑道UI DatePicker小部件.即使不能通过Kendo UI DatePicker小部件UI选择时间部分,它仍然作为默认的时间部分(12:00:00 AM)和DateTime值传递给报表引擎。如果需要,查看器也可以定制的使用剑道UI DateTimePicker或另一个允许显式选择时间部分的小部件。当在HTML5报表查看器的参数区域中选择DateTime值时,它在处理和呈现报表的服务器上被解释为UTC DateTime。例如,在DateTimePicker报表参数小部件中输入1/1/2000 12:00:00 AM并呈现报表,将在服务器上和呈现的报表中产生以下DateTime值—1/1/2000 12:00:00 AM被视为UTC时间。
整数|浮动|字符串:剑道UI ListView小部件.可以很容易地将默认编辑器更改为剑道UI组合框(对于单个选择参数)和剑道UI多选择(用于多选择参数)编辑器。欲了解更多信息,请点击参数选项报表查看器初始化篇文章。
当至少有一个报告参数已将其Visible属性打开,则参数区域将显示为报表查看器的一部分。这有助于报表开发人员方便地为最终用户提供输入法。根据参数的类型,创建合适的编辑器UI。参数区的参数布局会自动格式化。的顺序由参数出现的顺序决定ReportParameters集合编辑器.最终用户可以在编辑器中输入或选择值。
当至少一个可见报表参数的“自动刷新”属性关闭时预览按钮出现。在这种情况下,要预览报告,最终用户应该单击preview按钮。如果所有参数都为默认值,则报表在第一次查看时自动运行。控件的参数区域可以显示或隐藏参数报表查看器工具栏中的按钮。
文档地图
文档映射窗格提供一组导航链接,以指向呈现的报表中的报表项。当您查看具有文档映射的报表时,报表预览区旁边会出现一个单独的侧窗格。用户可以单击文档映射中的链接跳转到显示相应项目的报表页面。报告节和组按链接的层次结构排列。单击文档映射中的项将刷新报表预览,并显示与文档映射中的项对应的报表区域。
要向文档映射添加链接,请设置DocumentMapText属性设置为创建的文本或计算为要在文档映射中显示的文本的表达式。
页面模式
的页面模式是两个。连续滚动而且单页.单页模式只在视图端口中呈现一个页面。这种模式不会妨碍使用大量DOM对象、操作或事件侦听器的浏览器,但会限制用户可以读取的报告数据。
连续滚动模式使用户能够一次性阅读所有报表页面。当报表准备好后,在视口中呈现N个页面,以填充报表查看器的可见部分。如果用户向上或向下滚动,每个下一页或上一页将按需加载。例如,如果用户导航到第5个页面,在DOM树中将呈现在视口中可见的所有页面,在所需页面之前和之后,加上它们的所有操作和事件监听器。所有不在可见部分的其他页面都不会被加载。在它们的位置上将添加骨架页面,只有当用户滚动到它们时,才会用实际页面替换它们。
连续滚动模式是默认的页面模式。要更改页面模式,请选中pageMode选项报表查看器初始化篇文章。
它是如何工作的
HTML5 Report Viewer是Telerik Kendo Ui小部件的组合,该模板由三个文件组成:HTML (Ui), CSS(样式),JS(功能)。查看器可以使用标准JavaScript、CSS和自定义HTML设置样式和自定义。更多详情请参阅HTML5报表查看器定制文章。
HTML5报表查看器的目的是显示Telerik报表,并允许用户与之交互。在服务器上处理和呈现报表报告引擎而且报告REST服务运行。控件处理报表及其资源并将其传递给查看器报告REST服务.
HTML5报表查看器的内容呈现在DIV元素。的HTML呈现机制来呈现查看器中的报表HTML渲染的设计考虑.