润乾报表使用手册

报表使用手册 报表使用手册报表使用手册 XXXX 股份有限公司股份有限公司 中国中国 济南济南 自定义报表使用手册 1 目录目录 1概述 3 2安装 3 2 1准备好安装程序 3 2 2安装中的选项 3 2 3授权文件配置 4 3报表制作 5 3 1报表制作要求 5 3 2制作一张报表的步骤 5 3 3启动报表设计器 6 3 4连接数据源 7 3 4 1数据源对话框 7 3 4 2编辑数据源 7 3 4 3注意事项 9 3 5设计报表格式 10 3 5 1格式设计 10 3 5 2需注意事项 11 3 6定义参数 11 3 6 1参数的编辑 11 3 6 2常用参数举例 12 3 7定义宏 12 3 7 1宏的编辑 12 3 7 2常用宏举例 13 3 8建立数据集 13 3 8 1数据集的编辑 13 3 8 2常用数据集举例 14 3 9设置单元格属性 16 3 9 1数据集在单元格中应用 16 3 9 2显示格式 16 3 9 3设置预警条件 16 3 9 4增加动态背景色 17 3 9 5按参数隐藏列 17 3 9 6主格应用 17 3 10报表预览 18 3 11报表发布 18 4报表部署 19 4 1部署位置 19 4 2Web 中显示 19 5重要概念 20 5 1数据源 20 5 2数据集 20 5 3参数 20 5 4宏定义 21 自定义报表使用手册 2 5 5单元格 22 5 6主格 22 6常用函数 24 6 1数据集函数 24 6 1 1select 24 6 1 2select1 24 6 1 3count 25 6 2单元格函数 25 6 2 1if 25 6 2 2row 25 6 2 3value 25 6 3字符串函数 25 6 3 1pos 25 6 3 2mid 25 6 4数据类型转换函数 25 6 4 1dateTime 25 6 4 2str 25 自定义报表使用手册 3 1 1概概述述 该文档主要满足 iES E200 电量采集系统中自定义报表制作编写 2 2安安装装 2 2 1 1准准备备好好安安装装程程序序 2 2 2 2安安装装中中的的选选项项 点击安装程序 安装过程中会出现一下选择界面 请注意选择 自定义报表使用手册 4 2 2 3 3授授权权文文件件配配置置 启动报表设计器 启动方式参加 3 2 点击 系统 数据源 菜单 弹出窗口如下图所 示 自定义报表使用手册 5 3 3报报表表制制作作 使用自定义报表的一个显著特点需要显示的对象具有某一项相同的属性 若没有相同 属性可以人工设置相同属性 方法一 对对象进行编码设置 可以利用母线 变压器编码信息进行人工设置相同属 性 方法二 可以将对象添加到其他电量公式中 3 3 1 1报报表表制制作作要要求求 支持非自然日查询 支持非自然月查询 支持表码异常提示 日 多日 月报表通用 表码小数位数显示为 4 位 3 3 2 2制制作作一一张张报报表表的的步步骤骤 自定义报表使用手册 6 打开设计器 定义数据源连接 连接数据源 设计报表格式 定义参数 定义宏 定义数据集 定义单元格表达式 预览报表 发布报表 3 3 3 3启启动动报报表表设设计计器器 启动报表设计器的方式有三种方法 方法一 在安装目录 比如默认的安装目录 C Program Files reportHome bin 寻找 startup bat 的程序文件 双击运行即可 方法二 从程序组中选择 开始 程序 润乾报表 润乾报表设计器 方法三 安装完润乾报表之后 在桌面上会出现润乾报表设计器的快捷方式 双击即 自定义报表使用手册 7 可 润乾报表设计器的主界面 如下图所示 3 3 4 4连连接接 数数据据源源 3 4 13 4 1数数据据源源对对话话框框 点击 配置 数据源 菜单 进入以下对话框 3 4 23 4 2编编辑辑数数据据源源 如果有已编辑好的数据源 点击 连接 按钮 如果没有已编辑好的数据源 点击 新建 按钮 增加一个数据源 数据源的编辑界 自定义报表使用手册 8 面如下 选择 关系型数据库 点击 确定 按钮 进入下面的页面 在这里 我们将数据源名称命名为 jdbc RCCEEI 数据库类型选择 ORACLE 客户端 字符集选择 GBK 数据字符集选择 GBK 驱动程序选择 oracle jdbc driver OracleDriver 数 据源 URL 为 jdbc oracle thin 数据库 IP 1521 db 用户为 XXX 密码为 点击 确定 按钮 建立此数据源 自定义报表使用手册 9 至此 数据源建立完毕 点击 配置 数据源 选中要连接的数据源 点击 连接 按钮 连接词数据源 3 4 33 4 3注注意意 事事项项 需要和 tomcat 连接池配置一致 3 3 5 5设设计计报报表表格格式式 3 5 13 5 1格格式式设设计计 方法一 新建报表 自定义报表使用手册 10 新建报表并根据客户需求设计报表格式包含标题 报表头 数据区 如下图 方法二 导入 Excel 文件 点击 文件 打开 菜单 弹出窗口如下图所示 选择客户提供的报表 点击打开 方法三 根据现有报表修改 打开现有的报表文件 修改该文件使其符合客户要求 3 5 23 5 2需需注注意意 事事项项 边框设置 对齐设置 字符左对齐 数字右对齐 标题 序号居中 隐藏不显示的单元格 行属性和单元格属性向冲突时行属性优先 删除没有用到的单元格 3 3 6 6定定义义 参参数数 3 6 13 6 1参参数数的的编编辑辑 自定义报表使用手册 11 点击 配置 参数 菜单 弹出窗口如下图所示 可以对参数进行添加 修改 删除等操作 参数的值是从网页传递过来 此处参数名 称应和网页一致 3 6 23 6 2常常用用参参数数举举例例 st starttime 简拼表示报表显示数据的开始时间 目前用秒数表示 et endtime 简拼表示报表显示数据的结束时间 目前用秒数表示 substaid substationid 简拼表示变电站 ID strhour 非自然日的开始时间的分钟数 8 00 表示为 480 strdatetype 报表的时间类型 1 为日报表 2 为月报表 3 为多日 lst laststarttime 简拼表示报表显示数据的开始时间的去年同期时间 目前用秒数表示 let lastendtime 简拼表示报表显示数据的结束时间的去年同期时间 目前用秒数表示 yearsecs 表示报表显示数据的开始时间的年初时间 目前用秒数表示 lyearsecs 表示报表显示数据的开始时间的上一年的年初时间 目前用秒数表示 3 3 7 7定定义义 宏宏 3 7 13 7 1宏宏的的编编辑辑 点击 配置 宏 菜单 弹出窗口如下图所示 自定义报表使用手册 12 可以对宏进行添加 修改 删除等操作 宏的赋值可以使用具体的数字 参数或者表 达式 3 7 23 7 2常常用用宏宏举举例例 1 对参数进行处理的宏 startyear mid str dateTime st 1000 0 4 表示开始时间的年份 endyear mid str dateTime et 1000 0 4 表示开始时间的月份 startmonth mid str dateTime st 1000 5 7 表示结束时间的年份 endmonth mid str dateTime et 1000 5 7 表示结束时间的月份 2 在数据集中进行替换的宏 3 3 8 8建建立立 数数据据集集 3 8 13 8 1数数据据集集的的编编辑辑 点击 配置 数据集 菜单 弹出窗口如下图所示 自定义报表使用手册 13 可以对数据集进行添加 删除 修改等操作 常见数据集包括描述信息和历史数据数 据集 描述信息数据集 计量点数据集 母线数据集 主变数据集 线路数据集 CT 数据集 等 历史数据数据集 表码数据集 电量数据集等 3 8 23 8 2常常用用数数据据集集举举例例 母线供电量开关数据集 select a id as id a name a parts id as cparts id b parts type b parts id as parts id c name as switch name b start date b end date c voltage level as voltage level b parts para as parts para b cal sign as cal sign d voltage level as gvoltage level from calc desc a calc para b switch c generatrix d where a id b calc id and a parts type 9 and a parts id d id and a parts para 0 and c id b parts id and d substation id substaid and b start date starttime or b start date endtime CT 数据集 select mp id run date coef from ct where run date starttime and mp id in select b parts id as parts id from calc desc a calc para b switch c generatrix d where a id b calc id and a parts type 9 母线公式中的计量点 and a parts id d id and c id b parts id and d substation id substaid 自定义报表使用手册 14 and 公式时效判断 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 select mp id mod power type 10 10 as power type sum total value as total value from mp day e year WHERE datetime starttime and datetime endtime and power type false true 即可按照输入参数隐藏列 3 9 63 9 6主主格格 应应用用 主要说明在同一张报表中有几个同一类型数据区 如在一张报表中分别显示该变电站 能所有母线的计算分量的详细信息 可以根据实际情况分别对多条母线分别设置单元格属 性 更方便的是采用人工干预主格的方式实现 以下图为例说明 1 首先在 A16 单元格中设置需要显示的母线的 ID 2 在 17 行到 27 行完成一条母线的各类数据的赋值 3 从 17 行到 27 行设置左主格为 A16 3 3 1 10 0报报表表预预览览 报表预览主要用于验证报表是否正确 点击工具栏中的预览图标 自定义报表使用手册 17 弹出参数赋值对话框 根据实际情况对各个参数赋值后 点击 确定 按钮 如果预 览界面正常 说明我们报表建立成功 3 3 1 11 1报报表表发发布布 参见报表部署 自定义报表使用手册 18 4 4报报表表 部部署署 4 4 1 1部部署署位位置置 目前在下放置一些常见的报表模板部署时可以根据实际情况进行删减 目录结构 dayreport 放置日报表模板 company 放置不需要选择厂站的日报表模板 substation 放置需要选择厂站的日报表模板 monthreport 放置月报表模板 company 放置需要选择厂站的月报表模板 substation 放置需要选择厂站的月报表模板 4 4 2 2Web 中中显显示示 在 web 菜单 数据浏览 项中的 应用日报表 对应自定义日报表的显示 应用 月报表 对应自定义月报表的显示 自定义报表使用手册 19 5 5重重要要概概念念 5 5 1 1数数据据源源 顾名思义 数据的来源 在数据源中存储了所有建立数据库连接的信息 就象通过指 定文件名你可以在文件系统中找到文件一样 通过提供正确的数据源名称 你可以找到相 应的数据库连接 数据源标准属性包括 1 databaseName String 数据库名称 即数据库的 SID 2 dataSourceName String 数据源接口实现类的名称 3 description String 对数据源的描述 4 networkProtocol String 和服务器通讯使用的网络协议名 5 password String 用户登录密码 6 portNumber 数据库服务器使用的端口 7 serverName String 数据库服务器名称 8 user String 用户登录名 如果数据是水 数据库就是水库 数据源就是连接水库的管道 终端用户看到的数据 集是管道里流出来的水 5 5 2 2数数据据集集 数据集是包含数据表的对象 可以在这些数据表中临时存储数据以便在应用程序中使 用 如果应用程序要求使用数据 则可以将该数据加载到数据集中 数据集在本地内存中 为应用程序提供了待用数据的缓存 即使应用程序从数据库断开连接 也可以使用数据集 中的数据 数据集维护有关其数据的更改的信息 因此可以跟踪数据更新 并在应用程序 重新连接时将更新发送回数据库 5 5 3 3参参数数 在我们设计一张报表的时候 很少有里面的数据是固定不变的 常常需要根据一些条 件来过滤出我们想要的数据 这就需要通过参数的形式控制报表中的数据 下面 根据前面的报表 我们加入参数使它变成一张更灵活的报表 第一步 第一步 单击主菜单中的 配置 参数 自定义报表使用手册 20 弹出 参数编辑 窗体 如下图所示 第二步 第二步 点击 增加 按钮 新增一个参数 默认名称为 arg1 名称可根据自己的需要 来命名 这里我们把 名称 和 描述 分别改成 name 和 员工姓名 数据类型 我们选择默认的 字符串 如下图所示 同样的方法增加一个 奖金 参数 数据类型 设置为 数值型 同样的方法增加一个 出生日期 参数 数据类型 设置为 日期型 同样的方法增加一个 性别 参数 数据类型 设置为 字符串 注 参数名称尽量用英文 中文容易在部署的时候出现乱码 徒增烦恼 在sql语句中不能使用参数 5 5 4 4宏宏定定义义 自定义报表使用手册 21 宏是一个没有数据类型的字符串标识 在报表运算之前 系统会全面搜索整张报表的 表达式定义 将所有的宏名替换成宏值 利用宏可以在报表中动态的进行表达式的替换 根据用户传入的不同宏值 在报表中 可以计算出不同的表达式结果 从而得到不同的报表信息 这样用户就不用根据不同的情 况编制许多不同的报表了 大大减轻了用户的工作量 此外我们还可以利用宏来实现按一 个数据集的任意字段查询 这是利用参数所不能实现的 其中 填报属性 数据集属性中的参数值 这两个地方目前不能用宏 其它地方的表 达式都可以使用 属性值不能用宏 宏只能用在表达式中 表达式中的引用方法为 宏名 宏不能写在引号里面 5 5 5 5单单元元格格 任意选中一个单元格 在设计器的右边就会出现该单元格的属性列表 大家可以看到 每个属性都有属性值和表达式两种 如下图所示 这两种有什么区别呢 首先 属性值和表达式是互斥的 定义了属性值 就不必定义表达式 定义了表达式 就不必定义属性值 其次 属性值是在编辑报表时就写死了的 在报表运行时不必经过运算 也不会被改 变 例如 你在单元格的背景色的属性值中定义了红色 那么报表运行时 它就是红色 不会被运算 不会被改变 而属性的表达式在报表运行时 会被运算 该属性的最终属性值取决于表达式的运算 结果值 例如 你在单元格的背景色的属性的表达式中编辑条件表达式 则满足不同的条 件显示不同的颜色 在属性表达式中可以用 value 来指代当前单元格的数据值 5 5 6 6主主格格 根格 报表首格 根格 报表首格 报表左上角的灰色单元格称为报表首格 也称为根格 它用于存储描述整个报表的属 性 如下图所示 自定义报表使用手册 22 根格 报表首格 的书写规则为 0 这里要强调的是 0 而不是 0 主格和附属格主格和附属格 单元格进行扩展的过程中 缺省情况下 相对于其右 下 边的单元格而言 扩展格 是主动复制的 被称为其它格 其右 下的格 的主格 而其右 下 的单元格是被动跟随 复制的 被称为扩展格的附属格或子格 主格和附属格是相对的概念 即某格是另一格的 主格或附属格 不存在单独的主格和附属格 从主格的定义中看 显然只有扩展格才能是其它格的主格 要注意的是 在缺省情况下 扩展格左 上 的格并不是其附属格 只有右 下 的 格才是其附属格 特别地 某个单元格的主格属性可以人为被改变 自定义报表使用手册 23 6 6常常用用函函数数 系统提供各种类型的函数 下面就常用的函数进行介绍 其他函数可以通过系统提供 的帮助来学习 6 6 1 1数数据据集集函函数数 6 1 16 1 1s se el le ec ct t 从数据集的当前行集中选取符合条件的记录 例 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 26 1 2s se el le ec ct t1 1 从数据集中按顺序检索到符合过滤条件的第一条记录 返回其 selectExp 值 例 1 ds1 select1 name 自定义报表使用手册 24 返回数据集 ds1 中第一条记录的 name 字段值 例 2 ds1 select1 name score 90 从数据集 ds1 中检索出成绩大于 90 的记录 返回第一条记录的 name 字段值 6 1 36 1 3c co ou un nt t 计算数据集当前