bird instal

8/3/2019 Bird Instal

1/14

1

This document provides additional details on configuring BIRT ReportDesigner 212 for the V7 Releases. These details are a supplement to theReport Development Guide (mam71_report_dev_guide.pdf, orccmdb_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


2/14

2

1. Installing V7 Design Files for BIRT

To perform the next steps, you will need a local copy of V7, with the reportsource.

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\reports\birt\scriptlibrary\classes

2. Navigate to the location beloweclipse\plugins\org.eclipse.birt.report.viewer_2.1.2.v20070205-1728\birt\WEB-INF

A. Create a classes folderB. Copy the entire \com folder from step 1 toeclipse\plugins\org.eclipse.birt.report.viewer_2.1.2.v20070205-1728\birt\WEB-INF\classes

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

4. Open the copied mxdatasources.properties file, and edit if for your localconfiguration:

a) Set the URL, driver, username, password, and schemaownerproperties for your local environment following the sample formatsprovided.

b) Change # to maximoDataSource.


3/14

3

Notes:A. The mxdatasources.properties file is only required by the reportdesigner; at runtime the connection info will be set from Maximo.

B. A sample of this file for DB2 is shown below:#.=value

# driver for ORACLE# oracle.jdbc.driver.OracleDriver# sample url for ORACLE# jdbc:oracle:thin:@::

# 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/ HARRIERmaximoDataSource .driver=com.ibm.db2.jcc.DB2DrivermaximoDataSource .username=maximo

maximoDataSource .password=maximo

The values in red point to a sample local database. You can check yours and other availablefor you to choose from Start Menu\Programs\IBM DB2\Set-up Tools\ConfigurationAssistant.

The key name in green is the default set for all reports, you have to use exactly this text.


4/14

4

5. Copy the JDBC driver(s) from\applications\maximo\lib or from the attached zip file

to: eclipse\plugins\org.eclipse.birt.report.viewer_2.1.1.v20070205-1728\birt\WEB-INF\lib

These drivers are only used by the designer.

Note: For Oracle, use oraclethin.jarFor SQL Server, use opta.jarFor DB2, use db2jcc.jar and db2jcc_license_cu.jar


5/14

5

2. Accessing the BIRT Designer

1. Create a shortcut to eclipse.exe. Be sure to include the following pathpointing to your JDK 1.5 install highlighted in red in the target for the

shortcut.

C:\eclipse_download\BIRT\eclipse\eclipse.exe -vm "C:\programfiles\IBM\Java50\bin\javaw.exe" -vmargs -Xmx512m


6/14

6

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

3. Eclipse SDK Opens.


7/14

7

4. From the menu, select File New Project. Scroll down to the BusinessIntelligence and Reporting Tools Location, and select Report Project. ClickNext.


8/14

8

5. Type in a project name and click Finish.

6. The BIRT Report designer within Eclipse SDK Displays.


9/14

9

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.

/reports/birt/libraries


10/14

10

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./reports/birt/templates


11/14

11

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.


12/14

12

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 Locationfield. Finally, Browse to the location of your V7 Report Source.

\reports\birt\reports. Click Finish.


13/14

13

C. The report project is imported.


14/14

14

D. To confirm that the reports imported, expand a folder and then doubleclick on an rptdesign file to open it. In the screenshot below, INVENTORfolder 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 ReportSource. It should not be under an Eclipse directory.

Also, a .project file will be created under your \reports\birt\reportsdirectory.

bird instal

Documents