URL集成打印导出报表

教学视频

导出

报表除了可以通过 HTML 形式预览外，还允许导出 Word、Excel、PDF、CSV 三种格式的当前页及所有页数据。默认以 HTML 形式预览报表时，上方的工具栏上就存在一个导出按钮，通过这个导出按钮可以导出所有格式报表。如果需要对导出的报表类型进行控制，可以打开报表设计器工具栏上的报表设置窗口，并点击Web 预览工具栏标签页，选择导出工具项，对导出内容进行配置，如下图：

在导出配置中，可以配置允许导出哪些类型的文件，设置按钮名称，导出文件名以及导出文件是否添加打开密码等（CSV 不支持打开密码）。

导出 URL

如果需要在应用中直接导出某个报表文件，那么可以通过拼装 URL 方式实现，URL 格式如下：

http[s]://host[:port]/[context-path]/baskserver/baskreport/exportType?file=fileID[&online=online][&_n=fileName][&pageIndex=targetPageIndex][&parameters={name:value}]

这里的/baskserver 是 BaskServer 平台的 URL 名称，这个名称在安装配置的时候是可以修改的，具体参见 BaskServer 文档中系统初始化部分描述。

可以看到 URL 格式与 HTML 预览格式基本相同，URL 中的exportType值为具体的导出类型，它可以是 excel、word、pdf、csv 四种类型的值，分别表示导出对应类型的文件；_n 参数用于指定导出文件的文件名，如果不指定该参数，那么导出文件的文件名将与报表模版名称相同；online参数设置为true用于确保是根据已经发布上线的报表中实现导出，如果不指定该参数或这只值为false，那么就是导出当前草稿状态报表的数据。pageIndex参数用于指定导出具体哪一页，值从１开始，如果不指定该参数，那么就导出所有页数据。

打印

打印功能是利用浏览器可以直接预览 PDF 文件功能实现。默认 HTML 预览报表时，上方工具栏中就存在打印按钮，可以实现对当前报表数据的直接打印。如果需要配置的打印项，可以打开报表设计器工具栏上的报表设置窗口，并点击Web 预览工具栏标签页，选择打印工具项，对打印内容进行配置，如下图：

打印 URL

通过 HTML 预览页面上方的打印工具，可以实现对当前预览报表的直接打印，如果希望通过拼装 URL 方式打印报表，URL 格式如下：

http[s]://host[:port]/[context-path]/baskserver/baskreport/pdf?file=fileID&print=true[&pageIndex=targetPageIndex][&parameters={name:value}]

上面的 URL 当中与导出一个 PDF 文件的 URL 格式基本相同，只是多了一个名为 print 的参数，参数值为 true，这就表示导出的 PDF 文件将直接在浏览器中展示，然后我们可以通过浏览器的打印功能打印这个 PDF 文件，从而实现通过 URL 打印报表功能，如下图：

相较 HTML 预览页面中工具栏里提供的打印按钮打印，通过 URL 打印报表实际上只是在线显示对应报表导出的 PDF 格式文件，通过打印这个 PDF 文件实现打印功能，而 HTML 预览页面中工具栏里提供的打印按钮打印可以不预览 PDF 文件的前提下直接实现报表文件的打印。