选项

本菜单项的功能是用于配置新建报表的默认属性、集算器选项、系统参数等。

点击工具 - 选项，弹出选项配置窗口，如下图所示：

● 蓝色的选项修改后，需要重启报表设计器才能生效。

可切换到常规、文件、初始属性、JSP及集算器选项标签页，设置相关的属性。

“常规”标签页：

在选项配置窗口中切换到“常规”标签页，如上图所示：

 

接管控制台

是否将运行报表日志写到控制台中，如果该属性没有打勾，那么设计器左侧就没有控制台面板。如果该属性打勾了，那么我们可以在设计器左侧控制台面板查看系统日志信息。

控制台面板的功能是用于查看系统记录的报表日志信息，其中包括一些操作错误信息，以方便用户的调试。

点击控制台，系统会切换出控制台窗口，如下图所示：

点击【复制】按钮，可以把控制台信息复制到别的地方。点击【清除】按钮，可以清除控制台中的信息。

 

自动打开（最近文件）

是否打开设计器时，自动打开上次关闭设计器时最后一次打开的文件。如果该属性打勾了，那么下次重新打开设计器时，就自动的打开最近一次打开的报表文件，如果上次打开的文件不存在，则打开设计器时会有错误信息。如果该属性没有打勾，那么下次打开设计器时不会自动打开任何的报表文件。

 

保存时自动备份（加文件后缀.BAK）

是否对修改后的报表保存时，自动备份修改前的报表。如果该属性打勾了，系统在保存修改后的报表时自动的备份修改前的报表。当用户发现修改错误想回到修改前的状态时，利用备份文件就可恢复。如果该属性没有打勾，那么对修改后的报表保存时，不会备份修改前的报表。

 

将异常写入日志文件

当报表运算时出现异常，是直接在后台窗口上打出来，还是写入日志文件。如果该属性打勾了，那么当有异常信息产生时就会写入到日志文件。如果该属性没有打勾，那么异常信息就不会写入日志文件。日志文件在工具 - 选项 - 文件标签页中配置。

 

启动时检查更新

打开设计器时是否自动检查更新，如果勾选该属性，则会在打开设计器时自动检查当前产品是否需要更新，不勾选则不会进行更新检查。

 

自动连接（最近连接）

是否打开设计器时，自动连接到最近的数据库连接。如果该属性打勾了，那么下次启动设计器时就会自动的连接最近一次的数据源连接。如果该属性没有打勾，那么下次打开设计器时不会自动的进行数据源的连接。

 

阻止计算数据集的字段名

如果不选择该选项，设计器在打开某一报表时或者编辑报表的数据集后，程序要计算出数据集的字段名以便编辑表达式用。而对于有些数据集，计算字段名比较耗时间，这个时候我们对这样的报表选择“阻止计算数据集的字段名”，那么在打开一张报表时或者编辑报表的数据集后不计算字段名。

 

粘贴单元格时调整表达式

将某一个单元格的表达式复制粘贴到另一个单元格时，是否将该单元格中的表达式动态调整。

比如：B1单元格中表达式为：=A1+A2,将B1单元格的表达式复制粘贴至B4单元格，如果设置了该属性，则B4单元格的表达式自动调整为：=A4+A5，如果不设置该属性，则B4单元格的表达式仍然为：=A1+A2。

 

记忆窗口位置大小

是否记忆窗口的位置大小。如果该属性打勾了，那么改变窗口的位置大小后，系统会记忆改变后的窗口位置大小，下次打开窗口时系统会在记忆的位置显示记忆大小的窗口。如果该属性没有打勾，那么每次打开窗口时都按默认的大小在默认的位置显示。该选项作用于所有可调整大小的对话窗口，比如数据集窗口，参数编辑窗口，表达式编辑窗口等等

 

动态提示设置的属性

是否将鼠标放到某一单元格上时自动的在设计器最下方显示该单元格的属性信息。如果该属性打勾了，那么把鼠标放到某一单元格上时自动的显示该单元格的属性信息，否则就不显示该单元格的属性信息。如下图，鼠标放在A1单元格时设计器下方出现A1单元格的信息：

 

自动过滤字体

输入的文字如果某些字体没法显示,则字体下拉列表里那些没法显示的字体就被过滤了。

 

模板菜单

用于设置是否显示模板菜单，只有勾选了模板菜单，才会在文件菜单中出现模板菜单选项。

 

在字符处折行

用于设置换行时是否切单词。

 

勾选“在字符处拆行”  不勾选“在字符处拆行”

 

应用程序外观

用于设置设计器的外观风格。可以选择的风格有：Silver、Blue。

 

历史步骤最大数目

是指系统记录您的编辑步骤，您如果按CTRL+Z，或者单击编辑 - 撤消，能够回退的最大步骤数。

 

文字折行微调宽度

用于设置文字折行时的微调宽度，及每一行距右边框的宽度，像素为单位。

 

文字折行微调宽度值为5  文字折行微调宽度值为30

 

连接数据库时最长等待

用于设置连接时数据库最长的等待时间，如果超过了设置值就认为连接失败。

 

数值格式化类名

用于设置数值的格式时，用户自己写的数值格式化类。

 

日志级别

用于设置控制台显示不同级别的日志。

日志输出级别可为OFF、SEVERE、WARNING、INFO、DEBUG， 优先级依次降低，若为OFF则不输出任何，假设日志输出级别为INFO，则只输出SEVERE、WARNING、INFO等级别的信息，依次类推。

通过ide启动内置tomcat时，此处为入口日志级别，此处设置的级别与文件。

raqsoftReportLog.properties中的日志级别有交集时，才会输出日志。比如此处设置为INFO级别，raqsoftReportLog.properties的日志级别为DEBUG,那么web端日志则只会输出INFO级别的日志。

 

日志类型

用于设置不同类型的日志系统。缺省使用润乾的日志输出系统。

当日志类型选择SLF4J时，用户可绑定自己的日志系统，如logback、log4j、slf4j-simple等。

 

单元格内输入回车时切换自动换行

用于设置输入多行内容的时候，自动把单元格属性改成自动换行。

 

默认配色方案

用于设置编辑颜色，例如工具栏中的前景色、背景色、边框颜色等。

缺省配色方案作用范围为全部时，还可为统计图设置配色方案。

 

缺省配色方案作用范围

用于设置缺省配色方案的应用范围，有IDE编辑和全部两个选项。

缺省配色方案作用范围设置为IDE编辑时，仅对IDE中颜色编辑起作用，例如工具栏中的前景色、背景色、边框颜色等。

缺省配色方案作用范围缺省为全部时，默认配色方案不仅对IDE编辑有效，也对统计图生效。当统计图没有设置配色方案，选项中设置了默认配色方案时，会使用默认配色方案作为统计图的配色方案。

 

Double.NaN的显示值

用于设置Double.NaN的缺省显示值。

 

“文件”标签页：

在选项配置窗口中切换到“文件”标签页，如下图所示：

 

报表样式配置

用于存储报表样式文件信息所在的位置，在样式文件中可设置多个报表样式，不同的报表可通过报表属性菜单设置不同样式，具体使用可参考其他小节的单元格样式名。

报表样式文件路径支持绝对路径和相对路径。在设计器中的相对路径是相对于[安装根目录]\report如：tmp/reportStyleConfig.xml；独立部署时该配置对应raqsoftConfig.xml中<Report/>里配置的styleConfig属性的路径，相对路径时是相对于应用根目录。

 

格子样式文件

用于存储单元格样式信息的文件所在的位置。

 

日志文件名称

用于存储设计器中日志信息的文件所在的位置。只能是绝对路径，若为空则不写日志。

 

应用资源路径

应用资源路径支持绝对路径和相对路径。使用相对路径时，路径前不需要加斜杠“/”。

在设计器中，相对路径是相对于[安装根目录]\report。例如，应用资源路径设置为reportFiles时，实际路径为：[安装根目录]\report\reportFiles。

独立部署时，该设置对应配置文件raqsofConfig.xml中<Report>里home属性的路径。例如，home属性的值为WEB-INF/reportFiles时，实际路径为：[应用根目录]\WEB-INF\reportFiles。

子报表、文件数据集的文件、报表组的报表源等使用相对路径时，相对于应用资源路径。

 

授权文件名称

润乾报表设计器的授权文件所在位置。可通过【设置】按钮查看当前授权。

如果要重新配置授权文件可以点击设置授权文件窗口【打开】按钮选择新授权文件。

 

报表模板路径

指保存到本地系统的报表模板样例文件路径，通过菜单文件 - 模板可以查看模板文件。

 

slimerjs安装目录

用于指定slimerjs安装目录所在的位置。该设置主要用于Echarts统计图的导出和打印。具体可参考《教程》导出与打印小节。

 

该选项信息所在配置文件名称

用于存储工具 - 选项中所有选项属性的配置文件名称。点击【查找目标】按钮可以定位到配置文件所在的位置。

 

“初始属性”标签页：

在选项配置窗口中切换到“初始属性”标签页，用于定义新建报表的报表属性、行列属性、格子属性等的默认值，如下图所示：

在格子属性中设置什么样的属性信息，那么把单元格变成初始格时就显示什么样的属性。

 

“JSP”标签页：

在选项配置窗口中切换到“JSP”标签页，用于定义JSP主目录所在的路径，JSP文件字符集，标签库文件名，标签库前缀等信息。如下图所示：

 

JSP主目录

用于设置存储JSP文件的主目录。

 

JSP文件字符集

用于设置JSP文件中使用的字符集。

 

标签库文件名

用于设置JSP文件中使用的标签库文件名。

 

标签库前缀

引用标签库时使用的标签库前缀。

在菜单中点击工具 - JSP编辑器，弹出JSP编辑器界面，在此界面中打开一个JSP文件进行编辑，点击【插入标签库】按钮就可插入一个我们这里定义的标签库文件名和前缀，如下图所示：

 

“集算器选项”标签页：

在选项配置窗口中切换到“集算器选项”标签页，用于定义集算器配置信息。如下图所示：

 

使用已安装的集算器配置

勾选“使用已安装的集算器配置”复选框，指定已安装的集算器目录，读取集算器的选项配置

 

寻址路径

指定网格程序中引用的一些文件相对的路径，可设置多个，用分号分隔。

 

主目录

相对路径文件和远程文件的根目录，集算器中未设置主目录时使用当前程序文件所在目录

 

临时目录

临时文件所在目录，相对于主目录。

 

初始化程序

指定一个spl文件，用于设计器启动时的初始化。

 

外部库目录

外部库文件所在的主目录，其子目录中放置润乾外部库核心jar和所需第三方依赖jar。具体使用文档可在乾学院中下载《外部库指南》。

 

自定义函数文件

编写实现某种特殊功能的自定义函数，通过自定义函数配置文件，登记注册以后就可以像系统函数一样直接在SPL脚本中使用。

自定义函数配置文件customFunction.properties，文件格式如下：

文件中每行表示一个函数定义，等号前面部分是函数名，函数名必须是系统里唯一的，不能与系统函数同名或其它自定义函数同名。等号后面分2部分，用逗号隔开。第1部分的值为0或1，0表示是普通函数，1表示是某对象的成员函数，例如字符串对象的函数s.len()。第2部分是自定义函数的完整Java类名。

更多关于自定义函数的介绍可参考【SPL：自定义函数】

 

日期格式、 时间格式 、日期时间格式

设置日期/时间数据的格式，单元格值中的日期/时间数据将按照此处设置的格式来显示。

 

缺省字符集

设置集算器缺省使用的字符编码，相关函数中字符集参数缺省为此处配置的字符集。

 

文件缓存区(字节)

设置读写文件时缓存区的大小

 

组表区块大小(字节)

设置组表区块的大小，组表存储是分块的，区块是组表数据维护时每次分配空间的基本单位，一般使用默认值即可。

 

缺失值(逗号分隔)

设置缺失值，以逗号分隔。从文本文件中导入数据的时候，有些字段里会有一些符号，含义是null，此时可用缺失值来定义这些符号。

 

最大并行数

设置集算器多线程计算时的最大并行数，当多线程函数中并行数参数省略时，会将此处设置的值作为缺省值。

 

多路游标缺省路数

设置多路游标缺省路数，当多路游标相关函数中路数参数省略时，会将此处设置的值作为缺省值。

   

每次从游标取的记录数

设置每次从游标取的记录数，游标计算相关的函数执行计算时会用到此处的值。