扩展报表控制台——提供给报表开发者的利器

        扩展报表控制台是扩展报表提供给报表开发者的利器，在报表开发人员在开发调试模板中经常会用到。

       点击管理平台“工具 -> 扩展报表控制台”，或者在扩展报表设计器中点击菜单栏“工具 -> 控制台”，可打开金蝶扩展报表控制台，如下图所示。

       在扩展报表控制台中，您可进行复制日志、垃圾收集操作，也可查看内存耗用情况以及报表计算情况。下面介绍控制台的几个重要功能：

1、 查看报表模板的二进制读取器版本

每个报表模板都有自己的二进制版本号，对于导出到本地目录的报表模板（后缀名是.kds），可以通过记事本打开，如下图所示，记事本中红线框住的版本号即为该模板的二进制版本号。

       将报表模板从本地目录导入到报表管理平台时，若该报表模板的二进制版本号高于报表管理平台中报表模板的版本号（这个版本号即扩展报表控制台中的二进制读取器版本），则该模板无法导入，系统会弹出如下信息提示：

       因此，在开发报表时要先了解当前EAS环境中报表模板的二进制版本号。否则，可能会遇到以下情形：

（1）在EAS测试库（报表模板的二进制版本较高）上开发了报表之后，想要导入到EAS正式库（报表模板的二进制版本较低）中时，系统会弹出窗口提示无法导入。

（2）EAS测试服务器和EAS正式服务器同时连了正式库，但EAS正式库的中报表模板的二进制版本比较低，测试库的中报表模板的二进制版本比较高。此时登录测试服务器的客户端进入报表管理平台后，若编辑打开报表并进行了保存操作（这会导致模板的二进制版本号变大），那么在登录正式服务器的客户端进入报表管理平台后则无法编辑打开该报表。若登录测试服务器的客户端进入报表管理平台后仅仅编辑打开报表或查看报表（没有执行保存操作），则在登录正式服务器的客户端进入报表管理平台后仍然可以编辑打开报表。

2、收集报表的执行日志信息

       日志级别分为5种：致命级、错误级、警告级、信息级、调试级。其中，“致命级”和“错误级”是输出非常严重的报错日志，“警告级”输出执行报表时的错误或警告信息，“信息级”则是输出所有报错信息，“调试级”是指在信息级输出的日志基础上，增加输出一些系统信息日志以及SQL执行的更加详细的日志，用于报表开发人员在开发调试模板中使用。默认的日志级别是调试级。

以“订单明细”报表为例，该报表的数据集查询语句、参数、报表模板如下图所示：

       首先打开控制台，然后执行报表（参数name的值为“王”），可以看到收集到的日志主要包括：

（1）报表参数以及系统内置参数的值、显示值；

       定制参数即为报表参数，包括参数值（本例中为“name”）、参数的显示值（本例中为“name_text”）；内置参数为扩展报表提供的系统内置参数，如当前人员ID、当前组织名称等。

（2）由扩展报表引擎解析的当前执行SQL语句、输出字段名称和类型

       在扩展报表控制台中，显示由扩展报表引擎解析的SQL语句级字段信息，如下图所示。

（3）耗费时间（扩展报表引擎、数据源查询 、计算