南自中文报表工具说明书.doc

中文报表工具用户手册 - 1 - 中文报表工具 用 户 手 册 南京国电南自凌伊电力自动化有限公司南京国电南自凌伊电力自动化有限公司 2005 年年 2 月月 *本说明书可能会被修改，请注意最新版本资料 中文报表工具用户手册 - 2 - 目目 录录 第一部分第一部分 前言前言4 4 1.1 阅读对象 4 1.2 文档不涉及的内容 4 1.3 敬告事项 4 第二部分第二部分 术语术语5 5 第三部分第三部分 系统需求系统需求6 6 3.1 硬件需求：6 3.2 软件需求：6 第四部分第四部分 程序功能与组织结构程序功能与组织结构7 7 4.1 功能需求与程序的关系 7 4.1.1 报表系统设置.7 4.1.2 报表管理.7 4.1.3 帮助.8 4.2 功能模块 8 4.2.1 数据服务.9 4.2.2 数据连接.9 4.2.34.2.3 报表管理器9 4.2.44.2.4 报表设计器.10 4.2.5 自动打印与维护.10 4.3 文件的组织 .11 4.3.1 程序文件11 4.3.2 用户报表模板.11 4.3.3 报表历史打印记录11 第五部分第五部分 报表的设计报表的设计1313 5.1 报表的设计过程 .13 5.2 报表管理器 .13 5.3 新建报表 .16 5.4 报表数据、格式的设置 .17 5.5 报表查看 .19 第六部分第六部分 报表的打印报表的打印2222 6.1 任务打印的建立与维护.22 6.1.16.1.1 建立一个任务23 6.1.2 任务的维护.24 第七部分第七部分 报表的维护报表的维护2525 7.1 报表的更改与删除.25 7.1.1 报表的更改.25 7.1.2 报表的删除.26 中文报表工具用户手册 - 3 - 7.2 历史报表的维护.26 7.2.17.2.1 超期历史报表的删除.26 7.2.2 备份与恢复.27 第八部分第八部分 结束语结束语2828 中文报表工具用户手册 - 4 - 第一部分第一部分 前言前言 此文档作为我公司lypro 系统软件用户手册的一部分提供给用户。 它涵盖了“中文报表工具”软件使用和维护的基本信息。从“系统功能” 、 “程序组织” 、 “报表定义和设计” 、 “报表的打印” 、 “日常维护”等方面进行 了阐述，这些信息也是用户能够正确、高效地使用该工具软件进行工作所必 须了解和掌握的。 1.1阅读对象阅读对象 一般用户：报表设计和维护者。 此类用户应已掌握了 windows 和 excel 的基本操作方法。 高级用户：二次开发者。 （一般由我公司程序员担任） 此类用户应已掌握了 windows 和 excel 的基本操作方法，以 及基于 vba、delphi、odbc、rdo、ado 的开发技术和数据库、 sql 的相关知识。 1.2 文档不涉及的内容文档不涉及的内容 无论“一般用户”或“高级用户” ，我们都假设他已掌握了 windows 和 excel 的基本操作方法。因此，此文档并不涉及 windows、excel 的 使用，用户如需要可参考相关书籍。 针对特定用户之特殊需求而开发的功能，其使用方法不包括在此文 档中，用户参考具体操作手册。 1.3 敬告事项敬告事项 如您发现此文档内容与“中文报表工具”软件相异，以“中文报表工 具”软件为准。 中文报表工具用户手册 - 5 - 第二部分第二部分 术语术语 scada 监控与数据采集。 odbc 开放式数据库连接（open database connectivity） 。微软公司提 供的“通用数据库接口”解决方案。 rdo 远程数据对象（remote data object） 。对 odbc 进行了“面向对象” 的封装。 ole 对象连接和嵌入（object linking and embedding） 。 ole db 基于 ole 技术的“通用数据库接口” 。 ado活动数据对象（activex data object） 。对 ole db 进行了“面向对 象”的封装。 vbavisual basic for appliction 微软 office 软件内建的程序语言， 用于对应用程序进行功能扩展。它可从微软公司获得，单独安装 使用。 bde宝兰数据库引擎（borland database engine） 。宝兰国际（现更名 为 inprise）公司提供的“通用数据库接口”解决方案。 oracle甲骨文公司开发的关系数据库系统。 sql结构化查询语言（structured query language） 。 中文报表工具用户手册 - 6 - 第三部分第三部分 系统需求系统需求 3.1 硬件需求：硬件需求： ibm pc 及其兼容机。 cpu： inter pentium 族系 amd k6,k7族系、cyrix mii。 （程序已在pii、piii、k6-ii、k7-dulon上通过测试） ram：64m（更多的内存有助于提高程序性能） 。 硬盘：100m（包括“报表工具”及其支持软件） 。 用户如需保留已生成的报表，则需额外的磁盘空间：356m。 （一张报表约占 100k 磁盘空间，假设每天出 10 张报表，所有报表需保 存 1 年，则需磁盘空间100k10 张365 天1 年=356m） 3.2 软件需求：软件需求： windows2000；（程序已在 windows nt 4.0 server、windows2000 上 通过测试） ；ms excel 2000；sql server 或 oracle 客户端程序（7.3.4 及以上版本） 。 中文报表工具用户手册 - 7 - 第四部分第四部分 程序功能与组织结构程序功能与组织结构 “中文报表工具”是 scada 系统的一个功能模块。用以从“历史数据库” 中析取相关数据，并依据用户需求对数据进行组织与处理，将其结果按指定 格式，以报表形式输出。 下面从“功能模块”和“文件组织” ，两个方面加以阐述。 4.1 功能需求与程序的关系功能需求与程序的关系 4.1.1 报表系统设置 功能名称功能名称实现模块实现模块 启动工程manager.dpr 主界面unmyform、myform.dfm 启动画面unface.pas、face.dfm 数据库连接undm.pas、dm1.dfm 用户管理缺省 密码更改缺省 4.1.2 报表管理 功能名称功能名称实现模块实现模块 新建报表newrpt.pas.pas、newrptform.dfm 报表属性设置editrpt.pas、editrptform.dfm 报表设计无单独对应模块，启动 excel 编辑当前报表 删除报表无单独对应模块，一个过程即可实现 清除全部过期报表清除全部过期报表无单独对应模块，一个函数即可实现无单独对应模块，一个函数即可实现 清除当前过期报表清除当前过期报表无单独对应模块，一个函数即可实现无单独对应模块，一个函数即可实现 编辑历史报表编辑历史报表无单独对应模块，一个函数即可实现无单独对应模块，一个函数即可实现 新建任务unfrmcasereport.pas、frmcasereport.dfm 编辑任务从 tfrmcasereportdfm 派生出 tmpfrm.dfm 窗体 删除任务无单独对应模块，一个过程即可实现 清除全部过期报表清除全部过期报表无单独对应模块，一个函数即可实现无单独对应模块，一个函数即可实现 清除当前过期报表清除当前过期报表无单独对应模块，一个函数即可实现无单独对应模块，一个函数即可实现 编辑历史报表编辑历史报表无单独对应模块，一个函数即可实现无单独对应模块，一个函数即可实现 报表模板设置报表模板设置loadtemplete.pas、loadtempleteform.dfm 报表打印等待报表打印等待frmwait.pas、printwait.dfm 文件定义文件定义include.pas 机组查询机组查询machinesearch.pas、machinesearchfrm.dfm 中文报表工具用户手册 - 8 - 季节查询季节查询search.pas、searchfrm.dfm 4.1.3 帮助 功能名称功能名称实现模块实现模块 关于about.pas、aboutform.dfm 帮助缺省 4.2 功能模块功能模块 “中文报表工具”主要由“数据服务” 、 “数据连接” 、 “报表管理器” 、 “报表设计器” 、 “自动打印及维护”模块构成。各部分的关系如下图所示 中文报表工具用户手册 - 9 - 4.2.1 数据服务 “数据服务”的主要功能是为其他应用程序提供数据。它做为 scada 系统的一 个功能模块历史数据子系统，运行在主服务器结点上。它可定时将遥测、遥 信数据写入数据库中，并能对这些数据进行运算（最大值、最小值、平均值、 自定义公式） ，保存运算结果。在本系统中，数据库采用的是sql server， 这也是在“关键数据服务”应用中，广泛采用的数据库平台。严格的说， “数据 服务”不属于“报表工具”系统中的功能模块。在此将其纳入的目的只是保持 文档的“连续性” ，便于用户的理解。 提示：提示：在“报表工具”运行的过程中，如果出现“数据库连接错误” ， “连接超 时”等错误消息框时，用户应首先检查“报表工作站”到主服务器结点的网络 路径是否正常；如无异常，再检查主服务器结点上 sql server 是否运行正常。 一般，问题都可以得到解决。 4.2.2 数据连接 “数据连接”的主要功能是： . 将应用程序传来的“数据查询”转换为 sql server 识别的查询语 言后，传递给 sql server，获取符合条件的历史数据。 .将获取的数据进行“本地”化（时区转化、时间格式转化、数据格式 转化） 。 .将“本地”化后的数据进行“用户”化（即根据用户预先定义的报表 模板设置向 excel 传送数据） 。 该模块对于一般用户来说是透明的，您可以完全忽略它的存在。也 可以把它理解为用户和系统之间交互的“代理人” 。 4.2.34.2.3 报表管理器 “报表管理器”是用户使用最频繁的模块。它的主要功能是： 定义报表属性（报表类型、数据时间、是否保存） 。 创建、管理用户报表模板。 中文报表工具用户手册 - 10 - 维护历史打印报表（调阅、打印、删除） 。 设置自动打印任务。 召唤打印。 4.2.44.2.4 报表设计器 “报表设计器”是个嵌入到 excel 中的“寄生”程序，使用 vba 开 发。它的“人机界面”采用 excel 的界面。用户在此处将进行报表的详细 设计（依据系统报表模板）： 指定需要哪些遥测或遥信值。 对这些值进行运算、统计，生成相应的图（表） 。 定义报表打印的格式。 程序将“分析”用户的这些设置（设计） ，并将“分析”的结果保 存为此报表的模板文件（用户报表模板） ，成为以后生成该报表的母板。 提示：提示：出于方便用户对报表模板进行功能扩充的需要，我没有对模板中的程 序代码加入“数字签名” 。这样做的好处是用户可自由的编辑、添加代码，但 同时会导致新安装的 execl 在第一次运行时，误报此程序“可能包含病毒” 。 此时，用户可以在 execl 中选择菜单“工具宏安全” ，在弹出的对话框中， 将“安全级”设为“无” ，此后运行就不会出现该错误信息。 4.2.5 自动打印与维护 该模块是以单独的应用程序实现的。用户可用它完成报表的定时自动 打印（支持脱机打印）以及超过保存周期的历史报表的删除。也可暂时停 止“自动打印”或“维护”的执行。 中文报表工具用户手册 - 11 - 4.3 文件的组织文件的组织 这里只从“一般用户”的角度阐述“中文报表工具”程序的文件组织。 程序安装完毕后（假设安装在 d 盘） ，会生成如下目录结构： d: 报表程序manager.exe runattime.exe report_sys 用户报表 报表历史打印记录 4.3.1 程序文件 报表管理器 d:报表程序manager.exe 自动打印与维护 d:报表程序runattime.exe 4.3.2 用户报表模板 所有的用户自定义的报表模板都存放在目录“d:用户报表”下。 如用户建立了报表“报表 01” 、 “报表 02” 、 “报表 03” ，则目录如下： d:用户报表报表 01.xls 报表 02.xls 报表 03.xls 4.3.3 报表历史打印记录 所有的历史报表打印存放在目录“d:报表历史打印记录”下。且 每个报表生成一个子目录。 在上例中，当用户创建三个报表的同时，程序会在目录“d: 报表历史 打印记录”下自动生成如下的子目录： d: 报表历史打印记录报表 01 中文报表工具用户手册 - 12 - 报表 02 报表 03 以后当生成历史打印报表时候，会将其做为历史报表存入对应的子目 录中。 中文报表工具用户手册 - 13 - 第五部分第五部分 报表的设计报表的设计 本章将介绍设计报表的过程，同时说明软件的操作方法。 5.1 报表的设计过程报表的设计过程 一张报表的设计过程可分为：新建报表、设置报表属性、报表的详细 设计、测试、保存（如图 5.1 所示） 。 中文报表工具用户手册 - 14 - 5.2 报表管理器报表管理器 图 5.2：“报表管理器”的主窗口： 说明：图 5.2 显示了三个区域：报表分类、用户报表、报表历史打印记录。 1. 报表分类 该区域列出按报表时间段频率的分类：日报表、周报表、月报表、年报 表、报表任意时段查询、季节查询、机组运行状况查询。 当用户选择一个分类时， “用户报表模板”区域将只列出该类型的报表。 2. 用户报表 该区域用于显示所有用户已定义的报表模板，并包含了“报表名称” 、 “类型” 、 “数据时间范围” 、 “报表文件名称” 、 “报表历史打印存放位置” 、 “历史报表保存周期”信息。如果用户选择了一个报表打印，则与之对应的 历史打印报表将在“历史报表打印记录” 区域显示出来。 用户报表 区域 报表历史打印记录 显示区域 报表 分类 中文报表工具用户手册 - 15 - 3.报表历史打印记录 该区域用于显示当前报表的所有历史报表信息，包括“历史报表打印文 件名” 、 “数据时间” 、 “更新时间” 、 “该历史打印报表保存的天数” 、 “该历史打 印记录报表删除的日期” 。如果，一张历史报表超过了它的“保存周期”且仍未 删除，它将以灰色显示。 图 5.3：“报表管理器”的打印任务窗口： 说明：图 5.3 是“任务打印管理”页面。它分为“打印任务” 、 “任务报表”二 个区域。 1. 打印任务区域 该区域显示了所有用户定义的任务（任务名称、执行时间） 。 “任务”是 能够自动打印执行的最小单位，一个“任务”可包括一张或多张报表。当用 任务中的任务中的 报表报表 打印打印 任务任务 中文报表工具用户手册 - 16 - 户在该区域选择一个打印任务时，在“任务报表” 区域显示了该“任务”所 包含的报表。 2. 任务报表区域 该区域显示了一个“任务”所包含的报表的名称、类型、自动打印状态。 5.3 新建报表新建报表 在“报表管理器”的主菜单上选择“报表管理新建报表” ，或在工具 菜单上选择“新建报表” ，此时就会出现的“新建报表”对话框窗口（如图 5.4 所示） 。 图 5.4： 5.4 新建报表 中文报表工具用户手册 - 17 - 说明： 报表的名称在所有的报表中必须唯一。 报表类型包括：日报表、周报表、月报表、年报表、报表时间段查 询、报表季节查询，机组运行查询等。 报表的排列属性取决与模板具有的特性，有横向和纵向属性。 查询方式：分厂站和设备的类型进行选择。 点击“设备”列框中的设备，在“测点”列表框中显示该设备所有 的测点，选中需要建立的测点进行报表组建。 对“选择变量”的列表框中所选择的内容可以进行“删除” 、 “清空” 、 “上移” 、 “下移”操作。 选择“保存历史报表打印记录”框，在脱机打印状态下，将打印输 出保存到文件中，其后的输入框中输入历史报表打印记录欲保存的天数 （最长可保存 99999 天） 。 如果选择了“启动 excel”选择框，则按“确定”后，将自动载入 excel，转入“报表格式”设计阶段。当然，也可以后加载 excel 进行 设计。 5.4 报表数据、格式的设置报表数据、格式的设置 这部分工作在 excel 中进行。如果 excel 尚未加载，用户可在“用户报 表”区域先选择待设计的报表，在窗口主菜单中选择“报表管理设计报 表”或在“用户报表”区域单击鼠标右键，在弹出的菜单中选择“设计报 表” ，之后，程序将加载 excel，并调入相应的报表。 1、报表页面：（如图 5.5 图） 中文报表工具用户手册 - 18 - 5.5 数据显示页面 2、数据页面：（如图 5.6 所示） 打印输打印输 出区域出区域 引用引用“数据数据” 页面的页面的 “g10”单单 元元 中文报表工具用户手册 - 19 - 5.6 数据设计页面 “报表设计器”分为二个部分：数据页面、报表页面。 、数据页面（图 5.5） 该页面主要分为三个区域：点名输入、数据返回、命令 “点名输入”区域是用户输入点名的地方，此区域从“c3”单元开始至 “p3”单元结束。每个点名占一个单元(cell)，从左至右依次输入。程序 将依照这些点名从历史数据库取得相应的数据，因此用户应保证输入的点 名已在历史数据库中定义。否则。返回的数据将为空值。 “数据返回”区域是用来存放历史数据库返回数据的地方。数据由程序 自动填写，无须用户干预。 “命令”区域有二个命令按键： 按键“生成 sql 语句”主要提供给程序员进行二次开发使用，一般用 户无须了解。 按键“刷新数据”用来依据报表当前设置，从历史数据库提取数据， 并填写到报表中。用户可使用该命令来测试报表的设计。 2、报表页面（图 5.6） 命令命令 区域区域 点名输入点名输入 区域区域 数据返数据返 回区域回区域 中文报表工具用户手册 - 20 - 此页面用来打印输出的。用户在此完成“打印格式”的设计。其使用方 法完全与 excel 一致。所要注意的是，此处的数据引用自“数据页面”的 相关单元（关于在 excel 中进行“数据引用”的方法，请参考 excel 的相 关书籍） 。用户也可以在此定义公式，进行计算统计。 用户在完成了报表属性、格式设计后，可选择“刷新数据”命令进行测试。 如果用户觉得满意后，就可以保存退出 excel。注意，存盘时请不要更改文件 的路径和名称。 5.5 报表查看报表查看 1、日报表、周报表、月报表、年报表查询 选择查看日期，默认为当天，如图 5.51 所示： 5.51 日期选择图 2、时段报表查询 选择查看日期，如图 5.52 所示： 5.52 日期选择图 3、季节查询 选择查看对象，双击鼠标后，弹出季节查询日期参数对话框，如图 5.53 所示： 中文报表工具用户手册 - 21 - 5.53 日期选择图 4、机组运行时间查询 选择查看对象，双击鼠标后，弹出机组查询参数对话框，如图 5.54 所示： 5.54 参数选择图 5、模板加载 点击模板按钮，弹出如下对话框，填写好已经建立的模板名称等信息。 中文报表工具用户手册 - 22 - 增加增加：添加模板的设置，点击后在文本框和下拉框中填写或选择需要的内容。 删除删除：选中添加的模板记录，点击该按钮及可完成删除操作。 取消取消：结束其次的操作。 保存保存：将添加的模板记录添加到数据库中。 修改修改：选中需要修改的模板，在框中做相应的处理。 关闭关闭：退出模板的加载窗口。 上一条上一条：移动光标到当前记录的上一条。 下一条下一条：移动光标到当前记录的下一条。 第一条第一条：移动光标到第一条记录 最后一条最后一条：移动光标到最后一条记录。 中文报表工具用户手册 - 23 - 第六部分第六部分 报表的打印报表的打印 报表工具的打印功能可分为三大类： ）按一次出报表的数量可分为：单一（一次出张报表）与任务（一次 可出张或多张报表）打印。 ）按打印的方式可分为：召唤与自动打印。 ）按打印的输出形式可分为：脱机与连机打印。 它们之间的联系如图 6.1 所示。 从图 6.1 我们可以看出：） “召唤打印”在“打印管理器”中进行，而 “自动打印”则由“自动打印进程”操作；） “召唤打印”可进行单一或任 务打印，而“自动打印”只能进行任务打印；）无论单一或任务打印都可 选择输出至打印机（连机打印）或磁盘（脱机打印） 。两者的切换可在“报表 管理器”菜单“打印”“脱机打印”进行。缺省的选项是“脱机打印” 。 6.1 任务打印的建立与维护任务打印的建立与维护 “任务打印”是指一个打印命令可制一张或多张报表。 “任务打印”的 核心是“任务” ，它是“任务打印”的最小执行单元。建立“任务”的概 念主要是方便用户对报表进行分类管理（如，按自动打印的时间段，按报 表中数据的性质电压、功率等分类建立“任务” ） ，以及提高“自动打印” 进程的执行效率（可靠的多线程执行） 。 “任务”的建立和管理工作是在 “报表管理器”的“任务管理”页面进行的（参见图 5.3） 。 图 6.1 中文报表工具用户手册 - 24 - 6.1.1 建立一个任务 选择“报表管理器”菜单“任务设置”“新建任务” ，出现如图 6.2 的窗 口。 中文报表工具用户手册 - 25 - 图 6.2 说明： (1) 每个“任务”都有一个唯一的名称。 (2) “报表侯选区”是当前尚未加入“任务”中的报表。用户向加入某张 报表时，可以用鼠标选中它后，单击“”按键，该报表就移入“报表 选中”区内。也可以一次移入多张报表，方法是在“报表侯选区”选 中多张，单击“”按键。如果想从“任务”中去掉某（几）张报表， 可在“报表选中”区内选中某（几）张报表后，单击“编辑任务”后，将出 现“编辑任务”窗口，它的使用方法与“新建任务”类似，这里不再累述。 若想删除一个任务，则先选择它，选择菜单“任务设置”“删除任务” 即可。 第七部分第七部分 报表的维护报表的维护 这章主要讨论报表日常维护。包括“报表的更改与删除” 、 “历史报表的维护” 。 7.1 报表的更改与删除报表的更改与删除 7.1.1 报表的更改 “报表的更改”指的是用户报表模板属性和打印格式的更改。 属性的更改 i）在“用户报表模板”区域选择欲更改的报表； ii）选择菜单“报表管理”“报表属性设置” ，出现“报表属性设 中文报表工具用户手册 - 27 - 置”窗口（如图 7.1 所示） ，也可在选择报表同时，单击鼠标右键，在弹出的 菜单选择“报表设置” 。 图 7.1 此窗口除了“报表类型”不能更改外，其余与“新建报表”窗 口使用方法完全一样，用户可参见“5.3 定义报表的属性” 。 打印格式的更改 这部分工作是在 excel 中进行的。 i）