### BIRT二次开发环境配置详解
#### 一、BIRT简介
BIRT（Business Intelligence and Reporting Tools）是一款基于Eclipse框架的开源报表工具，由Eclipse基金会管理。它提供了强大的报表设计、数据处理和可视化功能，支持多种数据源，并且可以生成PDF、Excel等多种格式的报表。
#### 二、安装前提条件
为了确保BIRT能够正常运行，在安装之前需要确认以下条件已满足：
- 已安装Java Development Kit (JDK)，并且版本符合BIRT的要求。
- 已安装Eclipse IDE，推荐使用最新版或与BIRT兼容的版本。
- 准备好BIRT的安装包`birt-report-designer-all-in-one-2_3_2_2.zip`。
#### 三、BIRT二次开发环境配置步骤
##### 1. 创建工作目录
- 在本地硬盘上创建一个目录作为BIRT的工作目录，例如文中提到的`D:\birt`。
- 在该目录下进一步创建子目录`workspace`，用于存放项目文件。
##### 2. 安装BIRT
- 将下载好的`birt-report-designer-all-in-one-2_3_2_2.zip`解压到`D:\birt`目录下。
- 此时应可以看到BIRT的主程序`eclipse.exe`位于`D:\birt\eclipse`目录下。
##### 3. 配置BIRT与Maximo的集成
- **复制Maximo的类文件及数据库配置文件**：将Maximo的安装目录中的`D:\IBM\SMP\maximo\reports\birt\scriptlibrary\classes`下的文件复制到`D:\birt\eclipse\plugins\org.eclipse.birt.report.viewer_2.3.2.r232_20090212\birt\WEB-INF\`目录下。
- **复制数据库驱动**：将Oracle数据库驱动`oraclethin.jar`从`D:\IBM\SMP\maximo\applications\maximo\lib`复制到`D:\birt\eclipse\plugins\org.eclipse.birt.report.viewer_2.3.2.r232_20090212\birt\WEB-INF\lib`目录下。
- **解压并移动驱动文件**：将`oraclethin.jar`解压后，将解压后的文件移动到`birt\WEB-INF\classes`目录下。
- **配置数据库连接**：编辑`D:\birt\eclipse\plugins\org.eclipse.birt.report.viewer_2.3.2.r232_20090212\birt\WEB-INF\classes\mxreportdatasources.properties`文件，根据自己的数据库配置替换所有`#<DataSourceName>`为`maximoDataSource`。示例配置如下：
```
maximoDataSource.url=jdbc:oracle:thin:@172.16.18.252:1521:maximo
maximoDataSource.driver=oracle.jdbc.driver.OracleDriver
maximoDataSource.username=maximo
maximoDataSource.password=maximo
maximoDataSource.schemaowner=maximo
```
##### 4. 启动BIRT设计器
- 双击`eclipse.exe`启动BIRT设计器。
- 在启动界面选择工作空间`D:\birt\workspace`。
- 勾选“Use this workspace as default and do not ask again”选项以避免下次启动时再次询问。
##### 5. 创建项目
- 在Eclipse中选择菜单`File -> New -> Project`。
- 选择`Business Intelligence and Reporting`下的`Report Project`。
- 输入项目名称（如`maximo`），并取消默认的路径选项。
- 设置项目的源代码位置为`D:\IBM\SMP\maximo\reports\birt\reports`。
- 进入`Window -> Preferences`配置系统属性。
- 配置`Resource`属性，以便更好地管理和优化资源。
- 配置`Template`属性，以便在设计报表时可以使用自定义模板。
通过以上步骤，我们已经完成了BIRT的二次开发环境配置。接下来，可以根据具体需求开始开发报表了。如果在配置过程中遇到任何问题，建议参考官方文档或社区论坛获取帮助。
