报表导出模板

1. 功能概述

报表导出模板是指导出报表时可以使用的快速模板，旨在方便最终使用者能更加方便地导出报表。

比如管理员了解到某些用户在导出报表时仅需使用某些设置将报表导出成PDF格式，那么他就可以将这样的设置在后台制作成模板，并将模板分享给相应的角色。

如此，用户在导出时就都能快速导出。

默认的导出模板有 PDF、Excel等11个模板，这也正是我们系统中支持的所有导出格式。

您可以在已有的模板基础上进行修改，也可以单击上方的“添加模板”按钮添加新的模板。

2. 在原有模板基础上修改

单击已有模板，比如Excel。

然后可以在右侧看到该模板的默认设置，修改后单击下方的保存按钮即可。

默认设置中包含基本信息、导出设置和用户可用选项三类项目，下面为您详细介绍。

3. 新建导出模板

添加模板名称，选择导出格式后单击创建模板即可创建新模板。

单击新建的模板，可在右侧进行详细设置，包括基本信息、导出设置和用户可用选项三类设置，设置完成后单击下方的保存按钮保存设置。

4. 设置详情介绍

4.1 基本信息

模板描述：为模板添加说明性文字，做标识。

**图标：**为了更方便在使用时找到当前模板，可以为模板选择一个图标。支持内置和自定义两种方式定义图标。并且使用内置图标时还可以为图标修改颜色。

内置：点击下拉按钮，选择一个合适的内置图标。然后设置图标的颜色，直接输入颜色值，然后点击页面其他空白区域生效。

也可以点击下拉按钮，使用 Web 颜色或更多颜色。

Web 颜色中的“主题色”是指随当前系统的主题色变化。使用更多颜色时，设置好了颜色值后，需要点击颜色预览块生效。

应用效果如下：
自定义：单击上传按钮，选择合适的图片即可。

应用效果如下：

显示序号编号：设置当前模板在导出列表中的显示先后顺序。数字并不代表严格的第几个，仅代表先后关系。比如将PDF模板的显示序号编号设置为0，那么效果如下：

如果多个模板的显示序号相同，那么最先设置为此编号的模板会显示在前面。

模板应用位置：设置模板的应用位置。目前系统中支持API导出、运行计划导出、报表预览工具栏、门户工具栏四处使用报表导出模板。不勾选的话代表在对应位置将不出现该模板。

比如在 PDF 模板中，我们不勾选门户工具栏：

那么在门户工具栏的导出列表中将不会出现PDF导出模板。

模板使用权限：

设置该模板可以被哪些组织或角色使用，这与文档的分享类似。勾选之后则可以使用该导出模板，不勾选则看不到该模板。

4.2 导出设置

设置模板的导出细节，不同的导出格式对应的导出设置项不同。

设置好之后，使用该模板导出时则直接按照模板的设置导出，无需自己再设置（用户可用选项中设置的项目除外）。

以下将几个设置项较多的格式进行展开说明：

4.2.1 PDF导出设置项

属性	说明
版本	选择使用哪个版本进行PDF导出。
嵌入字体	选择是否嵌入字体。
不嵌入字体	设置不嵌入的字体。
打开时打印	设置是否在打开PDF文件时自动启动打印流程。
标题	默认为报表名称，可自定义修改。导出后会显示在PDF文件属性的标题信息中。
作者	默认为当前用户名，可自定义修改。导出后显示在PDF文件属性的作者信息中。
主题	显示在PDF文件属性中的主题信息。
关键字	显示在PDF文件属性中的关键字信息。
应用程序	显示在PDF文件属性中的应用程序信息。
加密	设置导出的PDF文件是否加密。
作者密码	以创建者身份打开PDF文件时输入的密码。
用户密码	以用户身份打开PDF文件时需要输入的密码。
权限设置	设置文档的用户权限。
使用128位	“是”代表使用具有完全权限功能的128位加密。 “否”代表使用权限有限的40位加密。
隐藏工具栏	设置是否隐藏查看器应用程序的工具栏。默认值：否。
隐藏菜单栏	设置是否隐藏查看器应用程序的菜单栏。默认值：否。
隐藏窗口界面	设置是否隐藏文档窗口中的用户界面元素（例如滚动条和导航控件），仅显示文档的内容。默认值：否。
适合宽度	设置适合宽度。
适合整页	设置适合整页。
显示标题	设置是否显示标题。
显示模式	指定打开时文档的显示方式。
双面打印模式	设置双面打印模式。
复制份数	设置复制份数。
图像插值	图像的插值。将文件导出为PDF时，允许启用/禁用图像插值。
通过页面大小选择纸张来源	是否开启此功能。
打印页面范围	设置打印页面范围。
分页显示	设置是否分页显示。
打印布局模式	设置用于PDF文档的布局模式。
适应大小	设置适应大小。
开始页号	设置导出时开始的页号。
结束页号	设置导出时结束的页号。
水印相关	设置水印相关的属性。
动态名称格式	用于设置导出后文件名，具体用法请参见报表信息设置中关于导出设置的介绍。
文件名称追加时间戳	设置是否在导出文件名后追加导出的时间。

4.2.2 Excel导出设置项

属性	说明
标题	默认为报表名称，可自定义修改。导出后会显示在文件属性的标题信息中。
作者	默认为当前登录的用户名，可自定义修改。导出后会显示在文件属性的作者信息中。
分类	文档所在的分类，可自定义修改。导出后会显示在文件属性的分类信息中。
启用压缩	是否启用文件压缩功能，开启后导出的文件大小会较小。
文件格式	选择导出Excel时使用的格式，可选Xlsx 和Xls。
输出格式	选择输出格式。
启用切换	是否启用切换功能。当表格中使用了折叠功能（树形报表）时，可打开启用切换功能来导出折叠效果。
分页显示	是否分页显示。
使用默认调色板	是否使用默认Excel调色板导出文档。
选项卡模式	设置导出到Excel的选项卡模式，详见设计多选项卡模式的报表。
工作表名字	导出后excel工作表的名称，当有多个工作表时则会在此工作表名称后添加1、2、3……
受保护	打开文件时提示的密码设置人。
编辑密码	设置编辑权限打开时的密码。
只读模式打开	设置是否推荐以只读模式打开Excel。
纸张方向	设置纸张方向。
纸张大小	设置纸张大小。
动态名称格式	用于设置导出后文件名，具体用法请参见报表信息设置中关于导出设置的介绍。
文件名称追加时间戳	设置是否在导出文件名后追加导出的时间。

4.2.3 Word导出设置项

属性	说明
标题	默认为报表名称，可自定义修改。导出后会显示在文件属性的标题信息中。
作者	设置呈现的Word文档的“属性”对话框的“作者”字段中名称。默认为当前登录的用户名，可自定义修改。导出后会显示在文件属性的作者信息中。
分类	文档所在的分类，可自定义修改。导出后会显示在文件属性的分类信息中。
横向分辨率	设置Word文档中图像的水平分辨率。默认情况下，设置为96。
纵向分辨率	设置Word文档中图像的垂直分辨率。默认情况下，设置为96。
文档兼容版本	设置文档兼容的word版本。默认情况下，兼容版本设置为Word2007。
自动更新目录	设置是否自动更新目录。
公司名称	设置呈现的Word文档的“属性”对话框的“公司名称”字段的名称。
编辑密码	设置可以编辑文档的密码。
密码	设置可以查看文档的密码。
只读	设置是否推荐只读模式打开文件。
纸张方向	设置纸张方向。
纸张大小	设置纸张大小。
动态名称格式	用于设置导出后文件名，具体用法请参见报表信息设置中关于导出设置的介绍。
文件名称追加时间戳	设置是否在导出文件名后追加导出的时间。

4.2.4 CSV导出设置项

文件格式： 选择输出格式。支持 Xlsx 和 Csv。

当报表中表格组件使用了分组或者表头中使用了表达式时，则可以选择“Excel数据”导出，并选择Csv 格式来完成Csv 文件导出，可实现

所见即所得的效果。详见报表导出Csv文件时格式混乱。

下面列表是CSV格式的导出设置，有关Xlsx格式的导出设置，详见4.2.11 Excel数据导出设置项。

属性	说明
编码格式	选择编码格式。
无标题	选择是否无标题。
列分隔符	输入列分隔符。
行分隔符	输入行分隔符。
引用符号	输入引用符号。
日期时间格式	设置日期时间数据的导出格式。例如输入 “yyyy.MM/dd”，则按该格式显示。
数值格式	设置数值类数据的导出格式。例如输入“.0”，则导出后，保留一位小数。
动态名称格式	用于设置导出后文件名，具体用法请参见报表信息设置中关于导出设置的介绍。
文件名称追加时间戳	设置是否在导出文件名后追加导出的时间。

4.2.5 Html导出设置项

属性	说明
嵌入图片	设置是否将图片嵌入。
模式	设置显示模式，可选“分页”和“不分页”。
渲染方式	默认情况下为“ 混合” 以提高质量输出。选项是Html或混合，其中混合 “使用SVG”来渲染图表。
超链接目标	指定链接目标以控制是否在新窗口中打开报表和其他链接，或重新使用当前窗口。默认情况下不设置任何值，在同一窗口中打开链接。
分段	确定是否将返回完整的html文本，或仅返回body标签内包含的内容。 True表示只返回body标签内的内容，默认值为false。
样式表	开启以创建包含报表控件样式属性中的样式信息的外部.css文件。否则在HTML文件中嵌入样式信息。
输出目录	设置是否输出目录。
最后一页	设置结束页号。
动态名称格式	用于设置导出后文件名，具体用法请参见报表信息设置中关于导出设置的介绍。
文件名称追加时间戳	设置是否在导出文件名后追加导出的时间。

4.2.6 Image导出设置项

属性	说明
图片类型	设置导出的图片格式。支持的类型包括BMP，GIF，JPEG，TIFF和PNG。
分页显示	设置是否分页显示。如设置分页显示则需设置分页时页面的布局、是否适应大小、开始和结束页号以及水印相关的设置项。
横向分辨率	设置图像的水平分辨率。默认值为96。
纵向分辨率	设置图像的垂直分辨率。默认值为96。
动态名称格式	用于设置导出后文件名，具体用法请参见报表信息设置中关于导出设置的介绍。
文件名称追加时间戳	设置是否在导出文件名后追加导出的时间。

4.2.7 JSON导出设置项

属性	说明
格式化	设置是否开启格式化导出功能。
为属性名添加引号	设置是否为属性名添加引号。
动态名称格式	用于设置导出后文件名，具体用法请参见报表信息设置中关于导出设置的介绍。
文件名称追加时间戳	设置是否在导出文件名后追加导出的时间。

4.2.8 CSV原始数据导出设置项

属性	说明
编码	选择编码方式。
无标题	是否无标题。
列分隔符	设置列分隔符。
行分隔符	设置行分隔符。
引用符号	设置引用符号。
扩展设置	选择导出格式为.csv或.txt。
动态名称格式	用于设置导出后文件名，具体用法请参见报表信息设置中关于导出设置的介绍。
文件名称追加时间戳	设置是否在导出文件名后追加导出的时间。

4.2.9 TXT导出设置项

属性	说明
图表宽度	设置导出文件中图表的宽度。
图表高度	设置导出文件中图表的高度。
水平间距	设置水平间距。
线条终点	设置线条终点。
动态名称格式	用于设置导出后文件名，具体用法请参见报表信息设置中关于导出设置的介绍。
文件名称追加时间戳	设置是否在导出文件名后追加导出的时间。

4.2.10 XML导出设置项

属性	说明
格式	设置是否将输出的XML文本格式化，使其更加易读。
输出空属性	设置是否输出空属性。获取或设置当前的WriteEmptyAttributes设置。
默认日期格式	设置默认内部日期格式。
动态名称格式	用于设置导出后文件名，具体用法请参见报表信息设置中关于导出设置的介绍。
文件名称追加时间戳	设置是否在导出文件名后追加导出的时间。

4.2.11 Excel数据导出设置项

文件格式： 选择输出格式。支持 Xlsx 和 Csv。

当报表中表格组件使用了分组或者表头中使用了表达式时，则可以选择“Excel数据”导出，并选择Csv 格式来完成Csv 文件导出，可实现

所见即所得的效果。详见报表导出Csv文件时格式混乱。

下面列表是Xlsx格式的导出设置，有关CSV格式的导出设置，详见4.2.4 CSV导出设置项。

属性	说明
标题	默认为报表名称，可自定义修改。导出后会显示在文件属性的标题信息中。
作者	设置呈现的文档的“属性”对话框的“作者”字段中名称。默认为当前登录的用户名，可自定义修改。导出后会显示在文件属性的作者信息中。
分类	文档所在的分类，可自定义修改。导出后会显示在文件属性的分类信息中。
输出格式	选择输出格式。
启用压缩	是否启用文件压缩功能，开启后导出的文件大小会较小。
从右到左	导出后从右到左显示数据，并且将数据显示在Excel 页面的右侧。
允许导出图片	是否允许导出表格或矩表中的图片。
自动行高	是否自动调整导出后 Excel 的行高。
动态名称格式	用于设置导出后文件名，具体用法请参见报表信息设置中关于导出设置的介绍。
文件名称追加时间戳	设置是否在导出文件名后追加导出的时间。

4.3 用户可用选项

用户可用选项是指用户在使用模板的同时能进行部分的修改。

“全部禁止”也就意味着，用户只要使用该模板就会按照模板中的导出设置进行导出，不能进行任何修改。

“全部允许”是指用户在使用该模板时，会有模板中的默认设置，但用户可以进行自由的修改。

当然，您可以通过下面的选项打开部分开关。如下图仅打开了版本的开关，那么在实际应用导出模板时则仅可修改版本。

如下图，在使用PDF模板进行导出时，即使打开高级设置开关，也仅能设置版本。

1. 功能概述
2. 在原有模板基础上修改
3. 新建导出模板
4. 设置详情介绍
4.1 基本信息
4.2 导出设置
4.2.1 PDF导出设置项
4.2.2 Excel导出设置项
4.2.3 Word导出设置项
4.2.4 CSV导出设置项
4.2.6 Image导出设置项
4.2.7 JSON导出设置项
4.2.8 CSV原始数据导出设置项
4.2.9 TXT导出设置项
4.2.10 XML导出设置项
4.2.11 Excel数据导出设置项
4.3 用户可用选项