BIRT使用说明书.docx

1、BIRT使用说明书BIRT使用说明书（Vx.x）北京神州数码思特奇信息技术股份有限公司二一年四月1 BIRT介绍 42 应用集成 52.1 添加Jar包、配置web.xml 52.2 报表查询界面集成 152.2.1 集成EXCEL报表工具 162.3 对BIRT显示界面的一些修改 172.4 备忘事项 203 报表配置 223.1报表模板的创建 283.2使用公用的数据源 353.3参数的配置 393.3.1 配置?形式的参数 393.3.2 配置脚本形式的参数 433.1 隔行高亮显示 443.2 引用定义好的CSS样式 463.3 图表配置 493.4 字段收敛(根据用户group_id

2、隐藏字段) 553.4.1 数据集beforeOpen脚本中增加 563.4.2 修改报表Sqlquery 563.4.3 修改报表模板 584 尚未解决问题列表 594.1 表头固定 594.2 Word导出乱码 591 BIRT介绍BIRT (Business Intelligence and Reporting Tools), 是为 Web 应用程序开发的基于 Eclipse 的开源报表系统，特别之处在于它是以 Java 和 J2EE 为基础。BIRT 有两个主要组件：基于 Eclipse 的报表设计器，以及部署到应用服务器上的运行时组件。BIRT 也提供了图表引擎让你能为应用增加图表。

3、扩展阅读： 1.www.eclipse.org/birt 2.www.birt- 目前最新版本为2.5，但新的版本可能存在问题，也没有前人的经验借鉴，所以我们使用的版本是2.3.2。使用前请先下载birt-rcp-report-designer-2_3_2（eclipse报表设计器）、birt-runtime-2_3_2_2（BIRT报表运行环境）2 应用集成BRIT运行环境要求Java 1.5 JDK/JRE以上Weblogic9以上2.1 添加Jar包、配置web.xml环境为weblogic10，jdk1.6应用为渠道佣金系统WEB应用birt-runtime-2_3_2中WebView

4、erExamplecopy WebViewerExampleWEB-INFplatform 到当前工程WEB-INF下copy birt.tld 到当前工程WEB-INFtld下copy WebViewerExampleWEB-INFlib 到当前工程WEB-INFlib下copy WebViewerExampleWEB-INFserver-config.wsdd 到当前工程WEB-INF下copy WebViewerExampleWEB-INFviewer.properties 到当前工程WEB-INF下copy js.jar 到weblogic/wlserver_10.3/server/l

5、ib/下编辑chn_domain/bin/setDomainEnv.sh 修改CLASSPATH，增加$WL_HOME/server/lib/js.jarCLASSPATH=$WL_HOME/server/lib/js.jar$PRE_CLASSPATH$CLASSPATHSEP$WEBLOGIC_CLASSPATH$CLASSPATHSEP$POST_CLASSPATH$CLASSPATHSEP$WLP_POST_CLASSPATHcopy WebViewerExamplewebcontentbirt 到当前工程webRoot规下copy WebViewerExamplereport、log

6、s、documents、scriptlib 到刚copy过来的webRootbirt下编辑web.xml BIRT_VIEWER_LOCALE en-US BIRT_VIEWER_TIMEZONE BIRT_VIEWER_WORKING_FOLDER birt/model BIRT_VIEWER_DOCUMENT_FOLDER birt/documents WORKING_FOLDER_ACCESS_ONLY true BIRT_VIEWER_IMAGE_DIR birt/report/images BIRT_VIEWER_LOG_DIR birt/logs BIRT_VIEWER_LOG_L

7、EVEL WARNING BIRT_VIEWER_SCRIPTLIB_DIR birt/scriptlib BIRT_RESOURCE_PATH birt BIRT_VIEWER_MAX_ROWS BIRT_VIEWER_MAX_CUBE_ROWLEVELS BIRT_VIEWER_MAX_CUBE_COLUMNLEVELS BIRT_VIEWER_CUBE_MEMORY_SIZE BIRT_OVERWRITE_DOCUMENT true BIRT_VIEWER_CONFIG_FILE WEB-INF/viewer.properties BIRT_VIEWER_PRINT_SERVERSIDE

8、 ON HTML_ENABLE_AGENTSTYLE_ENGINE true ViewerFilter org.eclipse.birt.report.filter.ViewerFilter ViewerFilter ViewerServlet ViewerFilter EngineServlet org.eclipse.birt.report.listener.ViewerServletContextListener org.eclipse.birt.report.listener.ViewerHttpSessionListener ViewerServlet org.eclipse.bir

9、t.report.servlet.ViewerServlet EngineServlet org.eclipse.birt.report.servlet.BirtEngineServlet ViewerServlet /frameset ViewerServlet /run EngineServlet /preview EngineServlet /download EngineServlet /parameter EngineServlet /document EngineServlet /output EngineServlet /extract /birt.tld /WEB-INF/tl

10、d/birt.tld 2.2 报表查询界面集成BIRT参数输入界面BIRT的参数输入界面为弹出页面，并且很多个性化的参数输入类型不能满足，如日期框营销架构、级联参数等。所以就使用我们原有EXCEL报表工具输入参数的页面，通过URL传参。2.2.1 集成EXCEL报表工具新增java类sitech/channel/common/DataConnection.java /数据库操作sitech/channel/common/ExcelBean.java /Excel操作sitech/channel/common/Item.java /简单实体类sitech/channel/common/Tools

11、OfSystem.java /工具类sitech/channel/common/WhereTable.java /简单实体类sitech/channel/sireport/action/ReportAction.java /strutsActionsitech/channel/sireport/service/QryWhereBean.java /Excel报表Beansitech/channel/sireport/service/RepQueryBean.java /Excel报表BeanDataConnection.properties /数据库链接配置文件/gdchn/chnweb/WE

12、B-INF/sc-sys.xml 新增/gdchn/chnweb/report目录 /gdchn/chnweb/activeX 目录 /gdchn/chnweb/ext目录 /ext js相关文件2.3 对BIRT显示界面的一些修改/gdchn/chnweb/birt/pages/layout/FramesetFragment.jsp /gdchn/chnweb/birt/pages/control/ToolbarFragment.jsp INPUT TYPE=image NAME=printServer SRC=birt/images/PrintServer.gif TITLE= ALT= CLASS=birtviewer_clickable /gdchn/chnweb/birt/pages/control/NavigationbarFragment.jsp if( false)/attributeBean.isShowNavigationbar( ) ) % HEIGHT=25px style=display:none /gdchn/chnweb/birt/styles/style