润乾报表使用手册

1、精品报表使用手册XX 股份有限公司中国 济南目录1 概述 - 4 -2 安装 - 4 -2.1 准备好安装程序 - 4 -2.2 安装中的选项 - 4 -2.3 授权文件配置 - 5 -3 报表制作 - 6 -3.1 报表制作要求 - 6 -3.2 制作一张报表的步骤 - 6 -3.3 启动报表设计器 - 7 -3.4 连接数据源 - 8 -3.4.1 数据源对话框 - 8 -3.4.2 编辑数据源 - 8 -3.4.3 注意事项 -.10 -3.5 设计报表格式 -.11 -3.5.1 格式设计 -.11 -3.5.2 需注意事项 -.12 -3.6 定义参数 -.12 -3.6.1 参数的

2、编辑 -.12 -3.6.2 常用参数举例 -.13 -3.7 定义宏 -.13 -3.7.1 宏的编辑 -.13 -3.7.2 常用宏举例 -.14 -3.8 建立数据集 -.14 -3.8.1 数据集的编辑 -.14 -3.8.2 常用数据集举例 -. 15 -3.9 设置单元格属性 -.17 -3.9.1 数据集在单元格中应用 -. 17 -3.9.2 显示格式 -.18 -3.9.3 设置预警条件 -.18 -3.9.4 增加动态背景色 -. 19 -3.9.5 按参数隐藏列 -.19 -3.9.6 主格应用 -.20 -3.10 报表预览 -.20 -3.11 报表发布 -.21 -

3、4 报表部署 -.22 -4.1 部署位置 -.22 -4.2 Web 中显示 -.22 -5 重要概念 -.23 -5.1 数据源 -.23 -5.2 数据集 -.23 -5.3 参数 -.24 -5.4 宏定义 -.25 -5.5 单元格 -.26 -5.6 主格 -.26 -6 常用函数 -.28 -6.1 数据集函数 -.28 -6.1.1 select() -.28 -6.1.2 select1() -.29 -6.1.3 count() -.29 -6.2 单元格函数 -.29 -6.2.1 if() -.29 -6.2.2 row() -.29 -6.2.3 value() -.

4、30 -6.3 字符串函数 -.30 -6.3.1 pos() - 30 -6.3.2 mid() -.30 -6.4 数据类型转换函数 -. 30 -6.4.1 dateTime() -.30 -6.4.2 str() -. 31 -welcome1 概述该文档主要满足iES-E200电量采集系统中自定义报表制作编写。2 安装2.1 准备好安装程序2.2 安装中的选项点击安装程序，安装过程中会出现一下选择界面，请注意选择;2.3 授权文件配置启动报表设计器（启动方式参加3.2 ），点击“系统/数据源”菜单，弹出窗口如下图所示:3 报表制 作使用自定义报表的一个显著特点需要显示的对象具有某一项

5、相同的属性， 若没有相同属 性可以人工设置相同属性；方法一：对对象进行编码设置 （可以利用母线、 变压器编码信息进行人工设置相同属性） 方法二：可以将对象添加到其他电量公式中；3.1 报 表 制 作 要 求? 支持非自然日查询；? 支持非自然月查询；? 支持表码异常提示；? 日、多日、月报表通用；? 表码小数位数显示为 4 位；3.2 制作一张报 表的步 骤3.3 启动报表设计器启动报表设计器的方式有三种方法：方法一：在安装目录（比如默认的安装目录：C:ProgramFilesreportHomebi n）寻找startup.bat的程序文件，双击运行即可；方法二：从程序组中选择：开始- 程序

6、- 润乾报表- 润乾报表设计器方法三：安装完润乾报表之后，在桌面上会出现润乾报表设计器的快捷方式，双击即可。润乾报表设计器的主界面，如下图所示:an / U1霹蓦m3.4 连接数据源3.4.1 数据源对话框点击“配置/数据源”菜单，进入以下对话框:g敷据薄原綢仇IW床连接 原统lioilhwind 未理接 jdb朋CCEI 己压接3.4.2 编辑数据源如果有已编辑好的数据源，点击“连接”按钮。如果没有已编辑好的数据源，点击“新建”按钮，增加一个数据源，数据源的编辑界面如下：选择“关系型数据库”，点击“确定”按钮，进入下面的页面:在这里，我们将数据源名称命名为jdbc/RCCEEl，数据库类型选

7、择 ORACLE，客户端 字符集选择GBK，数据字符集选择 GBK，驱动程序选择 oracle.jdbc.driver.OracleDriver , 数据源URL为jdbc:oracle:thin: 数据库IP:1521:db，用户为XXX,密码为？?？，点击“确 定”按钮，建立此数据源.至此，数据源建立完毕，点击“配置一数据源”，选中要连接的数据源，点击“连接”按钮，连接词数据源。3.4.3 注意事项需要和tomcat连接池配置一致:漏眉格翟_查走边帮助叫 - Def-amt set o* monitored resources -(WatchedResourceVEB-lHF/ueb.xn

8、luii perlbtriite rirrobs Tunedt resldrts - !L_匸4如临f maKldle-Str1HBXlfait-l*50e(r73.5 设计报表格式3.5.1 格式设计方法一：新建报表新建报表并根据客户需求设计报表格式包含标题、报表头、数据区，如下图:AafOH 1K曳住实测裁MT瞰門心+年料西tMlEth广月.址trDay日弊计表-九刪，晒功电呈10k 前1lid Jh电湮1 Select 5处k40 seLrit liflF-f, 1甘A电R討4MC.B 応J|IU .r h 电a -WC5+2Sfta07n1w m a方法二：导入Excel文件点击“文件

9、/打开”菜单，弹出窗口如下图所示:选择客户提供的报表，点击打开。方法三：根据现有报表修改打开现有的报表文件，修改该文件使其符合客户要求；3.5.2 需注意事项? 边框设置? 对齐设置（字符左对齐，数字右对齐，标题、序号居中）?隐藏不显示的单元格（行属性和单元格属性向冲突时行属性优先）? 删除没有用到的单元格3.6 定义参数3.6.1 参数的编辑点击“配置/参数”菜单，弹出窗口如下图所示:可以对参数进行添加、修改、删除等操作；参数的值是从网页传递过来，此处参数名称应和网页一致；362常用参数举例st: starttime 简拼表示报表显示数据的开始时间，目前用秒数表示；et: endtime简拼

10、表示报表显示数据的结束时间，目前用秒数表示；substaid : substationid简拼表示变电站 ID;strhour :非自然日的开始时间的分钟数，8:00表示为：480 ；strdatetype :报表的时间类型，1为日报表，2为月报表，3为多日；lst: laststarttime简拼表示报表显示数据的开始时间的去年同期时间，目前用秒数表示；let : lastendtime简拼表示报表显示数据的结束时间的去年同期时间，目前用秒数表示;yearsecs :表示报表显示数据的开始时间的年初时间，目前用秒数表示；lyearsecs :表示报表显示数据的开始时间的上一年的年初时间，目前

11、用秒数表示；3.7定义宏3.7.1 宏的编辑点击“配置/宏”菜单，弹出窗口如下图所示:可以对宏进行添加、修改、删除等操作；宏的赋值可以使用具体的数字、参数或者表达式；3.7.2 常用宏举例1、对参数进行处理的宏;表示开始时间的年份。;表示开始时间的月份。;表示结束时间的年份。;表示结束时间的月份。startyear= mid(str(dateTime(st*1000),0,4) en dyear= mid(str(dateTime(et*1000),0,4) start mon th= mid(str(dateTime(st*1000),5,7) en dmo nth= mid(str(dat

12、eTime(et*1000),5,7)2、在数据集中进行替换的宏3.8 建立数据集3.8.1 数据集的编辑点击“配置/数据集”菜单，弹出窗口如下图所示:可以对数据集进行添加、删除、修改等操作；常见数据集包括描述信息和历史数据数据描述信息数据集：计量点数据集、母线数据集、主变数据集、线路数据集、CT数据集等;历史数据数据集：表码数据集、电量数据集等;382常用数据集举例母线供电量开关数据集：select a.id as id,,a.parts_id as cparts_id, b.parts_type,b.parts_id asparts_id,c. name as switch_

13、name,b.start_date,b.e nd_date,c.voltage_level asvoltage_level,b.parts_para as parts_para,b.cal_sign as cal_sign,d.voltage_levelasgvoltage_levelfrom calc_desc a,calc_para b,switch c ,ge neratrix dwhere a.id=b.calc_id and a.parts_type=9and a.parts_id =d.id anda.parts_para=0 and c.id=b.parts_idand d.su

14、bstation_id=$substaidand (b.start_date=$starttime)or(b.start_date=$endtime)CT 数据集：select mp_id,run_date,coef from ct where run_date=$starttimeand mp_id in(select b.parts_id as parts_idfrom calc_desc a,calc_para b,switch c ,generatrix dwhere a.id=b.calc_id and a.parts_type=9母线公式中的计量点and a.parts_id =d

15、.id and c.id=b.parts_idand d.substation_id=$substaidand(/ 公式时效判断(b.start_date=$starttime) or(b.start_date=$endtime) order by run_date desc电量数据集：SELECT mp_id,power_type,sum(total_value) as total_value from(andandasselect mp_id, mod(power_type,10)+10 as power_type,sum(total_value) total_value from精品mp

16、_day_e$year WHERE datetime=$starttime and datetime$endtimeandpower_type0広n*fcirff4-15QDi馴脚Jrta匚二| 炳*0毎讨*hhQ选中第四行，设置第四行的背景色表达式为:if(row()%2=0,-3342337,-1) 该表达式意思是当行数为偶数行时背景色显示为浅蓝色，当行数为奇数行时背景色显示为白色3.9.5按参数隐藏列在报表参数中，传入某个数值后，将某一列或几列隐藏，例如当报表日期大于 2009年1月1日，则隐藏几列，可以选择该列，在右边的属性中，找到“是否可见”，在表达式中填写if(reportdate

17、20090101,false,true)，即可按照输入参数隐藏列。3.9.6 主格应用主要说明在同一张报表中有几个同一类型数据区(如在一张报表中分别显示该变电站能所有母线的计算分量的详细信息)；可以根据实际情况分别对多条母线分别设置单元格属性， 更方便的是采用人工干预主格的方式实现；以下图为例说明：1. 首先在A16单元格中设置需要显示的母线的ID;2. 在17行到27行完成一条母线的各类数据的赋值；3.从17行到27行设置左主格为 A16;3.10报表预览报表预览主要用于验证报表是否正确，点击工具栏中的预览图标,弹出参数赋值对话框，根据实际情况对各个参数赋值后，点击“确定”按钮；如果预览 界

18、面正常，说明我们报表建立成功welcome3.11报表发布参见报表部署4 报表部 署4.1 部 署 位 置目前在下放置一些常见的报表模板部署时可以根据实际情况进行删减；目录结构-dayreport/ 放置日报表模板-company/ 放置不需要选择厂站的日报表模板-substation/放置需要选择厂站的日报表模板-monthreport/ 放置月报表模板-company/ 放置需要选择厂站的月报表模板-substation/放置需要选择厂站的月报表模板4.2 Web 中 显 示在 web 菜单“数据浏览”项中的“应用日报表”对应自定义日报表的显示、 “应用月报表”对应自定义月报表的显示；5

19、重要概 念5.1 数 据 源顾名思义， 数据的来源。 在数据源中存储了所有建立数据库连接的信息。 就象通过指定 文件名你可以在文件系统中找到文件一样， 通过提供正确的数据源名称， 你可以找到相应的 数据库连接。数据源标准属性包括：1 、 databaseName String数据库名称，即数据库的 SID 。2 、 dataSourceName String数据源接口实现类的名称。3 、 description String 对数据源的描述。4 、 networkProtocol String和服务器通讯使用的网络协议名。5 、 password String 用户登录密码。6 、 portN

20、umber 数据库服务器使用的端口。7 、 serverName String数据库服务器名称。8 、 user String 用户登录名。如果数据是水， 数据库就是水库， 数据源就是连接水库的管道， 终端用户看到的数据集 是管道里流出来的水。5.2 数据 集数据集是包含数据表的对象，可以在这些数据表中临时存储数据以便在应用程序中使用。 如果应用程序要求使用数据， 则可以将该数据加载到数据集中， 数据集在本地内存中为 应用程序提供了待用数据的缓存。 即使应用程序从数据库断开连接， 也可以使用数据集中的 数据。 数据集维护有关其数据的更改的信息， 因此可以跟踪数据更新， 并在应用程序重新连接时将

21、更新发送回数据库。5.3 参数在我们设计一张报表的时候，很少有里面的数据是固定不变的，常常需要根据一些条件来过滤出我们想要的数据。这就需要通过参数的形式控制报表中的数据。下面，根据前面的报表，我们加入参数使它变成一张更灵活的报表。第一步：单击主菜单中的【配置】-【参数】。弹出“参数编辑”窗体，如下图所示:第二步：点击【增加】按钮，新增一个参数，默认名称为“ argl ”，名称可根据自己的需要 来命名。这里我们把【名称】和【描述】分别改成“name ”和“员工姓名”，【数据类型】我们选择默认的“字符串”。如下图所示：名称描逑觀据类型name员工堆名同样的方法增加一个“奖金”参数，【数据类型】设置

22、为“数值型”。名称描迷数据类型name员工姓名bonus奖金敷值同样的方法增加一个“出生日期”参数，【数据类型】设置为“日期型”。fiif繳据粪型name员工姓名字枫bonustillbirthday出生日期日期同样的方法增加一个“性另参数，【数据类型】设置为“字符串”。名称描述塾踊类型name员工姓名期串bonusbirthday岀主日財曰期sex性别.字符串注:参数名称尽量用英文，中文容易在部署的时候出现乱码，徒增烦恼。在sql语句中不能使用参数5.4 宏定义宏是一个没有数据类型的字符串标识，在报表运算之前，系统会全面搜索整张报表的表达式定义，将所有的宏名替换成宏值。利用宏可以在报表中动态

23、的进行表达式的替换，根据用户传入的不同宏值， 在报表中可以计算出不同的表达式结果，从而得到不同的报表信息， 这样用户就不用根据不同的情况编制许多不同的报表了， 大大减轻了用户的工作量。 此外我们还可以利用宏来实现按一个数据 集的任意字段查询，这是利用参数所不能实现的。其中：填报属性、数据集属性中的参数值，这两个地方目前不能用宏，其它地方的表达 式都可以使用属性值不能用宏，宏只能用在表达式中?表达式中的引用方法为$宏名?宏不能写在引号里面5.5 单元格任意选中一个单元格，在设计器的右边就会出现该单元格的属性列表，大家可以看到, 每个属性都有属性值和表达式两种，如下图所示：这两种有什么区别呢?;凍

24、性遥义层戲据集J1性若彷f C驅性值羸达式二1|亠|旻示桔式II，余冶首先，属性值和表达式是互斥的，定义了属性值，就不必定义表达式，定义了表达式, 就不必定义属性值。其次，属性值是在编辑报表时就写死了的，在报表运行时不必经过运算， 也不会被改变。例如：你在单元格的背景色的属性值中定义了红色，那么报表运行时，它就是红色，不会被 运算，不会被改变。而属性的表达式在报表运行时，会被运算，该属性的最终属性值取决于表达式的运算结 果值。例如：你在单元格的背景色的属性的表达式中编辑条件表达式，则满足不同的条件显示不同的颜色。在属性表达式中可以用“value ()”来指代当前单元格的数据值。5.6 主格根格

25、(报表首格)报表左上角的灰色单元格称为报表首格，也称为根格。它用于存储描述整个报表的属性。如下图所示:根格（报表首格）的书写规则为：0这里要强调的是 0而不是 0主格和附属格单元格进行扩展的过程中，缺省情况下，相对于其右（下）边的单元格而言，扩展格是 主动复制的，被称为其它格（其右/下的格）的主格，而其右（下）的单元格是被动跟随复制的， 被称为扩展格的附属格或子格。 主格和附属格是相对的概念， 即某格是另一格的主格 或附属格，不存在单独的主格和附属格。从主格的定义中看，显然只有扩展格才能是其它格的主格！ 要注意的是，在缺省情况下，扩展格左（上）的格并不是其附属格，只有右（下）的格 才是其附属格

26、。特别地，某个单元格的主格属性可以人为被改变。6 常用函数系统提供各种类型的函数， 下面就常用的函数进行介绍；其他函数可以通过系统提供的帮助来学习。6.1 数据集函数6.1.1 select。从数据集的当前行集中选取符合条件的记录，例 1: ds1.select( name )从数据源ds1中选取name字段列的所有值，不排序例 2: ds1.select( #2, true )从数据源ds1中选取第二个字段列的所有值并降序排列例 3 ： ds1.select( name,false,sex=1)从数据源 ds1 中选取性别为男性 (1) 的 name 字段列的值并升序排列例 4 ： ds1.select( name, true, sex=1, id )从数据源 ds1 中选取性别为男性的 name 字段列的值并按 id 字段降序排列6.1.2 select1()从数据集中按顺序检索到符合过滤条件的第一条记录，返回其 selectExp 值例 1： ds1.select1(name)返回数据集 ds1 中第一条记录的 name 字段值