H9000(V4.0)_HReport安装使用说明

H9000 V4.0 计算机监控系统

HReport使用说明

中国水利水电科学研究院自动化研究所

监控事业部

北京中水科水电科技开发有限公司

2008年10月

H9000 V4.0计算机监控系统-HReport使用说明

声 明

本手册是为H9000 V4.0计算机监控系统上位机报表服务器安装、操作使用而编制的，适用的对象是本公司监控事业部员工，同时也供用户使用及维护H9000 V4.0计算机监控系统报表功能参考之用。使用者在使用手册过程中，发现任何不妥或有任何改进建议，可以向本公司监控事业部提出，以便进一步修改完善。

本手册会根据需要进行适当修改，恕不另行通知。

本手册的版权由北京中水科水电科技开发有限公司所有，任何人、任何组织不经书面授权，不得全部或部分地复制、拷贝本手册内容。

北京中水科水电科技开发有限公司

2008年10月

2 北京中水科水电科技开发有限公司

H9000 V4.0计算机监控系统-HReport使用说明

目 录

第1章 安装说明..........................................................................1 1.1 1.2

系统软件和硬件要求........................................................1 数据库客户端安装...........................................................1 1.2.1 Oracle安装准备..........................................................1 1.2.2 Oracle安装步骤..........................................................1 1.2.3 Oracle客户端配置.......................................................6 1.2.4 Oracle客户端安装已知问题........................................12 1.3

Office2003安装..............................................................12 1.3.1 安装准备...................................................................12 1.3.2 1.4

安装步骤................................................................12

HReport安装..................................................................12 1.4.1 安装准备...................................................................12 1.4.2

安装步骤................................................................12

1.5 其它问题.......................................................................16

第2章 介绍................................................................................17 2.1 2.2

运行环境.......................................................................17 功能介绍.......................................................................17

第3章 环境配置.........................................................................19 3.1

数据库配置....................................................................19 3.1.1 ODBC配置..................................................................19 3.1.2 HReport数据库设置...................................................26 3.2

周期定义.......................................................................28 3.2.1 周期类型....................................................................29 3.2.2 时段类型....................................................................29 3.2.3 操作及界面说明...........................................................30 3.3

其它设置.......................................................................33 3.3.1 日期时间格式定义........................................................34

3 北京中水科水电科技开发有限公司

H9000 V4.0计算机监控系统-HReport使用说明

3.3.2 样式定义....................................................................35 3.3.3 向导定义....................................................................36 3.4

帐号管理.......................................................................36

第4章 报表目录树管理.................................................................38 第5章 模板配置..........................................................................39 5.1

介绍.............................................................................39 5.1.1 变量...........................................................................39 5.1.2 周期...........................................................................40 5.2 5.3 5.4

创建报表模板.................................................................40 向导使用.......................................................................40 配置报表.......................................................................43 5.4.1 模板信息配置..............................................................44 5.4.2 变量配置....................................................................44

第6章 报表查询..........................................................................52 6.1 6.2 6.3 6.4

介绍.............................................................................52 表达式变量....................................................................52 SQL查询型变量..............................................................52 统计型变量....................................................................53

第7章 模板及配置导入/导出.........................................................54 7.1 7.2 7.3 7.4 7.5 7.6

全局配置导入/导出.......................................................54 报表目录导入/导出.......................................................55 数据库描述导入/导出...................................................55 单个模板的导入...........................................................55 单个模板的导出...........................................................55 全部配置及模板的导入/导出.........................................55

附录 56

一 函数列表及表达式语法规则.....................................................56

1. 2. 3.

语法规则......................................................................56 日期构成函数...............................................................56 日期运算函数...............................................................58

4 北京中水科水电科技开发有限公司

H9000 V4.0计算机监控系统-HReport使用说明

4. 5.

数学统计函数...............................................................59 文本函数......................................................................59

二 已知缺陷..............................................................................59 三 下一版本..............................................................................60

5 北京中水科水电科技开发有限公司

第1章 安装说明

第1章 安装说明

1.1 系统软件和硬件要求

󰂾 󰂾 󰂾 󰂾 󰂾 󰂋 󰂋 󰂋 󰂾 󰂾

操作系统： Windows 2000，Windows XP, Windows2003 处理器主频>=450MHz 硬盘剩余空间>=20M RAM>=M 数据库软件

兼容以下数据库产品： Oracle7及以上

SqlServer2000及以上

Access2000支持HReport的部分功能 Microsoft Excel2003

所选数据源的驱动程序（例如：OLEDB Driver for Oracle）

1.2 数据库客户端安装

以下以Oracle 3张CD的完整版本为例，介绍数据库客户端的安装。

1.2.1 Oracle安装准备

安装Oracle客户端需要Oracle提供的Windows客户端安装CD（1张），或者Oracle的完整安装CD（3张）。

安装前需要注意以下事项： i. 如果是硬盘拷贝版本，Oracle安装文件存放的路径中不能含有中文，例如：将

Oracle光盘拷贝到路径”D:\\工具\\”下，安装不会成功。

ii. 如果要安装客户端的管理员类型，包含企业管理器等系列工具，某些情况下使

用1张CD的版本可能不会成功。

iii. 某些情况下运行安装光盘根目录下的Setup.exe，可能没有响应，需要运行

autorun\\autorun.exe。

1.2.2 Oracle安装步骤

步骤1：运行安装程序

3张光盘版本执行Disk1\\Setup.exe，或者Disk1\\autorun\\Setup.exe；1张光盘版本执行Setup.exe，或者\\autorun\\autorun.exe。

1

北京中水科水电科技开发有限公司

第1章 安装说明

步骤2：单击下一步

步骤3：选择客户端安装路径，通常可使用默认路径，单击下一步

2 北京中水科水电科技开发有限公司

第1章 安装说明

步骤4：选择要安装的产品，如果是1张CD的客户端安装盘，这一页不会出现，在此选择第三项：Oracle9i Client，单击下一步。

步骤5：选择客户端的安装类型，如果是在管理员的主机上，需要进行系统维护，通常选择管理员类型，在普通客户端仅需要安装运行时类型，点击下一步

北京中水科水电科技开发有限公司

3

第1章 安装说明

步骤6：开始安装，点击安装。

步骤7：安装结束，由于HReport要使用到OLEDB for Oracle的数据库访问驱动，而Oracle客户端的运行时，不提供此驱动，所有需要再增加一项自定义安装，点击下一安装。

4 北京中水科水电科技开发有限公司

第1章 安装说明

步骤8：重复步骤2－5，在第5步界面中选择自定义类型，单击下一步：

步骤9：选择Oracle Windows Interface组件，单击下一步：

5 北京中水科水电科技开发有限公司

第1章 安装说明

步骤10：开始安装，单击安装

步骤11：安装成功，点击退出安装，安装程序会提示是否退出安装，选择是。在1张CD的版本中，会要求继续对客户端进行配置，可以选择不配置，而使用1.2.3的配置步骤。

1.2.3 Oracle客户端配置

步骤1：选择配置程序：所有程序－>Oracle-OraHome92－>Configuration and Migation Tools－>Net Configuration Assistant

6 北京中水科水电科技开发有限公司

第1章 安装说明

步骤2：选择本地Net服务名配置，单击下一步：

步骤3：选择添加，单击下一步：

7 北京中水科水电科技开发有限公司

第1章 安装说明

步骤4：选择Oracle版本为第一项，单击下一步：

步骤5：配置服务名（Oracle数据库名），在H9000系统中数据库名为hista，单击下一步：

8 北京中水科水电科技开发有限公司

第1章 安装说明

步骤6：选择网络协议为TCP，单击下一步：

步骤7：设置数据库服务器主机名和端口号，主机名通常使用主机IP地址，端口通常使用缺省端口1521，单击下一步：

9 北京中水科水电科技开发有限公司

第1章 安装说明

步骤8：对配置进行测试，选择是，进行测试单击下一步：

步骤9：配置程序将使用缺省的用户密码连接数据库进行测试，通常不会成功，配置程序提示错误，单击更改登录，使用hista的用户密码进行测试，如果配置正确，将提示测试成功，单击下一步：

10 北京中水科水电科技开发有限公司

第1章 安装说明

步骤10：Net服务名配置，这一服务名就是外部程序使用该配置的代号，在HReport中将显示，已配置服务名的列表，以供选择，通常也配置为hista，同一网络若有多台数据库服务器通常配为hista_A，hista_B…，单击下一步：

步骤11：配置完毕，如果还需配置其它服务名，选择是，单击下一步，配置程序将重复步骤2－10。选择否，系统将回到步骤2界面，选择完成。

11 北京中水科水电科技开发有限公司

第1章 安装说明

1.2.4 Oracle客户端安装已知问题

󰂾 在某些情况下，如果oracle客户端安装在一个NTFS卷上，由于oracle客户端的一个缺

陷，.Net访问数据库时会报错：“未在本地计算机上注册“OraOLEDB.Oracle”提供程序“。

解决方法为选择oracle的安装路径的根目录，点击文件－>属性，在弹出的属性窗口中选择安全页，在上方名称中选择Authenticated Users，在下方权限中去除读取和运行允许，点击确定。重复以上操作，在对Authenticated Users勾选读取和运行允许，点击确定即可。

1.3 Office2003安装 1.3.1 安装准备

1． 需要Office2003的安装盘

2． Office2003补丁包SP2(Office2003SP2-KB887616-FullFile-CHS.exe) HReport需要Office2003的版本号为11.5612.6568以上（在Office的帮助菜单->关于中可以查看），安装office2003 SP2后的版本是11.6560.6568

1.3.2 安装步骤

1． 卸载之前安装的Office。

2． 安装Office2003，由于HReport要得到Office中对.Net Framework的支持，在未安

装.Net之前（Windows XP及以后版本自带），缺省安装中不包含这些支持，所以最好选择完全安装。 3． 安装Office2003 SP2。

1.4 HReport安装 1.4.1 安装准备

1． 需要HReport的安装盘，包含Config.ini，dotnetfx.exe，HReportSetup.msi，langpack.exe，

mdac_typ.exe，settings.ini，Setup.exe七个文件

1.4.2 安装步骤

步骤1：执行HReport的安装文件setup.exe 步骤2：单击下一步：

12 北京中水科水电科技开发有限公司

第1章 安装说明

步骤3：如果主机未安装.Net Framework1.1及.Net Framework语言包，HReport将自动安装。

步骤4：组件选择，HReport主程序即查看、制作报表的主程序，通常均需要安装； HReport定时生成服务，在一个网络上只允许一台主机安装，以定时生成报表。

13 北京中水科水电科技开发有限公司

第1章 安装说明

步骤5：选择安装路径，通常使用默认路径

步骤6：确认安装，单击下一步：

14 北京中水科水电科技开发有限公司

第1章 安装说明

步骤6：HReport主程序安装结束后，要求配置数据库类型、访问数据库的用户密码，以及服务器信息，对于Oracle数据而言就是Net服务名，其它的为ODBC中的配置。配置完成后，可单击测试，如果配置正确将显示连接成功，单击下一步：

步骤7：安装结束，点击关闭。

如果用户选择了安装定时生成服务，系统将同时安装服务管理器HReportManager，在windows右下脚的系统托盘上将显示HReport的图标。

15 北京中水科水电科技开发有限公司

第1章 安装说明

1.5 其它问题

󰂾 系统不能使用大字体，否则HReport的显示将不正常。

设置方法：在桌面点击右键－>属性－>设置－>高级－>常规－>DPI设置，选正常尺寸（96DPI）

16 北京中水科水电科技开发有限公司

第2章 介绍

第2章 介绍

2.1 运行环境

HReport是一个基于自动化对象技术的Excel插件，利用这个插件，任何熟悉Excel和生产过程的用户经过短时间的培训，均可快速生成电厂的绝大部分生产报表，并对其进行方便有效的管理，查阅。

HReport操作的对象是H9000系统的历史数据库，经测试的数据库为Oracle和SQL Server，如果使用Access仅支持HReport的部分功能。

2.2 功能介绍

HReport的主要功能是报表模板制作、报表查询以及管理。分为8个模块：

用户管理、模板制作、数据库配置、数据查询、数据曲线、目录树管理、报表周期定义、报表样式管理。

在HReport成功安装加载后(参见H9000HReport安装说明)，如图所示在Excel的菜单栏上将出现一项：H9000报表，选择登录：

图 2-1 HReport菜单

弹出以下登录界面:

图 2-2 HReport登录

17 北京中水科水电科技开发有限公司

第2章 介绍

选择服务器名称，即DSN名称(参见2.1数据库配置)。输入用户和密码，系统初次搭建时，只用默认用户EMS，密码为空。

成功登录后，Excel中将出现一个新的工具栏(工具栏上各按钮状态因用户权限而异)。

H9000菜单也将加入相应内容如下图所示：

图 2-3 HReport菜单一览

工具栏如下图所示：

1 2 3 4 5 6 7 8

图2-4 HReport工具栏

由左向右依次是：1：注销、2：用户管理、3：模板制作、4：数据库配置、5：报表查询、6：曲线生成、7：报表目录树管理、8：报表选项、9：报表模板导入、10：保存模板、11：清除报表数据区域、12：用当前工作簿样式替代样式库、13：当前单元格样式。

9 10

1112

13

18 北京中水科水电科技开发有限公司

第3章 环境配置

第3章 环境配置

3.1 数据库配置

HReport的操作对象是H9000系统的历史数据库，首先需要对数据库的相关信息进行配置，数据库配置分2.1.1、2.1.2 两部分完成。

3.1.1 ODBC配置

3.1.1.1 Oracle

以Oracle9i为例,介绍Oracle数据源的配置过程： 1. 安装oracle客户端程序 2. 配置服务名

2.1如下图所示选择: 程序->oracle –oraHome92->Configuration and Migration Tools->Net Configuration Assistant

图 3-1 oracle数据源配置步骤一

19 北京中水科水电科技开发有限公司

第3章 环境配置

2.2下图中选择本地Net服务名配置。

图 3-2 oracle数据源配置步骤二

2.3下图中选择添加。

图 3-3 oracle数据源配置步骤三

20 北京中水科水电科技开发有限公司

第3章 环境配置

2.4下图中选择Oracle版本，本例中为Oracle8i或更高版本数据库或服务。

图 3-4 oracle数据源配置步骤四

2.5填写Oracle实例的全局标志符(SID)，本例中SID为HHDD，如不清楚请询问数据库管理员。

图 3-5 oracle数据源配置步骤五

21 北京中水科水电科技开发有限公司

第3章 环境配置

2.6选择通信协议，通常为TCP/IP

图 3-6 oracle数据源配置步骤六

2.7填写Oracle数据库服务器的主机地址或名称及与数据库服务器通信的端口号，通常在此填入服务器的IP 地址和使用标准端口1521。

图 3-7 oracle数据源配置步骤七

22 北京中水科水电科技开发有限公司

第3章 环境配置

2.8 接下来会测试配置是否正确，选择：是进行测试。

图 3-8 oracle数据源配置步骤八

2.9 由于未提供用户名及密码这时测试通常不会成功，系统提示不支持默认用户名特性，这时在下面窗口中，选择更改登录，填入正确的用户名及密码，如果提示连接成功，表明Oracle数据库的信息都已正确。

图 3-9 oracle数据源配置步骤九

23 北京中水科水电科技开发有限公司

第3章 环境配置

2.10接下来给正在配置的服务名取一个名字，这个名字在下边的ODBC配置中需要使用。本例中取服务名为HHDD_Oracle。

图 3-10 oracle数据源配置步骤十

3. ODBC配置

打开控制面板->管理工具->数据源 (ODBC)，使用ODBC数据源管理器添加DSN供HReport调用。

3.1添加ODBC数据源，在下图中选择添加。

图 3-11 oracle数据源ODBC配置步骤一

24 北京中水科水电科技开发有限公司

第3章 环境配置

3.2选择数据源驱动程序：Microsoft ODBC for Oracle(也可选择Oracle的自带驱动)，单击完成。

图 3-12 oracle数据源ODBC配置步骤二

3.3 在弹出的Microsoft ODBC for Oracle Setup窗口中填写：数据源名称(即DSN名称)和数据源服务器名称，即步骤2中创建的Oracle Net服务名。本例中DSN取名为HHDD_Oracle_Microsoft。

图 3-13 oracle数据源ODBC配置步骤三

通过这三个步骤Oracle的OBDC配置就完成了。

25 北京中水科水电科技开发有限公司

第3章 环境配置

3.1.1.2 SQL Server

对于SQL Server数据库仅需配置ODBC驱动，参见 1.1.1.1 oracle配置的第3步。

不同的是SQL Server数据源驱动程序为:SQL Server，服务器直接填写SQL Server数据库服务器的IP地址(如下图所示)。

图 3-14

Sql Server数据源ODBC配置

3.1.2 HReport数据库设置

在ODBC配置完成后需要在HReport中对数据库进行一些初始设置。 登录数据库后，选择数据库配置

弹出下图界面：

26 北京中水科水电科技开发有限公司

第3章 环境配置

图 3-15 HReport数据库配置

HReport数据库配置的主要目的是做到报表生成软件与数据库的相对性，在数据库结构未发生改变前，只需进行一次配置。在这一配置界面中用户可作五项设置。 1． 对象表及数据表定义

在HReport中将历史数据库分为对象表和数据表两类，通过对象表选择需要查询的生产数据点及获得数据点的一些静态信息，通过查询数据表获得生产数据。在H9000历史数据库中，对象表有数据点特性表、统计点表。数据表有：报警表、1分钟数据表、5分钟数据表、15分钟数据表、小时数据表、日数据表、月数据表、历史报警表、历史5分钟数据表、历史15分钟数据表、历史小时表。 2． 报表相关字段选择

在隐藏/显示字段列表框，可设置允许报表用户看到的字段，对象表的字段顺序可由旁边的上移、下移调整，这将影响到用户选择对象点的界面。 3． 各表及字段描述

在表描述文本框和字段描述文本框修改当前选中表或字段的描述，在报表制作用户看到的表和字段名将由这些描述替代。 4． 关键字段的定义

有一些字段是选择数据点或表现查询数据必须的，在这允许用户定义这些字段名称，目前需要定义的字段为：

数据点标志字段―唯一标志对象点的字段，数据点的这一字段值不能重复。

27 北京中水科水电科技开发有限公司

第3章 环境配置

描述字段――――数据点的描述，将影响到模板生产界面。 单位字段――――保留未用。

时标字段―――将影响到周期型报表的数据生成。 毫秒字段―――保留未用。

数据质量字段－将影响到数据的表现外观。 5． 每次查询返回的最大纪录数

当用户的查询条件设置过宽，例如：查询开始和结束时间范围过大，有可能返回海量数据导致服务器及客户机长时间失去响应或死机，所以有必要每次查询返回的最大纪录数，系统默认为2000条。

☺ tip：可通过上移、下移按钮调整对象表的字段显示顺序，这一顺序决定选择数据点时

看到的字段顺序。

3.2 周期定义

在制作周期型报表前必须要先定义报表使用到的周期，登录数据库后，在工具栏上选择选项按钮

弹出下图界面：

图 3-16 周期设置

28 北京中水科水电科技开发有限公司

第3章 环境配置

3.2.1 周期类型

在这里周期类型分为时段固定时间间隔周期和非固定时间间隔周期两类。

3.2.1.1 固定时间间隔周期

1． 固定时间间隔周期的时段按固定时间间隔排列，例如：日报属于固定时间间隔周期，

每个时段和上一时段间相差1小时。这类周期，对这类周期而言，只需要记录第一时段开始时间、时段的序号、时段的名称就获得了该周期自身的全部信息。

3.2.1.2 非固定时间间隔周期

非固定时间间隔周期，每一时段可设置开始结束时间，时间段可连续也可分散，对前后顺序也没有要求。

3.2.2 时段类型

3.2.2.1

普通时段

普通时段是设置了开始、结束时间的时段，对固定时间间隔周期而言只需要指定时段的序号，对非固定时间间隔周期就需要指定每一时段的开始结束时间，在设置开始结束时间时需要注意以下原则：

1． 每一时段结束时间大于开始时间，若结束时间小于开始时间，系统将自动在结束时间上加上一个本周期用到的最大时间单位的上一级单位。

例如：设定分时电量周期时第三个平段为22：00到00：00，该周期使用到的最大时间单位为时，则系统将该时段解释为当日22：00到00：00 加上1天即次日00：00。

3.2.2.2 累加时段

累加时段是普通时段的累加时段，例如：假设分时电量周期中高峰是时段一： 9:00-12:00 和时段二：19:00-22:00，则高峰时段是时段一和时段二的累加时段。

设置累加时段时需要选择是对每一时段的开始时刻值累加还是对每一时段的时段差值累加。

设置累加时段要注意以下原则：

1． 不能出现循环引用，即本时段不能是自己的累加成员

2． 累加时段不能作为其它时段的累加成员，这主要是为了降低检查循环引用的复

杂性，一般来说一级累加就能满足报表需求。

29 北京中水科水电科技开发有限公司

第3章 环境配置

3.2.3 操作及界面说明

3.2.3.1

周期信息

1． 周期名称：该周期的标志，不能重复。 2． 包含单位：

在该周期中区别不同时段的时间单位，包括年、月、周、星期几、日、时、分。例如：在日报中，靠时、分区别不同时段，所以包含单位中就只能选择时和分。一旦选择了时间单位后，在相关的时间设置控件上就只显示已包含的单位。

注意：如果包含了周或星期几单位，月、日将不可用，例如：假如用户需要做一类

每周的报表，时段为星期一到星期日。这时可选择时间单位仅包含星期几。如果需要指定每一时段是每年某一周的星期几的几点几分到另一周的星期几的几点几分，就需要指定包含单位有周、周几、时、分。

3． 固定间隔：选择周期类型是固定时间间隔或不是，参见3.2.1周期类型。

4． 样式：有的周期报表需要在报表的数据对应位置打印时段名称，在此选择改时段名

称使用的Excel样式，参见3.2.3.2时段信息

5． 周期开始时间：对固定时间间隔周期可用，表示周期的第一时段开始时间。 6． 是否关联数据表：

一般来说某一周期数据固定由某个数据表产生，例如：查询日报时，时段为每小时一个点，一般希望数据在整点数据表中产生。但用户也可在最终配置报表时灵活选择数据来源表。

关联了数据表的周期将作为一个报表类型在报表配置向导中出现。 7． 备选数据表：

对有的数据表，历史数据可能分为两部分存储，一部分为近期的数据，另一部分为长期的数据，在近期的数据表中查询可获得较快的速度，但超过一定时间，数据将转移到了长期表中，这时就可以将第一数据表关联到存储近期数据的数据表，而将备用数据表关联到存储长期数据的数据表，例如：H9000数据库中的历史5分钟、历史15分钟等数据表。选择备选数据表后，在报表查询时若在第一数据表中没有查到，则继续到备用数据表中查找。 8． 可按子周期生成记录：

有的周期报表，用户只想查询该周期下某一时段下按其它周期时段间隔生成的记录。例如：定义周期一，时段内容为全厂的倒班表，对周期一报表可查询某一时间范围内各值的运行记录，但有时需要查询一值按1小时生成的报表，这时就可定义

该周期可按子周期生成记录，子时段的时间间隔为日报的时间间隔。报表制作时指定仅查询子时段一值，查询时指定时间范围2005-4-19到2005-4-20，如果一值在该日的值班时间为8点到16点，查询系统将按日报时段配置，查找到该日8点到16点的记录按日报的格式生成报表。

9． 周期跨度：分为按时段计算、设置周期长度

对于固定间隔周期，可以选择两种之一，例如：对于月周期，时段间跨度为固定1天，但周期长度不固定，应设置跨度为1月。而日周期，每日都是24小时，可以不设置周期长度。

对于非固定间隔周期，必须选择设置周期长度。

30 北京中水科水电科技开发有限公司

第3章 环境配置

3.2.3.2 时段信息

1． 时段名称：

每个时段的名称，可以重复。有的报表要求将该时段的名称打印到对应数据的位置，例如：下图运行日志中，0:00-3:00即为时段名称。

图 3-17

带时段名称报表示例

2． 是否累加时段

某些时段可能是其它时段的累加值，例如：在分时电量周期中，高峰时段就是多个时段的累加。 3． 是否隐藏：

某些时段可能仅是其它时段的累加成员，无需在报表上体现，可以选择隐藏。 4． 时段开始、结束时间

每一时段的开始、结束时间。 5． 累加成员列表

如下图所示，在累加成员列表框内是所有成员的副本，在选择累加成员时有两个原则，违反这两个原则修改将不予接受。

1． 累加时段不能是自己的累加成员，否则出现循环引用。 累加成员列表 2． 累加时段不能是其它累加时段的累加成员，

图 3-18

累加时段配置

31 北京中水科水电科技开发有限公司

第3章 环境配置

3.2.3.3 操作说明

󰀚

这里介绍增加、修改一个周期的操作步骤：

增加周期

3.2.3.3.1

以日报为例介绍添加步骤：

图 3-19

周期操作－添加周期

在周期区域点击新建 输入周期名称：日报 选择包含单位：时、分

由于是固定间隔时间周期，需要填写开始时间为每天的0点0分 选择周期是固定时间间隔 选择周期时间间隔是1小时 选择时段名称样式

选择关联的数据表是整点数据表，字段是整点数据，也可以是每小时的最大、最小、平均值

9． 如果数据可能转存到一个长期表中还需关联备用数据表

10． 我们这里无需选择子时段。但如果日报中需要生成某一小时的报表，例如：

每天生成早8点报表，每15分钟一点，这就需要选中子时段，再创建一个新周期，间隔时间为15分钟，把这个周期关联到子时段上。 下面配置时段信息

1． 2． 3． 4． 5． 6． 7． 8．

图 3-20

周期操作－添加时段

32 北京中水科水电科技开发有限公司

第3章 环境配置

11． 填写第一个时段名称0:00

12． 该时段需要显示，非累加时段 13． 点击按钮添加。

在固定间隔周期中，完全依靠时段位置决定时段开始结束时间，时段序号为1，计算得到开始时间为00:00-01:00

14． 重复步骤11－13输入时段00:00－23:00

15． 创建一个累加时段，累加成员为1－24，填写时段名称累计 16． 该时段显示，累加时段，选中累加时段后累加成员列表框可用，选择时段00:00

到时段23:00。 17． 当需要在中间插入一个时段时，在时段列表中选择一个时段，修改时段名称

点击插入，将在选中时段之前插入一个时段

18． 在时段添加完后，需要将周期添加到配置中去，在图3.2.3.3.1中点击周期配

置中的添加按钮，周期列表中将出现一项日报

19． 这一过程结束后，该周期已进入当前配置，但配置文件还未保存，如果推出

配置界面，配置将丢失，所以及时选择保存。

☺ tip：在输入时段名后回车，相当于点击添加按钮

note: 修改一个时段需要三个步骤，1.在图3.2.3.3.2时段配置中选择增、删、改按钮 2. 图3.2.3.3.1周期配置中选择增或改按钮 3.选择保存。这样设计的原因是用户在修改当前周期的配置后，可以选择是将当前配置另存为一个新的周期或直接修改当前选择的周期，所以在修改时段配置时不宜直接修改当前选择周期的配置，而交给用户完成。 3.2.3.3.2

修改周期

1． 在图3.2.3.3.1中修改周期信息后，周期修改按钮可用，点击修改按钮，修改将进入

配置，但未保存，一旦推出配置界面，修改将丢失。如果修改后未点击修改按钮，当选择其它周期时，这些修改将丢失。

2． 在图3.2.3.3.2中修改时段信息后，时段修改按钮可用，点击修改按钮，修改将进入

当前时段配置，这时周期修改按钮可用，如果点击周期修改按钮，新的时段信息将加入当前配置，如果未点击周期修改按钮，一旦选择其它周期，当前修改内容将丢失。同样如果需要保存，需要点击保存按钮。

3． 另一个快捷保存修改信息的方法是，作出任何修改后，点击保存按钮，当前所有修改内

容无论是周期信息或时段信息，还有其它页面（样式配置、向导配置等）的修改内容都将保存到配置文件。

3.3 其它设置

在制作登录数据库后，在工具栏上选择选项按钮 将图3.2.1所示窗口，在其它各页上有HReport的一些其它设置，下面依次说明各部分功能及操作：

33 北京中水科水电科技开发有限公司

第3章 环境配置

3.3.1 日期时间格式定义

在图3.2.1点击页面2，将出现以下界面：

图 3-21

日期时间格式定义

在上图中可对报表中出现的日期型数据定义表现样式，可定义项目包括年、月、周、日、时、分、秒格式等。图中点击恢复默认值按钮可将所有日期、时间格式恢复系统默认样式。

34 北京中水科水电科技开发有限公司

第3章 环境配置

3.3.2 样式定义

在图3.2.1点击页面3，将出现以下界面：

图 3-22

样式及其它配置

在上图中样式配置框类是Excel工作簿的所有样式，用户在其中选取报表需要的样式，选取的样式HReport将保存在系统样式库中，每次创建新报表时，将从样式库导入所有样式。 用户如需创建或修改样式，可使用Excel的样式工具：在菜单栏上点击格式->样式，得到下图所示配置界面，进行修改或创建。

35 北京中水科水电科技开发有限公司

第3章 环境配置

图 3-23

Excel样式配置

3.3.3 向导定义

在图3.3.2.1 的向导配置框内用户可选择是否使用向导创建报表。

3.4 帐号管理

在HReport中用户权限分为四类：普通用户、报表模板管理员、数据库管理员、系统用户。用户界面根据用户权限而不同。

1. 普通用户

普通用户可用工具如下图所示：1：允许注销、2：管理自己的用户信息，修改密码，5：查询报表、6：生成曲线。

图 3-24

普通用户工具栏

2. 报表模板管理员

报表模板管理员除了只能管理自己用户信息外其它功能都能进行。

图 3-25

3. 数据库管理员

数据库管理员能完成所有功能。

图 3-26

点击按钮

数据库管理员工具栏 报表模板管理员工具栏

时将弹出下图界面，可对HReport的所有用户进行管理。

36

北京中水科水电科技开发有限公司

第3章 环境配置

图 3-27

4. 系统管理员

权限不受。

帐户管理

37 北京中水科水电科技开发有限公司

第4章 报表目录

树管理

第4章 报表目录树管理

登录数据库后，在工具栏上选择按钮

弹出下图界面：

列表框二 列表框一

图 4-1

报表目录树管理

在上图界面中，用户可创建自己的目录树，并对目录树和模板进行组织，管理。 在列表框1中列出已创建的所有报表模板及相关信息，用户可在此删除模板。 在列表框2中列出属于当前节点的报表模板，用户可通过添加、删除按钮或拖拽等方式增加或删除当前节点下的模板。

38 北京中水科水电科技开发有限公司

第5章 模板配置

第5章 模板配置

5.1 介绍

报表上的信息可划分为静态部分和动态部分，静态部分用户可借助Excel强大的编辑功能生成。而动态部分需要用户指定查询条件，访问数据库提取符合条件的数据生成，这就是HReport要完成的工作就是提供方便的手段，人性化的界面帮助用户设置这些查询条件。

在HReport中所有数据都关联到变量，以下就对变量的概念进行介绍：

5.1.1 变量

所谓变量就是一系列条件的总称，告知从哪读取数据，读取那些数据，放置到报表的哪些位置，以何种样式展示数据。在HReport中将变量类型也就是数据类型分为了三类： 1． 表达式型

表达式型变量，主要是为了满足用户设置数据查询的开始、结束时间而设置的。例如：一张报表上同时存在多个周期的数据，数据块1查询时间为本月，数据块2查询时间为去年同期。如果在查询时用界面指定查询时间，查询界面

的设计将非常繁琐，也不能适应多种多样的需求。而通过变量这个问题就很容易解决了，首先，设置变量1读取报表中某一单元格内容作为数据块1的起始时间，变量2＝变量1＋1个月作为数据块1的结束时间，变量3＝变量1－1年作为数据块2的起始时间，变量4＝变量3＋1个月作为数据块2的结束时间。

对于表达式类型变量，计算结果可用打印到某个单元格，也可以仅作为一个中间计算变量。 2． 数值查询型

数值查询型变量指可直接由数据库获得对象点在某些时间点的数值，经过筛选打印到报表上的一个记录集。这类变量还支持求时间点的数值差获得的时段数据（一般适用于数值随时间逐渐增长的对象点）。 3． 统计量型

这类数据在数据库中不存在直接结果，例如：统计机组今年的运行时间，数据库中存放的是机组每次开始运行以及结束的时间，要计算出运行时间是一个比较复杂的过程，HReport将这种复杂性和多样性交给外部过程管理。目前，这类计算是由存储过程实现的，用户只需定义存储过程需要输入的参数。对本例来说，用户需要创建一个统计型变量1，在统计型变量1中指定对象点即

XX机组运行这一点的唯一标志，再创建两个表达式型变量分别获得查询的开始结束时间，将这两个变量关联到统计型变量1。HReport在查询时从统计型变量1中提取三条信息传递给存储过程即可返回XX机组运行小时数。

39

北京中水科水电科技开发有限公司

󰀚

第5章 模板配置

变量又可分为全局变量和报表变量，全局变量就是创建之后，在所有报表中都可使用的变量，例如：如果报表查询的开始时间都是在A2单元格中，就可以创建一个全局变量转换A2单元格内容为查询时间，其它的查询变量就可以将开始时间参数设置为这个全局变量。报表变量就是只能在本报表中使用的变量。

5.1.2 周期

在配置报表时，还有一个重要的概念就是周期。通常需要的不是某一对象点在某一时间点的一个数据，而是在某一时间范围每隔若干时间的数据，这时就需要对这一查询变量关联一个3.2中设置的周期，以告知查询程序需要哪些时间点的数据。也可能是哪些时间段的数据，即周期每一时段结束时间数据减开始时间数据。

5.2 创建报表模板

登录数据库后，在工具栏上选择按钮

将开始配置报表模板：

5.3 向导使用

如果在选项界面选择了使用向导（参见3.3.3），在新建报表即当前工作表还未配置时，在工具栏上选择按钮 将弹出报表向导，报表向导共分为4个步骤。 第一步：选择报表类型

图 5-1 报表向导步骤1/1

在这一步骤中，用户定义了关联数据表的周期将作为一个报表类型出现，如果选择自定义，点击完成，将直接进入报表配置界面。

40 北京中水科水电科技开发有限公司

第5章 模板配置

用户选择了报表类型即周期类型后，需要选择数据类型和查询类型。

图 5-2 报表向导步骤1/2

选择了数据类型后，HReport将为该报表创建一个相应类型的变量，如上图对日志型变量需要设置数据查询类型即是选取每一时段边界点数据或时段差值。以日报为例，时段边界点数据即0点到23点的整点数据，时段差值即1点数据减0点数据，2点数据减1点数据…。 如下图对统计型数据需要设置统计类型，即运行小时数或动作次数。

图 5-3 报表向导步骤1/3

第二步：选择报表由哪个单元格获取查询时间，以及数据的放置位置。

41 北京中水科水电科技开发有限公司

第5章 模板配置

图 5-4 报表向导步骤2

第三步：选择数据点，在向导中没有提供手段让用户选择数据点来源，直接使用了缺省对象表，即日志型数据来自数据特性表，统计型数据来自统计点表。

图 5-5 报表向导步骤3

第四步：配置报表其它信息

42 北京中水科水电科技开发有限公司

第5章 模板配置

图 5-6 报表向导步骤4

如上图所示，在这一步可配置报表名称，数据使用的样式，小数点位数。对需要定时生成的报表需要配置第一次生成的时间。

在这四步完成后，将弹出报表配置界面可对上边配置的信息进行修改、调整。

5.4 配置报表

43 北京中水科水电科技开发有限公司

第5章 模板配置

新建报表完成向导步骤后将弹出配置界面，报表的各组成部分，在HReport中以变量的形式存在，创建变量的总体原则是：

1． 变量可以与单元格地址建立关联。建立了关联的变量结果将打印到该单元格。 2． 每个单元格只能关联一个变量，即不同变量的关联单元格不能相同。 3． 变量名可以省略，但不能相同。

下边以向导生成的日志型报表为例，按变量类型分别介绍

5.4.1 模板信息配置

当在模板管理器窗口点击模板时，属性窗口将显示对应模板的可配置信息。包括项目： 模板名称： 在模板目录中显示的名称，导出文件也以此名称组成文件名。 描述： 提供用户对该模板进行进一步详细描述，可以不填。

是否定时生成：配置该模板是否需要按固定周期定时生成，如果要定时生成需要配置定

时首次生成时间、生成周期单位和长度

周期长度： 设置定时生成周期长度 周期单位： 设置定时生成周期

首次生成时间：设置首次定时生成时间，以后每次的生成时间将根据周期间隔和首次生

成时间计算得出，所以应合理选择首次生成时间，一般选择主机较空闲时，并且要注意生成时间不能太晚，防止人工保存的报表被自动生成的覆盖。

输入开始时间：查询时是否需要选择查询开始时间，一般与时间有关系的报表，需要设

置该项为是，否则查询窗口的查询开始、结束时间将不可选。

输入结束时间：查询时是否需要选择查询结束时间，一般与周期有关系的报表，设置该

项为否，这时需要设置周期单位和长度，查询结束时间为查询开始时间加上该周期长度查询窗口的查询结束时间将不可选。

查询开始时间一般使用输入的开始时间，按周期设置去除比该周期单位小的部分，例如：周期单位为日，查询时间输入时将隐藏小时和分钟的部分，若输入20007年6月23日，查询开始时间就为2007-6-23 0:0:0。如果用户有特殊需求，就需要建立一个表达式变量，对开始时间进行运算获得正确的开始时间。

可选择的最大周期单位为小时。

如果周期单位为周，可以对周几进行选择。

5.4.2 变量配置

当在模板管理器窗口点击变量后，属性窗口将显示对应变量的可配置信息。包括项目根据变量类型而有所不同，下边依次介绍：

44 北京中水科水电科技开发有限公司

第5章 模板配置

5.4.2.1 共有部分

为该变量的唯一标志，在模板内不允许重复，应取一个尽量能描述该变量含义的名称

描述： 提供用户对该模板进行进一步详细描述，可以不填 关联单元格： 如果该变量的结果需要打印在报表上，需要在此指定关联的单元格地址，

格式为$行编号$列编号，例如：第一个单元格为$A$1。此地址可直接输入，也可以在Excel工作表上选取，方法为在该项获得输入焦点后（输入框底色将改变提示用户），在工作表中选择需要打印的单元格，该项内容将填写为选择单元格的地址。

样式： 选择该变量内容使用的Excel样式。

小数点位数： 选择该变量小数点位数，对于非数值型变量，将忽略该项。 禁止查询： 对暂时不想删除，又不需要打印结果的变量可以设置该项 填充方式： 填充方式分为插入和覆盖两类。对于插入方式，在设置的打印单元格所

在位置插入行写入查询结果。覆盖方式则直接写入设置的的打印单元格位置。

变量类型： 选择这一查询的类型，分为表达式、Sql查询、统计型三类变量，根据

变量类型的不同，配置界面也不同，以下将逐个介绍。

如上图所示，向导完成后生成了两个表达式型变量：手动查询开始时间，手动查询结束时间。在变量列表上选择手动查询开始时间可以查看该变量内容，该变量的值为Cdate($A$2)，其中Cdate为日期运算函数，$A$2为单元格地址，结果是将单元格A2的内容转换为日期。手动查询结束时间的表达式内容为：DateAdd('n',1440,L:手动查询开始时间)。DateAdd为日期运算函数（参见附录一函数列表），该表达式内容为求手动查询开始时间再加上1440分钟（即1天），其中L:手动查询开始时间为对报表变量手动查询开始时间的引用，L:标识是报表变量，G:标志是全局变量。 创建表达式变量步骤：

1． 首先输入变量名（如果该变量没有其它变量引用变量名也可省略） 2． 选择变量类型为表达式 3． 变量描述可以不填

4． 关联单元格：如果变量结果需要打印到报表中在这一栏填写单元格地址。 5． 样式：选择该变量结果打印的样式，如果未关联单元格此项设置不能用。

6． 小数点位数：如果需要对结果小数点进行控制，可在此设置，非数值类型，此项将

被忽略。

7． 选择需要的函数，用插入函数按钮将选中的函数加入表达式（也可直接输入），用

试算按钮检查表达式时候正确。

8． 使用添加按钮添加变量，该变量是报表变量还是全局变量则取决于当前选择的是变

量清单还是全局变量清单。在添加时如果同名或同关联单元格的内容已存在，将提示是否覆盖。

变量名称：

45 北京中水科水电科技开发有限公司

第5章 模板配置

5.4.2.2 表达式变量

图 5-7 表达式变量配置

46 北京中水科水电科技开发有限公司

第5章 模板配置

5.4.2.3 数值查询变量

图 5-8 数值查询变量配置

1． 时间范围:为系统预留功能，可以允许报表在自动生成时，查询开始、结束时间设

置与手动查询设置不同。目前，自动查询时与手动查询使用同样设置。

󰀹 在模板管理器中选择日志量一可以查看该变量内容，图中除去共有部分外可看

到如下几部分配置： 3．数据点列表

󰀹 在数据点列表可看到这个查询变量选取了三个数据点，这三个点的查询结果将

依次由B12,C12,D12单元格开始排列。可使用添加数据点将在数据点一览表中选中的点加入到列表框，也可在数据点标志文本框直接输入数据点名。可使用

47 北京中水科水电科技开发有限公司

第5章 模板配置

图中按字段筛选功能筛选数据点。 4．时间范围

󰀹 使用查询时间范围

󰀹 开始时间为报表变量手动查询开始时间，结束时间为报表变量手动查询结束时间。 5．周期选项

󰀹 使用周期，数据按时段生成，周期类型为时报 6．高级周期设置

󰀹 查询全部时段，不使用子时段（参见：5.2.2.4使用子时段和分时统计） 󰀹 由于在周期定义中“日报”不使用子周期，所有“使用子周期”选项不可用 󰀹 该周期时段间隔时间为1小时

󰀹 查询类型为查询时段边界点数值，另一类型为查询时段差值，如果选择查询时段差

值每一时段的查询结果为时段结束时刻的数值减去开始时刻的数值。 󰀹 打印时段结束时刻记录

对固定时间间隔的周期而言，将打印周期最后一个时段的结束时刻的记录，例如：日报将打印第二日0点的记录。

对非固定时间间隔的周期，每一时段都将打印开始时刻和结束时刻的记录。 如果选择的查询类型为查询时段差值该项不可用。 注意：对时刻值进行累加的“累加时段”，不对结束时刻数值累加。 󰀹 仅统计分时段累加值

如果选择该项，查询将只统计选择查询的各时段在查询时间范围内分时段差值的累加值。例如：统计值报中各值（也可选择若干值）在本年度的总发电量，可使用该项。

󰀹 需要打印时段名称，即00:00—23:00。

󰀹 年月日选项设置在时段名称中是否附加查询时刻（时段）的年月日。

󰀹 子时段名称选项设置在按子周期查询时，时段名称中是否附加子时段名称。例如：

在一值值报中按日报时间间隔生成时段名称将使用日报时段名称即00:00—23:00，如果选择该项打印的时段名称为一值00:00-一值23:00。 󰀹 由单元格A4开始打印时段名称

48 北京中水科水电科技开发有限公司

第5章 模板配置

5.4.2.4 统计型查询变量

选择统计类型

图 5-9 统计型变量配置

统计型查询变量与数值型查询变量的配置基本相同，不同处在以下几点： 󰀹 用户需要选择是统计运行小时数，还是动作次数，对于运行小时数需要设置单

位。

󰀹 统计点固定由统计点描述表中选取。注意：在统计点描述表中有一个字段为是

否统计，只有该字段为1的点才有统计数据。 󰀹 添加字段，删除字段按钮和字段列表不可用 󰀹 打印时段结束时刻记录不可用

49 北京中水科水电科技开发有限公司

第5章 模板配置

5.4.2.5 使用子时段和分时统计

图 5-10 使用子时段和分时统计

如上图所示可以对周期中使用子时段、子周期和分时统计选项进行配置。 1． 查询子时段

如果用户选择只查询子时段，就可在列表框中选择一个时段，例如：用户只需要打印每天早8点的记录，就可以使用这一特性。

注意：这里的子时段仅按时段名称查询，时段名称相同的则认为是同一时段。例如：在值报中，如果选择了一值报表，则每次一值值班的数据将列入查询范围。 2．按子周期查询

如果选中的周期定义了使用子时段(见3.2.3.1周期信息)，则按子周期生成查询记录复选框可用，如果选择了该选项，间隔时间将变为周期定义中配置的子周期的间隔时间，这一功能与查询子时段结合比较有用。例如：需要查询一值每小时的值班日志，在图中选择周期为值报，查询子时段，选择仅查询一值记录，选择按子周期生成查询记录。由于周期值报定义为可使用子周期，子周期为日报（参见3.2.3.1）则在一值内将使用日报的时段间隔，即每小时产生一条记录。 2. 统计分时段累加值

如果选中仅统计分时段累加值，系统将打印该周期的每一时段在开始到结束时间范围类分时段累加值，而不打印每一时段的数值。例如：需要统计本年度分时电量的累加值，选择该项后，将对一年的峰、平、谷电量进行统计，而不是打印每天的分时电量。 当选中分时段累加时，“按子周期生成查询记录”、打印时段结束时刻记录、时段名称中的年月日、子时段名称将不可用。

50 北京中水科水电科技开发有限公司

第5章 模板配置

5.4.2.6 报表信息

图 5-11 报表信息

在页面1可设置报表的相关信息：

󰀹 名称(不能超过50个字符或25个汉字) 󰀹 描述(不能超过100个字符或50个汉字) 󰀹 是否定时生成

󰀹 如果需要定时生成，需要设置定时生成的周期以及第一次生成的时间，以及设

置定时生成时开始时间变量以及结束时间变量。

5.4.2.7 保存报表

使用保存按钮可以保存全部报表变量和全局变量，如果是新创建的报表或使用另存为按钮，将弹出报表目录树管理界面，提示用户是要保存到目录的哪个节点下，也可保存到根节点下，日后在整理。

在系统保存报表模板前，将清除Excel工作表中填充数据的区域，如果变量选择了打印时段名，时段名称也将被清除。

51 北京中水科水电科技开发有限公司

第6章 报表查询

第6章 报表查询

6.1 介绍

报表查询是以变量为单位的，对每一变量如果关联了单元格，系统将根据该变量类型，计算或访问数据库获得结果，这个结果可能是一个单纯的字符串、一个数值或一个结果集（二维数据块），例如：在数值查询变量中选择了三个数据点按周期生成，结果就是一个占三列的结果集。

如果在配置变量时，有需要从工作表中获得的输入条件，在查询前需要在工作表的相应位置填入正确的内容。例如：在查询日报时，日志变量一的开始时间为表达式：cdate($A$2) 即将$A$2单元格内容转换为查询开始时间，这就需要在$A$2单元格填入能转换为日期类型的内容，例如：2005-5-9或2005年5月9日等。如果内容不正确，在查询时系统将提示用户填写。

在正确填写各变量的输入条件后，按工具栏上的按钮

进行查询。

6.2 表达式变量

表达式变量在关联单元格后系统将计算该表达式的结果，打印在关联的单元格内。目前，表达式变量多用于给其它类型变量提供查询条件，但随系统函数库的增强，这一类型变量用于显示统计、运算结果将得到更多的运用。

6.3 SQL查询型变量

系统在做一个周期查询时，可采用的方法有两种：

2. 如果周期中时段是按时间正序排列，可将开始时间到结束时间的所有数据取

回，再按每一时段开始值在结果集顺序中筛选。这样做的有两个优点： 󰁺 可以尽可能少的访问数据服务器以减轻数据库服务器的负担。

󰁺 数据表中时间字段有可能是现场带来的时标，不一定会准确等于时段时

间，在取回结果集后，在和时段比较时仅比较该周期包含的时间单位，例如：在日报中包含单位为时、分。若取回两条纪录，时标分别为2005-4-6 12:00:10和2005-4-6 12:00:59，在与日报的第12个时段12:00—13:00的开始时间做比较时第一条记录认为相等，于是进入下一时段13:00－14:00的筛选。

采取这样的策略导致一个问题，在用户随意选择数据来源表时有可能取回的数据量太大超过系统设定的一次返回纪录数，后边时段的数据就无法得到。例如：在配置年报是若选择数据来源表为：小时表，一年数据就将取回约8760条纪录，若最大返回纪录为2000条，年报时间间隔为一个月，那么就只能得到1月1日，2月1日，3月1日三个数据，并且增加系统筛选、比较负担。所以用户在选择数据来源表时必须谨慎。

52 北京中水科水电科技开发有限公司

第6章 报表查询

2． 按各时段的开始、结束时间依次在数据库中查询（对于固定间隔周期结束时间

等于下一时段的开始时间，所以只需查询时段开始时间记录），在查询开始时间到结束时间之间有n个时段就需要访问2n次（或n次）数据库。缺点是需要多次访问数据库，并且数据库中的记录时标必须精确等于时段开始（结束）时间，优点是每次取回的记录数只有一条，在查询时段较少而时间跨度大时比较有优势。对于非固定时间间隔周期而言，时段不一定按时间正序顺序排列，也需要使用这一策略。

下图为本系统中采用的折中策略：

n周期固定时间间隔yy查询开始时间至结束时间的记录数<最大记录n周期固定时间间隔ny取回开始时间至结束时间的所有记录依次寻找记录集中等于各时段开始时间的记录查询每一时段结束时间的记录查询每一时段开始时间的记录结束 图 6-1 周期查询策略

6.4 统计型变量

对于统计型变量，每一次求值系统要访问一次数据库，例如：如果查询一年的年报，需要求数据点A， 1月，2月……12月 12个时段的运行小时数，系统将分别用每月的开始、结束时间作为输入变量访问数据库求解，即需要访问数据库12次；再举个例子，同样是年报如果查询时间是2004年1月1日到2005年7月1日，系统将产生12＋6条记录，6月份没有数据将显示0。

另外，需要注意的是正如5.2.2.3中提到的在统计点描述表中有一个字段“是否统计”，只有该字段为1的点才有统计数据。如果用户设置了该字段为0的统计点，系统将报错。

53 北京中水科水电科技开发有限公司

第7章 模板及配

置导入/导出

第7章 模板及配置导入/导出

出于对模板和配置备份和在有安全隔离装置的内相互拷贝的需求，HReport设计了导入/导出工具。另外，在HReport的安装路径下，文件HReport.xml为系统的本地环境配置文件。

登录数据库后，在工具栏上选择选项按钮 导出界面。

，选择第三页将得到下图导入/

图 7-1 导入/导出工具

7.1 全局配置导入/导出

在图6.1的第一栏中可将全局文件导入/导出，在将全局文件导入时，用户必须谨慎，这些配置参数为HReport必须参数，如果导入了错误的参数文件，HReport将不能正常工作，HReport在导入时需要用户确认。

54 北京中水科水电科技开发有限公司

第7章 模板及配

置导入/导出

7.2 报表目录导入/导出

在图6.1的第二栏中可将报表目录树导入/导出。

7.3 数据库描述导入/导出

在图6.1的第三栏中可将数据库中各表及各字段的描述导入/导出。

7.4 单个模板的导入

登录数据库后，在工具栏上选择选项按钮 工作簿中。

可以导入一个报表模板到Excel

7.5 单个模板的导出

在模板的配置界面（图5.2.1）上，按钮导出将当前模板导出到本地文件。

7.6 全部配置及模板的导入/导出

在图6.1的第四栏中可将6.1.1-6.1.3的配置及所有的模板文件导入/导出。点击导出按钮，HReport将提示用户选择导出路径，确认后，在选定的路径下将用默认的文件名导出配置文件：全局配置：“globalParamFile.xml“；报表目录树：“reportTree.xml“；数据库描述：“databaseDescription.xml“；报表模板将使用“模板ID.XML“和“模板ID.xls“作为文件名。

点击导入按钮，将提示用户选择导入路径，确认后，在选定的路径下HReport将对所有文件依次扫描，辨认文件类型，若符合则导入，在该路径下最好不要放多余的文件，以免系统导入错误的配置文件。对报表模板而言，每个模板必须由两个文件组成，一个XML文件，一个同名但后缀为XLS的Excel工作簿。

在该页状态栏将显示导入/导出结果以及导入中发生的错误。

55 北京中水科水电科技开发有限公司

附录

附录

一 函数列表及表达式语法规则 1. 语法规则

1.1. 数据类型

1.1.1 字符串 1.1.2 日期 1.1.3 数值 1.2. 函数语法

函数调用语法为：函数名(参数1，参数2，…，参数n)，函数名不分大小写，参数用逗号分隔。参数可为1.1中的数据类型或变量名或内容符合1.1数据类型的单元格地址，目前系统仅支持表达式型变量。 1.3. 变量作为函数参数引用规则

函数的参数可以是一个表达式型变量，变量包括全局变量和报表变量，再引用变量时需要在变量名前使用标志符区别是全局变量还是报表变量，全局变量的标志符是G:, 报表变量的标志符是L:。若不带变量标志符则作为字符串处理。 1.4. 单元格地址作为函数参数引用规则

󰁺 单元格引用的语法为$单元格列号$单元格行号，其中单元格列号用A，B…ZZ表

示，行号用1…65536表示，与Excel中的单元格地址表示方法相同。 󰁺 单元格中的内容能转换为1.1中的数据类型 1.5. 保留字

L: G: $

2. 日期构成函数

2.1. NOW()

描述：返回当前系统时间

语法：NOW()

2.2. YEAR()

描述：返回给定日期的年份, 返回值为 1900 到 9999 之间的整数

语法：YEAR(serial_number)

serial_number为可转换为时间的字符串或变量名，serial_number为空返回当前系统时间的年份。

示例：YEAR(\"1998/7/5\") 等于 1998 2.3. MONTH()

北京中水科水电科技开发有限公司

56

附录

描述：返回给定日期的月份，月份是介于 1（一月）和 12（十二月）之间的整数 语法：MONTH (serial_number)

serial_number为可转换为时间的字符串或变量名，serial_number为空返回当前系统时间的月份。

示例：MONTH(\"2004/04/01\") 等于 4 2.4. WEEK()

描述：返回给定日期的星期编号，星期编号是介于 1和 52之间的整数,星期编号与周几作为一星期的第一天有关。

语法：MONTH (serial_number)

serial_number为可转换为时间的字符串或变量名，serial_number为空返回当前系统时间的星期编号。

示例：WEEK(\"2005/01/14\") 等于 3 2.5. DAY

描述：日期转换为月份中的日，用整数 1 到 31 表示。

语法：DAY (serial_number)

serial_number为可转换为时间的字符串或变量名，serial_number为空返回当前系统时间的日。

示例：DAY(\"2005/01/14\") 等于 14 2.6. HOUR

描述：日期转换为小时值，用整数 0 到 23 表示。

语法：HOUR (serial_number)

serial_number为可转换为时间的字符串或变量名，serial_number为空返回当前系统时间的小时值。

示例：HOUR (\"2005/01/14 12:10:0\") 等于 12 2.7. MINUTE

描述：日期转换为分钟值，用整数 0 到 59 表示。

语法：MINUTE (serial_number)

serial_number为可转换为时间的字符串或变量名，serial_number为空返回当前系统时间的分钟值。

示例：MINUTE (\"2005/01/14 12:10:12\") 等于 10 2.8. TIMESERIAL

描述：返回给定参数组成的日期。

语法：TIMESERIAL (year，month，day，hour，minute，second)

57 北京中水科水电科技开发有限公司

附录

year： 可以省略；整数；年份，为空使用系统时间的年份。 month：可以省略；整数；月份，为空＝1。 day： 可以省略；整数；日，为空＝1。 hour： 可以省略；整数；小时，为空＝0。 minute：可以省略；整数；分，为空＝0。 second：可以省略；整数；秒，为空＝0。

示例：TIMESERIAL (2004,12) 等于 2004年12月1日0点0分0秒

3. 日期运算函数

2.1 CDATE

描述：将字符串转换为日期值。 语法：CDATE (serial_number)

serial_number为可转换为时间的字符串或变量名或单元格地址。参数必须。 示例：CDATE (2004年1月2日) 等于 2004-1-2 0:0:0

CDATE($A$1) 若单元格$A$1中的内容为2004-1-2 12:00:00则结果等于2004-1-2 12:0:0

2.2 DATEADD

描述：返回一个加上一段时间间隔的日期 语法：DateAdd(interval, number, date)

interval: 必须；字符串；时间间隔类型, 有如下设置值：

设置 yyyy q m y d w h n s

描述 年 季 月 一年的日数 日 周 时 分钟 秒

Number：必须；数值表达式；是要加上的时间间隔的数目。 Date：必须；日期表达式；是要加上时间间隔的日期。

58 北京中水科水电科技开发有限公司

附录

示例：在某一报表中单元格$A$2的内容为2005年1月3日,设置变量:”查询开始时间”= Cdate($A$2)＝2005-1-3 0:0:0。

为了设置查询当天的记录，设置另一个变量:”当日查询结束时间”=DateAdd('d',1,L:查询开始时间)＝2005-1-4 0:0:0。即求查询开始时间再加上1天，其中L:手动查询开始时间为对报表变量手动查询开始时间的引用，L:标识是报表变量，G:标志是全局变量。

在同一张报表中还需要1月的所有记录，设置另一个变量: ”当月查询开始时间”,这个变量要取出单元格$A$1中填写日期月份的第一天，需要用Year 和Month函数取出查询开始时间的月份和年份即YEAR(L:查询开始时间),MONTH(L:查询开始时间)，变量的完整内容为TimeSerial(YEAR(L:查询开始时间),MONTH(L:查询开始时间))＝2005-1-1 0:0:0。

同样需要设置查询结束时间，设置另一个变量: ”当月查询开始时间”= DateAdd('m',1,L: 当月查询开始时间)＝2005-2-1 0:0:0

4. 数学统计函数

3.1 SUM() 描述：返回 参数：

3.2 AVERAGE() 描述：返回 参数：

3.3 ABS() 描述：返回 参数：

5. 文本函数 二 已知缺陷

1． 在一些偶然情况下，当前状态（例如：用户的登录信息）将丢失，这时系统将提示

\"数据库连接丢失,请重新登录!\"，需要用户再次登录数据库。

2． 系统需要的一些动态链接库，例如：XML解析器需要特定版本，系统安装时XML

解析器将替代当前主机上的版本。如果之后用户由于安装其它软件等原因用其它版本替换了要求版本后，HReport工作将不正常，甚至导致Excel不能打开，这时只有重新安装HReport或删除该插件。

59 北京中水科水电科技开发有限公司

附录

三 下一版本

1． 下一版本将移植到微软的.Net平台上，Excel插件以动态链接库的形式存在，插件

体积大幅减小，引导更快，在6.1中列出的缺陷将逐步解决。

2． HReport的变量功能将大大增强，变量可利用函数对查询结果集进行处理，变量的

参数可使用周期定义中的信息，期望用户自定义函数也将在新版本中实现。 3． 将增加常用筛选功能。

4． 将增加查询方法自定义功能，届时，计算运行小时数，运行时间将成为自定义查询

中的一种，用户通过自定义功能与数据库的存储过程(函数)关联，再自定义配置传递参数的界面，数据库中的所有信息都可以通过友好的方式加入报表，例如：列举每天的不合格电量时段等等。

5． 对事件列表的表现形式将大大丰富，按用户的设定，不同级别的事件将呈现不同的

外观，查询时可指定不同的查询条件等。

60 北京中水科水电科技开发有限公司