自定义报表工具使用说明

1、CMS自定义报表工具教程,2009/08/28,目 录,报表制作的基础知识,自定义报表工具安装,使用自定义报表工具绘制报表,使用CMS运行自定义报表,自定义报表的调试,目 录,报表制作的基础知识,自定义报表工具安装,使用自定义报表工具绘制报表,使用CMS运行自定义报表,自定义报表的调试,1 什么是报表,报表制作的基础知识,报表是由数据源和显示格式组成的对象，工作方式为先从数据源检索出 的数据再应用显示格式显示出来，由于显示格式可以多种多样，所以相同 的数据可以呈现出多种样式的报表。,因此制作报表就是定义数据源和绘制显示格式的过程。,2 CMS报表,CMS报表是指能让CMS识别和调用的报表，每个

2、报表分为两部分，报表 查询条件和报表主体，二者一一对应，缺一不可。,制作CMS报表就是绘制数据窗口对象(报表主体和查询条件)的过程，它 的数据源就SQL语句，显示格式就是数据窗口输出的格式，报表主体一般 要求为列表格式(Grid)，查询条件一般要求为自由格式(Freeform)。,目 录,报表制作的基础知识,自定义报表工具安装,使用自定义报表工具绘制报表,使用CMS运行自定义报表,自定义报表的调试,1 软件环境要求,自定义报表工具安装,Windows2000及以上操作系统，安装了Oracle客户端，能访问CMS数据 库，CMS数据库必须存在五张用户表：pub_rpt, pub_rpt_lang

3、uage, pub_rpt_link, pub_rpt_user, pub_rpt_userprop。,2 自定义报表工具安装,将自定义报表工具程序目录直接拷贝到硬盘上即可。程序目录中包括程 序主体文件(pbd、exe)和动态链接库文件(dll)。,打开文件目录中SYSSET.INI，进行CMS数据库连接信息配置，方法同 CMS目录的sph.ini，确保报表工具和CMS程序访问的是同一个数据库。 双击reporter.exe，运行报表工具。,目 录,报表制作的基础知识,自定义报表工具安装,使用自定义报表工具绘制报表,使用CMS运行自定义报表,自定义报表的调试,使用自定义报表工具绘制报表,简要流

4、程,开始,增减报表字段,编辑报表样式,供CMS用户自定义报表模块调用,保存到CMS数据库,结束,Pbl/pbd文件载入报表,CMS数据库载入报表,手工SQL输入生成报表,添加排序和过滤条件及分组信息维护,保存到外部文件,1 自定义报表设计视图,使用自定义报表工具绘制报表,设计视图是指自定义报表的编辑区域，分两种模式，带区设计视图和 Word设计视图，一般使用带区设计视图。,2 工作带区介绍,视图中总共有几种不同的区 (Bands)，每一种区代表不同的显示含义，字段或是其它对 象在视图中所放置的区，将决定这些对象会被显示或打印在报表的什么地方。,使用自定义报表工具绘制报表,4 创建报表的3种方法

5、,使用自定义报表工具绘制报表,向导式，直接编辑SQL方式，从PBL文件中导入已有的报表再编辑。后 两种方式比较常用，尤其第3种方式比较快捷，减少重复劳动。,5 报表的3种类别,系统导入临时报表，用于标识从PBL文件中导入的已有报表 用户报表设计，用于标识用户报表对象 用户查询报表设计，用于标识报表查询条件对象 只有后两种CMS系统才能识别和调用，第一种只是为了导入暂存报表， 方便修改后另存成后两种报表对象。,3 报表设计的常用对象,常用对象包括：列(column)，计算列(compute)，文本(text)。列显示数 据源的数据；计算列是由列和其他计算列组成的表达式，支持函数，通过 计算显示结

6、果；文本用来显示特定的字符，如表头信息。,使用自定义报表工具绘制报表,7 报表参数及查询条件列的命名规则,报表写SQL原则,大表写在前面，小表写在后面，表名要起别名，别名采用小写字母， 按照由小到大的顺序命名。 WHERE条件先写大表的关联条件，再写小表的关联条件，最后写字 段的常量条件。WHERE条件中的AND关键字统一写在最左边。 SQL中的计算列也要起别名，别名采用有意义的英文单词及其缩写， 例如：namespec，不要用中文。,报表参数命名：数据类型前缀_对应的字段名，例如：as_goods， an_purdeptid，ad_startdate。字符型前缀：as，数据值型前缀：an，日

7、 期型前缀：ad，日期时间型前缀：adtm。 查询条件列的命名：对应的字段名，例：billno，cstcode，goods。 对时间段查询条件一般取startdate，enddate，也可以用结合字段名灵活 命名，例：createdate_start，createdate_end。,使用自定义报表工具绘制报表,8 报表设计实例讲解（详见视频文件）,目 录,报表制作的基础知识,自定义报表工具安装,使用自定义报表工具绘制报表,使用CMS运行自定义报表,自定义报表的调试,1 用户自定义报表设置, 使用CMS运行自定义报表,进入CMS，打开系统管理|系统参数|用户自定义报表设置功能，新增一 记录，在报

8、表代码中F7输入报表主体代码，在查询窗口报表代码中F7输 入 查询条件报表代码，最后点击保存，以达到将报表主体与查询条件相 互关联起来的目的。, 使用CMS运行自定义报表, 使用CMS运行自定义报表,2 定义报表菜单,以管理员身份进入CMS，打开系统管理|系统参数|系统菜单管理功能， 添加自定义报表菜单，窗口名为w_pub_rpt_user，打开参数为报表代码， 菜单代码可包含公司拼首缩写，例如：广州公司为09_gz_01，方便识别。 同时可以利用菜单的登录部门和人员角色属性，限制菜单的使用范围，当 然别忘记对普通用户设置菜单权限。, 使用CMS运行自定义报表,3 运行自定义报表, 使用CMS

9、运行自定义报表,进入CMS，打开刚才定义的报表菜单，可以看到报表主体已经载入列 表窗口，点击查询按钮，可以看到查询条件报表也载入弹出窗口中，输 入查询条件，其中定义了F7输入功能的查询条件栏位，可以F7输入，日 期条件可以双击小日历输入，如果栏位作了人员角色或部门的限制，在 满足条件时也可输入，否则不能编辑，最后点击确定按钮，即可在列表 窗口显示查询结果。, 使用CMS运行自定义报表,目 录,报表制作的基础知识,自定义报表工具安装,使用自定义报表工具绘制报表,使用CMS运行自定义报表,自定义报表的调试,1 运行SQL监控工具(SqlMonitor),自定义报表的调试,SqlMonitor是一个

10、能够监控应用程序向Oracle数据库发送SQL的工具， 运行后自动显示连接Oracle数据库的应用程序，将要监控的程序前打勾， CMS运行后显示为sys_main.exe，将它勾上即可监控CMS程序发送的 SQL。,2 运行CMS自定义报表,打开CMS自定义报表菜单，在弹出的查询窗口中输入查询条件，点击确 定按钮显示报表查询结果，再切换到SqlMonitor 中，此时SQL输出页面上 显示的SQL就是报表执行的，可以查看到SQL中的变量及其的赋值情况， 如果有报错信息显示，则将这段SQL拷贝出来单独执行，查找错误原因， 并到报表工具中对数据窗口对象进行相应的修改，然后再测试，反复几次 下来一般

11、的报错都可解决。,自定义报表的调试,3 常见问题,自定义报表的调试,Q：打开菜单出现“获取报表语法信息时出错,没有找相关记录！”信息？ A：菜单的打开参数没有写正确，CMS没有找到用户报表。,Q：打开查询条件窗口出现“获取报表语法信息时出错,没有找相关记录！” 信息？ A：自定义报表和它对应的查询条件没有设置正确，CMS没有找到查询条 件报表对象，到“用户自定义报表设置”中改正。,Q：查询时出现“参数：an_purdeptid不是有效参数，请检查！” A：自定义报表没有添加参数an_purdeptid，或者查询条件的tag属性中该 字段没写对参数名称。,自定义报表的调试,Q：查询出现“retr

12、ieve argument 9 does not match excepted type”信息？ A：报表的第9个参数的数据类型和传入的查询条件不一致，需要到自定 报表工具中进行相关修改。,Q：我的报表双击列头不能排序？ A：报表的列头文本对象命名不正确造成，正确命名规则为：列名_t，报表 工具初始生成的列头都是按这个规则命名的，只有手工增加的需要改。,Q：报表导出时出现“ora-00972: identifier is too long”信息？ A：报表的某个或几个字段命名过长，超过了30个字符，需要到自定义报 表工具中将这些字段找到并重命名短些，同时将对应列头文本重命名。,Q：查询条件输入双击或F7时，出现“存放Id的列宽度不足以支持多选模式 需要，请与开发人