第三章 BIRT数据源的配置

选择数据资源管理器(Data Explorer)。如果使用缺省报表设计透视图，则数据资源管理器位于布局编辑器的左边，在画板（Palette）的旁边，如图所示。如果它尚未打开，则选择窗口->显示视图->数据资源管理器。

图3-1 数据资源管理器

右键单击Data Sources然后从上下文菜单中选择新建数据源。新建数据源显示可以创建的数据源的类型，如图所示。

图3-2 新建数据源

Classic Models Inc.Sample DataBase ———上面说过是BIRT样本数据库。

Flat File Data Source ———从CSV、SSV、TSV、PSV四种格式的平面文件获取数据源。

JDBC Data Source ——— 通过配置jdbc连接数据库。

Script Data Source ——— 通过编写脚本获取数据源。

Web Services Data Source ——— 通过web service方式获取数据源。

XML Data Source ——— 从xml文件获取数据源。

3.1 JDBC数据源

在数据源上新建数据源，出现如下对话框，

图3-3 新建JDBC数据源

图3-4 配置JDBC数据源

图3-5 测试JDBC数据源

各参数含义如下：

驱动程序类：JDBC 驱动类名。该列表默认会有“org.apache.derby.jdbc.EmbeddedDriver (Apache Derby Embedded Driver)”、“org.eclipse.birt.report.data.oda.sampledb.Driver (Classic Models Inc. 示例数据库驱动程序)”两个选项，分别对应于Derby数据库和BIRT 自带的示例数据库。用户可点击“管理驱动程序…”来添加/删除JDBC 驱动包（jar或zip），该包中的所有JDBC 驱动类类名将被添加到此列表供用户选择。用户添加的JDBC驱动包将被复制到“\\plugins\org.eclipse.birt.report.data.oda.jdbc_xxx\drivers”目录下（其中“xxx”代表版本号）。

驱动程序URL：JDBC连接URL。各JDBC 驱动有其对应的URL格式，可参考具体JDBC 驱动的文档。

用户名：数据库登录名。

密码：数据库登录密码。

JNDI URL：如果JDBC连接信息是以JNDI 数据源的方式配置在部署报表的应用服务器上，此处为应用服务器上该JNDI 数据源的URL。例如，Tomcat上JNDI 数据源的URL格式为“java:/comp/env/jdbc/xxx”（其中“xxx”为JNDI 数据源名）。

注意：如果提供JNDI URL，只在把报表部署到应用服务器后才生效。在设计报表时，使用的<驱动程序类，驱动程序URL，用户名， 密码>组合。

可点击“测试连接…”来测试能否使用输入的<驱动程序类，驱动程序URL，用户名， 密码>与数据库连接成功。

在XML中会出现如下的配置信息：

<oda-data-source extensionID="org.eclipse.birt.report.data.oda.jdbc" name="MyDatasource" id="187">            

<text-property name="displayName"></text-property>            

<property name="odaDriverClass">oracle.jdbc.driver.OracleDriver</property>

<property name="odaURL">jdbc:oracle:thin:@182.64.254.194:1521:vbsdev</property>

<property name="odaUser">wfl</property>

<encrypted-property name="odaPassword" encryptionID="base64">d2Zs</encrypted-property>

  </oda-data-source>

</data-sources>

其中birt designer自带的数据库配置如下图：

图3-6 示例数据库配置

如果测试连接未通过，除了Database URL可能不对之外，用户名，密码都可能不对。另外࿰