BIRT使用说明书.docx

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