This document provides additional details on configuring BIRT Report Designer 212 for the V7 Releases.

These details are a supplement to the Report Development Guide (mam71_report_dev_guide.pdf, or ccmdb_71_report_dev_guide.pdf). The steps include

1. Installing V7 Design Files for BIRT (pages 2 4)

a. *Reference Report Development Guide pages 4 - 6

2. Accessing the BIRT Designer (pages 5 8)

a. *Reference Report Development Guide pages 6 - 7

3. Configuring BIRT Report Designer to work with V7 Configuration files (pages 9 14)

a. *Reference Report Development Guide pages 7

Note: BIRT 2.1.2 is the only supported BIRT Version for the V7 Releases. The download for BIRT Designer 2.1.2 is on OPAL at the url below: https://www14.software.ibm.com/webapp/iwm/web/reg/download.do?source =tivopal&S_PKG=1TW10OT03&lang=en_US&cp=UTF-8

1. Installing V7 Design Files for BIRT To perform the next steps, you will need a local copy of V7, with the report source. Additionally, in the file paths below, v20070205-1728 is a version number

and may be slightly different depending on the version you installed.

1. Locate the compiled classes for report scripting from the location below
<maximo>\reports\birt\scriptlibrary\classes

2. Navigate to the location below

eclipse\plugins\org.eclipse.birt.report.viewer_2.1.2.v20070205-1728\birt\WEBINF

A. Create a classes folder B. Copy the entire \com folder from step 1 to
eclipse\plugins\org.eclipse.birt.report.viewer_2.1.2.v20070205-1728\birt\WEBINF\classes

3. Copy mxreportdatasources.properties using the same source and destination folders from steps 1 and 2.

4. Open the copied mxdatasources.properties file, and edit if for your local configuration: a) Set the URL, driver, username, password, and schemaowner properties for your local environment following the sample formats provided. b) Change #<DataSourceName> to maximoDataSource.

Notes: A. The mxdatasources.properties file is only required by the report designer; at runtime the connection info will be set from Maximo. B. A sample of this file for DB2 is shown below:
#<DataSourceName>.<propertyName>=value # # # # # # # # # # # # driver for ORACLE oracle.jdbc.driver.OracleDriver sample url for ORACLE jdbc:oracle:thin:@<HOST>:<PORT>:<SID> driver for SQLServer com.inet.tds.TdsDriver sample url for SQLServer jdbc:inetdae7a:hostname:port?database=dbname&language=us_english&nowarnings=true driver for DB2 com.ibm.db2.jcc.DB2Driver sample url for DB2 jdbc:db2://localhost:50000/dbalias

maximoDataSource.url=jdbc:db2://HARRIERDB2:50000/HARRIER maximoDataSource.driver=com.ibm.db2.jcc.DB2Driver maximoDataSource.username=maximo maximoDataSource.password=maximo The values in red point to a sample local database. You can check yours and other available for you to choose from Start Menu\Programs\IBM DB2\Set-up Tools\Configuration Assistant. The key name in green is the default set for all reports, you have to use exactly this text.

5. Copy the JDBC driver(s) from <Maximo>\applications\maximo\lib or from the attached zip file to:
eclipse\plugins\org.eclipse.birt.report.viewer_2.1.1.v20070205-1728\birt\WEBINF\lib

These drivers are only used by the designer. Note: For Oracle, use oraclethin.jar For SQL Server, use opta.jar For DB2, use db2jcc.jar and db2jcc_license_cu.jar

2. Accessing the BIRT Designer 1. Create a shortcut to eclipse.exe. Be sure to include the following path pointing to your JDK 1.5 install highlighted in red in the target for the shortcut. C:\eclipse_download\BIRT\eclipse\eclipse.exe -vm "C:\program files\IBM\Java50\bin\javaw.exe" -vmargs -Xmx512m

2. Select a workspace location. Check Use this as default field and OK.

3. Eclipse SDK Opens.

4. From the menu, select File New Project. Scroll down to the Business Intelligence and Reporting Tools Location, and select Report Project. Click Next.

5. Type in a project name and click Finish.

6. The BIRT Report designer within Eclipse SDK Displays.

3. Configuring BIRT Report Designer to work with V7 Configuration files

NOTE: Use forward slashes or the Select button when specifying the folder paths in Eclipse.
1. Specify the resource folder location to import the V7 Libraries. A. From the Menu, select Window - Preferences. B. Expand Report Design and select Resource. C. Browse to your local report library location and select Apply.
<maximo>/reports/birt/libraries

2. Specify the templates folder location to import the V7 Templates. A. If not already open, from the menu, Select Window - Preferences. B. Expand Report Design and select Templates. C. Browse to your local report template location and select Apply.
<maximo>/reports/birt/templates

10

3. Disable the Comment Template. A. If not already open, from the menu, Select Window - Preferences. B. Remove the flag from the Generate comment when creating a report design field if it is set.

11

4. Next, import the report project. This will bring the V7 Reports youre your project workspace. A. First, create a project. Click File, New Project. Under Business Intelligence and Reporting Tools, select Report Project. Click Next.

B. Enter a Project Name. Remove the flag in the Use Default Location field. Finally, Browse to the location of your V7 Report Source. <V7>\reports\birt\reports. Click Finish.

12

C. The report project is imported.

13

D. To confirm that the reports imported, expand a folder and then double click on an rptdesign file to open it. In the screenshot below, INVENTOR folder was expanded, and the inventory_balance_tbl.rptdesign file selected.

E. Finally, you can confirm that the correct project is imported. To do this, right click on the Project. *NOTE: The location should be your V7 Report Source. It should not be under an Eclipse directory.

Also, a .project file will be created under your <V7>\reports\birt\reports directory.

14