IPBOSSNMS21报表report21P使用手册.docx

1、IPBOSSNMS21报表report21P使用手册报表服务使用手册Report User Manual v1.0亿阳信通 文档编号：IP-BOSSNMS-2.0_集中配置(IntegratedConfig)-1.0_P_使用手册发布日期： 2005-11-25部 门：IP网管撰 写：刘志佳文档编号：IP-BOSSNMS-2.0_报表(report)-1.0_P_使用手册文档状态：发布稿 V1.0版权属于亿阳信通所有，无亿阳信通的书面同意，任何个人或组织无权拷贝。文档修改记录版本号主要作者修改记录完成日期1.0刘志佳创建2009-04-05目录报表服务使用手册 1目录 2范围（Scope） 1

2、1. 系统概述 21.1. 背景 21.2. 什么是报表 21.3. 报表模块与网管系统其它各模块的关系 21.4. 报表功能概述 22. 初始数据准备(开发人员,现场实施人员使用) 33. 基础数据配置(实施人员使用) 43.1 Sree服务的配置 43.2服务器中的相关配置 44. 报表使用流程 75. 常见问题 125.1时间延迟问题 125.2配置部署问题 12文档结束 13范围（Scope）本文档描述BOSSNMS2.0报表相关概念及操作，用于指导实施人员、用户利用对报表模块在BOSSNMS2.0系统中的安装和使用工作网络被管设备配置 本文档适用的集成系统和软件系统是：BOSS网管系

3、统2.01. 系统概述1.1. 背景在网管系统中，数据经过采集，进入南向数据库。这些数据对于使用人员来说是绝对重要的，这些数据是他们用来作为其工作分析的重要依据。我们不可能让使用人员直接访问数据库来获取数据信息，所以我们需要将这些数据信息展示的web界面上，这样使用人员可以方便，快捷地获取相关信息，提高工作效率。1.2. 什么是报表报表就是由报表格式和报表数据构成的表格，用来展示分析数据使用。1.3. 报表模块与网管系统其它各模块的关系报表模块是依赖数据库信息，在系统结构中相对独立。报表模块只需要数据库提供的数据信息就能运行，与系统中其他模块没有任何冲突。1.4. 报表功能概述如前所说，报表的

4、功能在于展示分析数据使用。在BOSS网管系统中我们使用StyleReport第三方工具来开发报表。Style Report是一个非常强大的报表开发工具，用户可以使用可视化设计器设计报表模板，或者通过Style Report 提供的Java API来完成报表开发。.Style Report提供了可视化设计器可以进行报表布局设计，数据绑定最终生成，也可以设计报表模板，然后与java API结合生成报表。Style Report也支持把报表转化成excel文件或者发送打印机打印。2. 初始数据准备(开发人员,现场实施人员使用)开发人员按照da文档分析开发报表并且使用ant把报表服务sree制作成sr

5、ee.war，现场实施人员负责把sree.war发布到服务器web容器下的webapps下即可。3. 基础数据配置(实施人员使用)3.1 Sree服务的配置（有脚本的情况以脚本信息为例） Sree服务servlet的配置：根据服务器ip不同，数据库地址不同，需要对sree服务进行配置工作。以tomcat为例：在./webapps/sree/WEB-INF/classes/sree.properties中修改，根据实际的需求修改replet.repository.url和replet.repository.servlet这两个属性。 Sree数据库修改：如果数据库地址改变，配置文件则需要相应修改

6、。以tomcat为例：在./webapps/sree/WEB-INF/classes/datasource.xml中，把原数据库信息修改为新数据库信息。 修改之后重新启动tomcat即可3.2服务器中的相关配置 3.2.1 在unix下发布sree服务需要对catalina.sh进行修改，因为在unix下用到图形处理，java程序会去寻找linux上的图形界面是否启动 修改方法如下：在web服务器中下，以tomcat5.5.25为例，在./tomcat5.5.25/bin/catalina.sh中进行如下修改：（添加红色字段的配置项即可）elif $1 = run ; then shift i

7、f $1 = -security ; then echo Using Security Manager shift exec $_RUNJAVA $JAVA_OPTS $CATALINA_OPTS -Djava.endorsed.dirs=$JAVA_ENDORSED_DIRS -classpath $CLASSPATH -Djava.security.manager -Djava.security.policy=$CATALINA_BASE/conf/catalina.policy -Dcatalina.base=$CATALINA_BASE -Dcatalina.home=$CATALIN

8、A_HOME -Djava.io.tmpdir=$CATALINA_TMPDIR -Djava.awt.headless=true org.apache.catalina.startup.Bootstrap $ start else exec $_RUNJAVA $JAVA_OPTS $CATALINA_OPTS -Djava.endorsed.dirs=$JAVA_ENDORSED_DIRS -classpath $CLASSPATH -Dcatalina.base=$CATALINA_BASE -Dcatalina.home=$CATALINA_HOME -Djava.io.tmpdir=

9、$CATALINA_TMPDIR -Djava.awt.headless=true org.apache.catalina.startup.Bootstrap $ start fielif $1 = start ; then shift touch $CATALINA_BASE/logs/catalina.out if $1 = -security ; then echo Using Security Manager shift $_RUNJAVA $JAVA_OPTS $CATALINA_OPTS -Djava.endorsed.dirs=$JAVA_ENDORSED_DIRS -class

10、path $CLASSPATH -Djava.security.manager -Djava.security.policy=$CATALINA_BASE/conf/catalina.policy -Dcatalina.base=$CATALINA_BASE -Dcatalina.home=$CATALINA_HOME -Djava.io.tmpdir=$CATALINA_TMPDIR -Djava.awt.headless=true org.apache.catalina.startup.Bootstrap $ start $CATALINA_BASE/logs/catalina.out 2

11、&1 & if ! -z $CATALINA_PID ; then echo $! $CATALINA_PID fi else $_RUNJAVA $JAVA_OPTS $CATALINA_OPTS -Djava.endorsed.dirs=$JAVA_ENDORSED_DIRS -classpath $CLASSPATH -Dcatalina.base=$CATALINA_BASE -Dcatalina.home=$CATALINA_HOME -Djava.io.tmpdir=$CATALINA_TMPDIR -Djava.awt.headless=true org.apache.catal

12、ina.startup.Bootstrap $ start $CATALINA_BASE/logs/catalina.out 2&1 & if ! -z $CATALINA_PID ; then echo $! $CATALINA_PID fi 3.2.2 同时还需要修改web服务器中的server.xml文件。以tomcat为例，在./tomcat*/conf/server.xml中，在对应的端口号后添加属性：URIEncoding = GBK，如下： 4. 报表使用流程首先登陆系统首页：如下图登陆后出现菜单界面:选择报表，出现报表界面其中最左边为报表树结构：如下图开始有3个功能点，展开：打

13、开所有树结构，展示到每一级的最后字段 关闭：回到上图展示模样 刷新：刷新列表，获得最近数据 之下为报表树结构，每个节点都是一个服务模块，根据客户需求而定。打开报表，如下图，以开户可用性日报为例：这是报表最初的数据情况，报表默认以昨天的0点到现在的这个时间条件来刷选数据，报表左上方的日期代表展示出来的数据的时间范围，本例中因为没有实例数据，所以显示为空表。报表的查询：如果需要查询，那么点击查询就会弹出查询的模块，如下图：每个报表查询配备的条件是不一样的，我们拿这个有时间和地点两个查询条件的报表为例。上面，我们可以选择地市条件，-为把选中的某一项添加到选中的城市中，为全部选择，-为取消选中城市中选

14、中的某一项，为全不选之下是时间选项，时间粒度主要分为5种，小时，天，周，月，年。根据选择的时间粒度不同，下面显示的时间选择不同，出现的时间选择框会符合时间粒度的要求。添加好查询条件，点击生成报表就会出现相应报表，如下图所示：每个表的需求不同，出现的图形文件也不同，但是最先面的报表数据是必有的。在这个展示报表的上端，有一组工具栏，如图：其中为报表的翻页功能，如果数据量很大，就会使用到此功能。可在查询到的数据中继续查询发送至打印机打印刷新获得新数据发送mail导出文件可以转化成excel，pdf等格式的文件调节报表展示大小的比例5. 常见问题5.1时间延迟问题报表服务开启后的第一次使用的时候，需要

15、一定的时间读取，请耐心等待。点击查询获取查询条件时，地点查询条件出现时需要读数据，会比时间条件出现慢。5.2配置部署问题如果点击报表显示错误提示java.lang.Throwable: java.lang.InternalError: Cant connect to X11 window server using :0.0 as the value of the DISPLAY variable，那么就是在unix环境下对catalina.sh的修改没有正确，请参考3.2.1中的实例修改。如果报表上部分出现乱码，那么则是3.2.2中对server.xml的配置没有成功！请按照文档实例重新修改。文档结束