tutorial 1: building a simple listing report · 2. in birt report designer, under enter or select...

30/04/2012 Help - Rational Software Architect for WebSphere Software

1/18publib.boulder.ibm.com/infocenter/rsawshlp/v7r5m0/index.jsp?topic=%2Forg.eclipse.birt.doc%2Fbirt%…

Tutorial 1: Building a simple listing report

This section provides step-by-step instructions for building a report that lists customer names, phone numbers, and contactnames. The report uses data from the sample database that is supplied with BIRT Report Designer, Classic Models.Figure 1-1 shows a portion of the finished report.

Figure 1-1 Report listing customer names, phone numbers, and contacts

In this tutorial, you perform the following tasks:

Create a new project. If you are using BIRT RCP Report Designer, you do not complete this step.

Create a new report.

Build a data source.

Build a data set.

Lay out the report to display each row of the data set.

Sort the data.

Format the report to enhance its appearance.

Create a report title.

Task 1: Create a new project

Eclipse organizes files by projects. You can create one project to organize all your reports or create multiple projects toorganize your reports by categories. For each project that you create, Eclipse creates a directory in your file system.

If you are using BIRT RCP Report Designer, this task does not apply to you.

1. Choose File->New->Project. New Project, which appears in Figure 1-2, displays the types of projects that you cancreate.



Figure 1-2 New Project

2. Expand Business Intelligence and Reporting Tools, select Report Project, then choose Next.

3. On New Report Project, in Project name, type the following text, as shown in Figure 1-3:

My Reports

Figure 1-3 New Report Project

4. To add the project, choose Finish. You can now see the project in the Navigator view, as shown in Figure 1-4.

Figure 1-4 A project in the Navigator view



Task 2: Create a new report

You can create a report in the following ways:

Start with a blank report design.

Use a predefined report template.

For each template, BIRT Report Designer provides a cheat sheet, which contains step-by-step instructions, to helpyou create the report.

For this tutorial, you start with a blank report design.

1. Choose File->New->Report. New Report appears. Figure 1-5 shows the window that appears in BIRT ReportDesigner. New Report is slightly different in BIRT RCP Report Designer.

Figure 1-5 New Report in BIRT Report Designer

2. In BIRT Report Designer, under Enter or select the parent folder, select the project that you created. This stepapplies only to BIRT Report Designer users.

3. Type the following text as the file name:

Customers.rptdesign

4. Choose Next. New Report provides options for starting with a blank report and several report templates, as shown inFigure 1-6.

Figure 1-6 Report templates in New Report



5. Select Blank Report, then choose Finish. Your new report appears in the main window. This window displays thelayout editor, as shown in Figure 1-7. The layout editor shows an empty report page.

The remainder of this tutorial provides the detailed steps for creating the customer report.

Figure 1-7 Blank report design

Task 3: Build a data source

Before you begin designing your report in the layout editor, you build a BIRT data source to connect your report to adatabase or other types of data sources. When you build a data source, you specify the driver class, data source name, andother connection information that is specific to the type of data source. For this tutorial, you use the sample database,Classic Models, that is already configured for use with BIRT Report Designer. You do not need to specify the connectioninformation for this sample database.

1. Choose Data Explorer. If you use the default report design perspective, Data Explorer is on the left of the layouteditor, next to Palette, as shown in Figure 1-8. If it is not open, choose Window->Show View->Data Explorer.

Figure 1-8 Data Explorer

2. Right-click Data Sources, then choose New Data Source from the context menu. New Data Source displays thetypes of data sources you can create, as shown in Figure 1-9.



Figure 1-9 New Data Source

3. Select Classic Models Inc. Sample Database from the list of data source types. Use the default data source name,then choose Next. Connection information about the new data source appears.

4. Choose Finish. BIRT Report Designer creates a new data source that connects to the sample database. It appearswithin Data Sources in Data Explorer, shown in Figure 1-10.

Figure 1-10 Data Sources in Data Explorer

Task 4: Build a data set

Now, you are ready to build your data set. A data set identifies the data to retrieve from the data source. If your reportconnects to a JDBC data source, you use a SQL SELECT statement to identify the data to retrieve.

1. In Data Explorer, right-click Data Sets, and choose New Data Set from the context menu.

2. On New Data Set, in Data Set Name, type the following text, as shown in Figure 1-11:

Customers

Figure 1-11 New Data Set



3. Use the default values for the other fields:

Data Source shows the name of the data source that you created earlier.

Data Set Type indicates that the data set uses a SQL SELECT query.

4. Choose Next.

Query displays the information to help you create a SQL query. Available Items lists all the tables in the ClassicModels database. You can click the plus (+) sign next to a table to display the columns in the table. The text area onthe right side of this dialog shows the required keywords of a SQL SELECT statement:

select from

5. In the text area, type the following SQL SELECT statement to specify the data to retrieve:

select customerName, contactLastName, contactFirstName, phone from Customers

Although the data set editor shows table and column names in uppercase letters, you can type these names howyou prefer, because SQL is not case-sensitive. If you do not want to type the query, you can drag columns and tablesfrom Available Items to the text area.

The SELECT statement that you created, which is shown in Figure 1-12, gets values from the CUSTOMERNAME,CONTACTLASTNAME, CONTACTFIRSTNAME, and PHONE columns in the CUSTOMERS table.

Figure 1-12 SQL SELECT statement in Edit Data Set

6. Choose Finish to save the data set. Edit Data Set displays the columns you specified in the query, and providesoptions for editing the data set.

7. Choose Preview Results to make sure the query is valid and that it returns the correct data. If you typed the SELECTstatement correctly, you should see the results that are shown in Figure 1-13. These are the data rows that the queryreturns.



Figure 1-13 Data rows returned by a SQL SELECT statement

8. Choose OK.

Task 5: Lay out the report

In this procedure, you insert elements in the report page to display the data from the data set that you created previously.You start by inserting a table element, then you insert data elements in the table. It is important to understand thefunctionality that the table provides:

The table iterates through all the data rows that a data set returns.

It enables you to lay out data easily in a row and column format.

1. Choose Palette. The palette displays all the elements that you can place in a report.

2. Drag a table element from the palette, and drop it in the report in the layout editor. Insert Table prompts you to specifythe number of columns and detail rows to create for the table. The dialog also prompts you to select a data set tobind with the table.

3. On Insert Table, specify the following values, as shown in Figure 1-14.

In Number of columns, type 3.

In Number of details, type 1.

In Data Set, select Customers from the drop-down list.

Figure 1-14 Table properties in Insert Table

Choose OK. A table with three columns and one detail row appears in the layout editor. Now, you are ready toinsert data in the table.

4. Choose Data Explorer.

5. In Data Explorer, expand Data Sets, then expand Customers. The columns that you specified in the query appearbelow Customers.

6. Drag CUSTOMERNAME from Data Explorer, and drop it in the first cell in the table's detail row, as shown in Figure 1-15. The detail row displays the main data in the report. In the finished report, the detail row repeats to display all thedata rows from the data set.



Figure 1-15 Dragging a column from Data Explorer, and dropping it in a table cell

In the layout editor, the table cell in which you dropped the CUSTOMERNAME field contains a data element thatdisplays [CUSTOMERNAME]. Above this data element is a label element that the layout editor automatically added tothe header row. This label displays the field name as static text. It serves as the column heading. Figure 1-16 showsthe data and label elements.

Figure 1-16 Data and label elements in a table

7. Drag PHONE from Data Explorer, and drop it in the second cell in the detail row.

8. Drag CONTACTFIRSTNAME, and drop it in the third cell in the detail row.

9. Drag CONTACTLASTNAME, and drop it in the third cell in the detail row, below CONTACTFIRSTNAME. The reportpage should look like the one shown in Figure 1-17.

Figure 1-17 Customer and contact information added to a table

10. Choose Preview, the tab at the bottom of the layout editor. BIRT Report Designer generates and displays the reportin HTML format, as shown in Figure 1-18. Scroll down to see the entire report. You can also preview a report in PDF.You do so by choosing File->View Report->View Report as PDF from the main menu bar.

As Figure 1-18 shows, the data is correct, but it appears in random order. It makes more sense to sort the dataalphabetically by customer name. The report's appearance also needs improvement.



Figure 1-18 Preview of report data

Task 6: Sort the data

When you first create and preview a report, the report displays the data rows in the order in which the query returns them.The order can vary, depending on many factors, such as how data was supplied in the data source. In most cases, you willwant to change the order in which data appears in the report.

1. Choose Layout to return to the layout editor.

2. Open Property Editor, if necessary. If you use the default report design perspective, Property Editor appears belowthe layout editor. If it is not open, choose Window->Show View->Property Editor.

3. In the layout editor, select the table by selecting the Table tab in the lower left corner. This tab appears when youhover the mouse pointer over this area. Property Editor displays the properties for the table, as shown in Figure 1-19.

Figure 1-19 Property Editor

4. Choose the Sorting tab.

5. Choose Add to specify a sort key.

6. On New Sort Key, specify the following values:

In Key, select CUSTOMERNAME from the drop-down list.

In Direction, use the default value, Ascending.

Figure 1-20 shows the sort definition.



Figure 1-20 Sort definition in New Sort Key

Choose OK. The Sort page displays the sort key that you defined for the table.

7. Preview the report. The sorted data appears in ascending order by customer name, as shown in Figure 1-21.

Figure 1-21 Data sorted by customer name

Notice that names with uppercase letters appear at the top of the list. BIRT sorts string data by UCS2 code pointvalues. In ASCII-based character sets, uppercase letters have lower code point values than lowercase letters.Therefore, uppercase letters appear before lowercase letters.

8. Sort the customer names case-insensitively so that ANG Resellers appears after American Souvenirs Inc., ratherthan before.

1. On the Sort page, shown in Figure 1-22, select the sort key, then choose Edit.

Figure 1-22 Sort key displayed on the Sort page

2. On Edit Sort Key, change the Sort Key expression to the following expression, then choose OK:

row["CUSTOMERNAME"].toUpperCase()

This expression uses the JavaScript toUpperCase( ) function to convert all the customer name values touppercase before sorting. JavaScript function names are case-sensitive, so you must type toUpperCase( )exactly as shown. References to column names are also case-sensitive. In this expression,row["CUSTOMERNAME"] is the correct name to use. If you type row["customername"], for example, BIRTReport Designer displays an error when you run the report. You can verify the capitalization of a column name



by looking at the name that is displayed in Data Explorer.

9. Preview the report. The customer names appear in a different order. Names with uppercase letters do not appear atthe top of the list.

Task 7: Format the report

Now that you verified that the report displays the correct data in the correct order, you can turn your attention to improving thereport's appearance. You perform the following tasks in this section:

Edit the text of the column headings.

Format the column headings to differentiate them from the data rows.

Display the contact first and last names on the same line.

Increase the space between rows.

Edit the column headings


2. Double-click the first column heading, CUSTOMERNAME. The column heading is in the first row--the header row--ofthe table.

3. To replace all the highlighted text, start typing, then press Enter when you finish. To edit the text, click once todeselect the text, then position the cursor where you want to add or delete characters.

Replace CUSTOMERNAME with the following text:

Customer

4. Repeat steps 2 and 3 to change the second and third column headings to the following text:

Phone Contact

The report design should look like the one shown in Figure 1-23.

Figure 1-23 Revised column headings in a report design

Format the column headings

To format a report element, you set its properties. You can accomplish this task in two ways:

Set an element's properties through Property Editor.

Define a style that contains the desired properties, and apply the style to an element. Use this method to defineformat properties once and apply them to more than one element.

In this procedure, you use the first method to set the column headings to bold, and the second method to add color to theheader row.



1. To set the column headings to bold using Property Editor:

1. Select all the column headings. To select multiple elements, press the Shift key as you click each element.Property Editor displays the properties for the selected elements, as shown in Figure 1-24.

Figure 1-24 Properties for selected elements in Property Editor

2. Choose B to format the column headings as bold text.

3. To deselect the column headings, click the white space outside the table.

2. To add a background color to the header row, using a style:

1. From the main menu bar, choose Element->New Style.

New Style appears, as shown in Figure 1-25. The left side displays the property categories. The right sidedisplays the properties for the category that you select.

Figure 1-25 New Style

2. For Custom Style, specify the following name for the style:

table_header_row

3. Choose Background from the list of property categories. New Style displays the background properties thatyou can set.

4. Specify a color for the Background Color property, using one of the following methods:

Select the button next to the property, then select a color from the color palette that appears.



Select a color from the drop-down list.

Choose OK.

5. In the layout editor, select the table by selecting the Table tab in the lower left corner. This tab appears whenyou hover the mouse pointer over the lower left corner of the table. Clicking the table causes guide cells toappear at the top and left side of the table, as shown in Figure 1-26.

Figure 1-26 Guide cells at top and left of a table

6. Select the guide cell next to the header row. Property Editor displays the properties for the selected row.

7. Choose Properties then General to display the general properties for the row.

8. Apply the style that you just created by selecting table_header_row from the drop-down list next to Style. BIRTReport Designer applies the style to the header row and it appears in color.

3. Preview the report. The report should look like the one shown in Figure 1-27.

Figure 1-27 Report preview, showing header row style

So far, the main improvement is that the headings are clearly visible and defined.

Display first and last names on the same line

When you place multiple elements in a single cell, BIRT Report Designer creates block-level elements. If you are familiarwith HTML, you know that each block element starts on a new line. To display multiple elements on the same line, you needto set them as inline elements. Alternatively, you can concatenate the first and last name values to display in a single dataelement, as described in this procedure.


2. Delete the data element that displays [CONTACTLASTNAME].

3. Double-click the data element that displays [CONTACTFIRSTNAME].

Edit Data Binding, shown in Figure 1-28, shows information about the data associated with the current dataelement. In Expression, dataSetRow["CONTACTFIRSTNAME"] indicates that the data element displays data from theCONTACTFIRSTNAME field in the data set.



Figure 1-28 Edit Data Binding

4. Click the expression builder button next to dataSetRow["CONTACTFIRSTNAME"].

The expression builder displays the expression in the text area at the top of the window.

5. To concatenate the first and last names, edit the expression as follows:

dataSetRow["CONTACTFIRSTNAME"]+" "+ dataSetRow["CONTACTLASTNAME"]

Figure 1-29 shows this expression in the expression builder. The empty quotation marks (" ") add a space betweenthe first name and last name. You can type the expression in the text area, as shown in Figure 1-29, or double-clickan item in the lower right of the window to insert it in the expression. Figure 1-30 shows a column name that you candouble-click to insert into the expression.

Figure 1-29 Concatenated data in the expression builder

Figure 1-30 Concatenated data in the expression builder created by choosing a data set field

6. Choose OK to close the expression builder.

The edited expression appears in Edit Data Binding. Choose OK to save the changes to the data element.

7. Preview the report. The report should look like the one shown in Figure 1-31.



Figure 1-31 Report preview, showing concatenated contact names

Increase the space between rows

The default layout adds a minimum space between table rows. Typically, you will want to adjust the spacing between rows.


2. Select the table's detail row, the middle row, as shown in Figure 1-32.

Figure 1-32 Selected table row in the layout editor

Property Editor displays the properties for the row. The title that appears in Property Editor shows the type of elementthat you select, so you should see Property Editor - Row.

3. In the General properties, set Height to 24 points. The height of the row increases, as shown in Figure 1-33.

Figure 1-33 Row height set to 24 points



4. Preview the report. The report should look like the one shown in Figure 1-34. There is more space between the rowsof data.

Figure 1-34 Report preview, showing row spacing

Task 8: Create a report title

All your report needs now is a title. To display a title, you can use either a label element, a text element, or a data element:

The label element is suitable for short, static text, such as column headings.

The data element is suitable for displaying dynamic values from a data set field or a computed field.

The text element is suitable for multi-line text that contains different formatting or dynamic values.

In this procedure, you use a text element and HTML tags to format the text. Note that you are not required to use HTML tocreate formatted text. If, however, you are well-versed in HTML or web design, you might prefer using HTML to create a blockof formatted text.


2. Choose Palette.

3. Drag the text element from the palette, and drop it above the table.

4. On Edit Text Item, select HTML from the drop-down list that displays Auto.

When you select HTML, you can embed HTML tags or CSS properties in the text. You can type the tags or you caninsert the commonly used HTML tags that the text editor provides.

5. Specify the following text in the text area, shown in Figure 1-35:

Customer List
For internal use only

Report generated on new Date( )



Figure 1-35 Text with HTML Tags

6. Choose OK, then preview the report. The report should look like the one shown in Figure 1-36.

Figure 1-36 Report preview, showing formatted report title

As you can see, using the text element with embedded HTML enables you to:

Use different formatting for each line in a multi-line text block.

Insert dynamic values, such as the current date.

Alternatively, you can use:

Two label elements to display the first and second lines of static text

A data element to display the third line that contains the dynamic value

Next steps

You just built your first report and worked with some of the basic tools and features of BIRT Report Designer. There aremany more tasks that you can accomplish to build more sophisticated reports. Some of these tasks, described in otherchapters of this book, include:



Connecting to your own data source

Creating charts

Creating cross tabs

Creating report parameters for user input

Building reports that contain subreports

Formatting report elements based on conditions

Hiding report elements or sections based on conditions

Adding hyperlinks to link your report to web locations or to link one report section to another

tutorial 1: building a simple listing report · 2. in birt report designer, under enter or select...

Documents