BIRT使用说明书.docx
《BIRT使用说明书.docx》由会员分享，可在线阅读，更多相关《BIRT使用说明书.docx（46页珍藏版）》请在冰豆网上搜索。
BIRT使用说明书
BIRT
使用说明书
（Vx.x）
北京神州数码思特奇信息技术股份有限公司
二〇一〇年四月
1BIRT介绍4
2应用集成5
2.1添加Jar包、配置web.xml5
2.2报表查询界面集成15
2.2.1集成EXCEL报表工具16
2.3对BIRT显示界面的一些修改17
2.4备忘事项20
3报表配置22
3.1报表模板的创建28
3.2使用公用的数据源35
3.3参数的配置39
3.3.1配置?
形式的参数39
3.3.2配置脚本形式的参数43
3.1隔行高亮显示44
3.2引用定义好的CSS样式46
3.3图表配置49
3.4字段收敛（根据用户group_id隐藏字段）55
3.4.1数据集beforeOpen脚本中增加56
3.4.2修改报表Sqlquery56
3.4.3修改报表模板58
4尚未解决问题列表59
4.1表头固定59
4.2Word导出乱码59
1BIRT介绍
BIRT（BusinessIntelligenceandReportingTools）,是为Web应用程序开发的基于Eclipse的开源报表系统，特别之处在于它是以Java和J2EE为基础。
BIRT有两个主要组件：
基于Eclipse的报表设计器，以及部署到应用服务器上的运行时组件。
BIRT也提供了图表引擎让你能为应用增加图表。
扩展阅读：
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运行环境要求
Java1.5JDK/JRE以上
Weblogic9以上
2.1添加Jar包、配置web.xml
环境为weblogic10，jdk1.6
应用为渠道佣金系统WEB应用
birt-runtime-2_3_2中WebViewerExample
copyWebViewerExample\WEB-INF\platform到当前工程WEB-INF下
copybirt.tld到当前工程WEB-INF\tld下
copyWebViewerExample\WEB-INF\lib到当前工程WEB-INF\lib下
copyWebViewerExample\WEB-INF\server-config.wsdd到当前工程WEB-INF下
copyWebViewerExample\WEB-INF\viewer.properties到当前工程WEB-INF下
copyjs.jar到weblogic/wlserver_10.3/server/lib/下
编辑chn_domain/bin/setDomainEnv.sh修改CLASSPATH，增加${WL_HOME}/server/lib/js.jar
CLASSPATH="${WL_HOME}/server/lib/js.jar${PRE_CLASSPATH}${CLASSPATHSEP}${WEBLOGIC_CLASSPATH}${CLASSPATHSEP}${POST_CLASSPATH}${CLASSPA
THSEP}${WLP_POST_CLASSPATH}"
copyWebViewerExample\webcontent\birt到当前工程webRoot规下
copyWebViewerExample\report、logs、documents、scriptlib到刚copy过来的webRoot\birt下
编辑web.xml
--BIRT配置-->
--Defaultlocalesetting-->
--context-param>
BIRT_VIEWER_LOCALE
en-US
--
Defaulttimezonesetting.
Examples:
"Europe/Paris","GMT+1".
Defaultstothecontainer'stimezone.
-->
--context-param>
BIRT_VIEWER_TIMEZONE
--Reportresourcesdirectoryforpreview.Defaultto${birthome}-->
--存放报表模板路径-->
BIRT_VIEWER_WORKING_FOLDER
birt/model
--Thegenerateddocumentfilesdirectory.Defaultto${birthome}/documents-->
BIRT_VIEWER_DOCUMENT_FOLDER
birt/documents
--Ifonlyaccessthereprotresourcesunderworkingfolder.Defaultistrue-->
WORKING_FOLDER_ACCESS_ONLY
true
--Outputimage/chartdirectory.Defaultto${birthome}/report/images-->
BIRT_VIEWER_IMAGE_DIR
birt/report/images
--Enginelogdirectory.Defaultto${birthome}/logs-->
BIRT_VIEWER_LOG_DIR
birt/logs
--Reportengineloglevel-->
BIRT_VIEWER_LOG_LEVEL
WARNING
--Directorytostoreallbirtreportscriptlibraries（JARs）.Defaultto${birthome}/scriptlib-->
BIRT_VIEWER_SCRIPTLIB_DIR
birt/scriptlib
--Resourcelocationdirectory.Defaultto${birthome}-->
BIRT_RESOURCE_PATH
birt
--Previewreportmaxrowslimited.-->
BIRT_VIEWER_MAX_ROWS
--Previewreportmaxcubefetchlevelslimited.（Onlysupporttopreviewareportdesignfileusingpreviewpattern.）-->
BIRT_VIEWER_MAX_CUBE_ROWLEVELS
BIRT_VIEWER_MAX_CUBE_COLUMNLEVELS
--Memorysize（MB）forcreatingcube.-->
BIRT_VIEWER_CUBE_MEMORY_SIZE
--Ifalwaysoverwritegenerateddocumentfile.Forruntime,efalulttotrue-->
BIRT_OVERWRITE_DOCUMENT
true
--DefineBIRTviewerconfigurationfile-->
BIRT_VIEWER_CONFIG_FILE
WEB-INF/viewer.properties
--Ifturnonthefunctionthatsupportsprintontheserverside.Defaulttoon.-->
BIRT_VIEWER_PRINT_SERVERSIDE
ON
--IfforceoptimizedHTMLoutput.Defaulttotrue-->
HTML_ENABLE_AGENTSTYLE_ENGINE
true
--BIRT配置-->
--BIRT配置-->
--ViewerFilter.Currently,setrequestcharacterencodingtoUTF-8.-->
ViewerFilter
org.eclipse.birt.report.filter.ViewerFilter
--BIRT配置-->
ViewerFilter
ViewerServlet
ViewerFilter
EngineServlet
--BIRT配置-->
--ViewerServletContextListener-->
org.eclipse.birt.report.listener.ViewerServletContextListener
--BIRT配置-->
--ViewerHttpSessionListener-->
org.eclipse.birt.report.listener.ViewerHttpSessionListener
--BIRT配置-->
--ViewerServlet,SupportSOAP-->
ViewerServlet
org.eclipse.birt.report.servlet.ViewerServlet
--EngineSerlvet-->
EngineServlet
org.eclipse.birt.report.servlet.BirtEngineServlet
--BIRT配置-->
ViewerServlet
/frameset
ViewerServlet
/run
EngineServlet
/preview
EngineServlet
/download
EngineServlet
/parameter
EngineServlet
/document
EngineServlet
/output
EngineServlet
/extract
--BIRT-->
/birt.tld
/WEB-INF/tld/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/ToolsOfSystem.java//工具类
sitech/channel/common/WhereTable.java//简单实体类
sitech/channel/sireport/action/ReportAction.java//strutsAction
sitech/channel/sireport/service/QryWhereBean.java//Excel报表Bean
sitech/channel/sireport/service/RepQueryBean.java//Excel报表Bean
DataConnection.properties//数据库链接配置文件
/gdchn/chnweb/WEB-INF/sc-sys.xml
--报表xuydadd-->
type="sitech.channel.sireport.action.ReportAction"
validate="false"parameter="command"
scope="request">
新增
/gdchn/chnweb/report目录
/gdchn/chnweb/activeX目录
/gdchn/chnweb/ext目录//extjs相关文件
2.3对BIRT显示界面的一些修改
/gdchn/chnweb/birt/pages/layout/FramesetFragment.jsp
--TRCLASS='body_caption_top'>
<%=attributeBean.getReportTitle（）%> |
/gdchn/chnweb/birt/pages/control/ToolbarFragment.jsp
--TDWIDTH="6px"/>
TITLE="<%=BirtResources.getHtmlMessage（"birt.viewer.toolbar.printserver"）%>"
ALT="<%=BirtResources.getHtmlMessage（"birt.viewer.toolbar.printserver"）%>"CLASS="birtviewer_clickable">
/gdchn/chnweb/birt/pages/control/NavigationbarFragment.jsp
if（false）//attributeBean.isShowNavigationbar（））
{
%>
HEIGHT="25px"
<%
}
else
{
%>
style="display:
none"
<%
}
%>
/gdchn/chnweb/birt/styles/style
升级会员 