BIRT (一) 安装BIRT

发现自己还上了javaeye的头版了，也算是灌水灌出了自己的特色了吧, 希望自己还是加紧时间学习，好为大家提供更多更好的优质纯净水.

安装Birt 其实非常的简单.只需要下载Birt-Runtime-version 文件就可以了.下载解压后，其中有一个目录是ReportEngine 的目录，所有的Birt 能够运行都需要这个目录下的程序.
另外一个就是WebViewerExample 目录，这是一个eclipse 的sample ,直接把它放到tomcat webapps目录下就可以了.
运行成功后应该直接有 BIRT viewer has been installed 的提示,下面有个 View Example 的链接.它会调用一个Servlet 处理一个test.rptdesing 的模板并且接受一个默认的参数“my parameter" ,
你可以之后改变这个参数.
test.rptdesign 文件在WebViewerExample 下面，另外还有一个test1.rptdesing 文件把你的浏览器指向
http://localhost:8080/WebViewerExample/frameset?__report=test1.rptdesign
会弹出来一个parameter 对话框,随便输入两个1 ， 後然运行出来的报表是个非常简单的报表.
这两个报表都是只用visual design 做出来的.算是最基本的入门了.

再来看一下这个sample 的目录结构，在WebViewerExample下，有6个目录，一个index.jsp 文件和两个birt 模板文件.
其中documents 目录，logs 目录 ， scriptlib 目录是在web.xml 里面定义的，你可以定义到其他地方,里面还有其他的定义，都有注释。
在WEB-INF 目录下，有lib ， platform ,tlds 目录，web.xml文件 和 server-config.wsdd ，这是一个标准的BIRT 安装目录，platform 下放的是从birt-runtime-version 的reportengine 下copy 过来的.
另外还有一个viewer.properties 文件，里面定义了可以输出的文件格式，现在一共支持6种：html , pdf , postscript , doc , xls (也就是csv,或者说是excel） ,ppt
如果你需要Birt 支持excel 或者 word 格式在这里定义就好了.
# [EXTENSION SETTING]
viewer.extension.html=html
viewer.extension.pdf=pdf
viewer.extension.postscript=ps
viewer.extension.doc=doc
viewer.extension.xls_prototype=xls
viewer.extension.ppt=ppt

# [OUTPUT FORMAT LABEL NAME]
viewer.label.html=HTML
viewer.label.pdf=PDF
viewer.label.postscript=Postscript
viewer.label.doc=Word
viewer.label.xls_prototype=Excel
viewer.label.ppt=Powerpoint

# [CSV SEPARATOR]
viewer.sep.0=,
viewer.sep.1=;
viewer.sep.2=:
viewer.sep.3=|
viewer.sep.4=\t

后面的CSV SEPARATOR 是支持你导出数据用的.

注意你的lib 都已经正确放置了先.

下一篇是介绍用最简单的Design API 来设计一个模板.