Tutorial 1: Creating a simple BIRT design
This section provides step‑by‑step instructions for creating a simple BIRT design that lists customers and their contact information. The design uses a standard template and a BIRT data object data source.
In this tutorial, you perform the following tasks:
*Start Report Studio.
*Select a template and a data source.
*Select the data to display in the BIRT design.
*Limit the data displayed.
*Sort data in a meaningful order.
*Format the data in the BIRT design to enhance its appearance.
*Save and view the BIRT design.
Task 1: Starting Report Studio
To access Report Studio, contact your system administrator to obtain the URL to access the Actuate Report Studio component.
1 Choose Actuate Report Studio to launch Report Studio.
Report Studio appears in a web browser, providing the option to either create a new design or open an existing design. In this tutorial, you create a new BIRT design.
2 Choose New to create a new BIRT design. Report Template appears. A series of dialog boxes guides you through the report creation process.
Task 2: Selecting a template and a data source
Report Studio provides sample templates and data sources to enable you to create a variety of reports. This tutorial assumes that access to information objects and data objects is enabled and custom data objects are available in the file repository. In this task, you select the standard single table template to create a simple listing report, and a custom BIRT data object data source in the file repository.
In Report Template, perform the following tasks:
1 In Category, if necessary, select Standard.
2 In Available Templates, if necessary, select Single Table.
3 In Themes, if necessary, select Modern.
Choose OK.
4 Data Source appears. In Select a Data Source, select BIRT Data Objects, as shown in Figure 1‑2. Choose OK.
Figure 1‑2 Selecting a BIRT data object data source
Select Data appears, as shown in Figure 1‑3.
Figure 1‑3 Selecting a data source
5 In Available Data, in Project Root, navigate to the folder containing the data object to use and select the data object. Choose the right arrow. The selected data object appears in Selected Data.
Choose OK.
6 In Select Data Set, shown in Figure 1‑4, select Customers. Choose OK.
Figure 1‑4 Selecting a data set
Table Builder appears displaying the available data fields in the selected BIRT data object.
Task 3: Selecting the data to display
In this task, you use Table Builder to select data fields to use in your new BIRT design.
In Table Builder, shown in Figure 1‑5, complete the following steps:
1 In Data, in Use Data From, if necessary, select the Customers data set.
2 If necessary, deselect Use Default Hyperlink.
This option appears highlighted when the data set you are using contains hyperlinks to other sections in a BIRT design, other BIRT designs in your repository, or external URLs.
3 In Fields, if necessary, deselect Summarize, to create a detail table.
You select Summarize when you want to create a summary table that displays only aggregate data.
4 In Available Data, press Ctrl, and select the following data fields from the list, then choose the right arrow:
*Customer name
*Customer number
*Credit limit
*Contact last name
*Contact first name
*Customer phone
*Customer address
*Customer city
*Customer state
*Customer zip code
Figure 1‑5 Current Column Selections displaying the selected data fields
The selected data fields appear in Current Column Selections, as shown in Figure 1‑5. You can modify the order of data fields by using the up and down arrows in Table Builder—Data.
If the data source contains a large number of data fields, to search for a data field by name or using a string, type the name of the field or the string in Find, then choose Apply. You can use the wildcard character (*) if you are using a string. If the data field is found, Table Builder displays the data field, and the category containing the data field in Available Data. Select the field and use the right arrow to use the data field in the BIRT design.
Task 4: Limiting the data displayed
You can now specify a filter condition if you want to limit the data retrieved from the data set and displayed in the report. Using filters is useful when working with data sets that contain large amounts of data. You can use Table Builder—Filter to specify a filter at the data set level. The following example sets a filter condition such that only data for the country USA is retrieved from the data set.
1 In Table Builder, select Filter.
2 In Table Builder—Filter, choose Add Filter, shown in Figure 1‑6.
Figure 1‑6 Adding a filter condition at the data set level
3 Filter appears. In Filter, complete the following steps:
1 In Filter By, select Customer Country, the column to evaluate.
2 In Condition, if necessary, select the comparison operator, Equal To.
3 In Value, do one of the following:
*Type USA.
*Choose Select Values, then select USA from the list of values.
4 Choose Add Condition. The condition appears in Conditions, as shown in Figure 1‑7. Choose Validate. After a message appears confirming that the syntax of the filter condition is valid, choose OK.
Figure 1‑7 Specifying a filter condition
The filter condition appears in Table Builder—Filter, as shown in Figure 1‑8. Choose OK.
Figure 1‑8 Specifying a data set filter condition
The data fields that meet the filter condition appear in the BIRT design, as shown in Figure 1‑9.
Figure 1‑9 Report Studio displaying the BIRT design
Task 5: Sorting data
In this task, you improve the appearance and usability of the BIRT design by sorting data alphabetically by customer name.
How to sort data
Select and right‑click the customer name column. Choose SortSort Ascending, as shown in Figure 1‑10.
Figure 1‑10 Selecting the sort option
The BIRT design displays data arranged alphabetically by customer name.
Task 6: Formatting the BIRT document
In this task, you edit column labels and the report title. You hide visible report elements that you do not want to display in your BIRT design. When you create a new report from a template, all items in the template appear by default in the report. If you do not want an item, such as a report‑generation date or a label to appear in the report, you can hide the item. You also change the page layout to better fit the data in your report by using the following techniques:
*Changing the layout type, page size, and orientation
*Adjusting the widths of the columns
You also improve the presentation of the report by creating a new computed column to show the contact first name and last name in a single column, formatting the Credit Limit column as currency in US dollars ($) and applying a custom string format to values in the Phone column.
How to edit a column label
1 Double-click the CUSTOMERNAME column label. Then, select the label and press Delete.
2 Type:
Customer Name
Then, press Enter.
3 Similarly, change the CUSTOMERNUMBER column label to Customer ID, CREDITLIMIT label to Credit Limit, PHONE label to Phone, the ADDRESSLINE1 label to Address, the CITY label to City, the STATE label to State, and the POSTALCODE label to Zip Code.
How to create a report title
1 Double-click the report title placeholder. Then, select Double‑click to Add a Report Title, and press Delete.
2 Type:
Customer directory
Then, press Enter.
The BIRT design now looks like the one shown in Figure 1‑11.
Figure 1‑11 Modifying column labels and the report title
How to select the items to hide or display
In this task, you hide the table header in the BIRT design.
Choose ViewHide Table Header, as shown in Figure 1‑12. To hide additional items in the template, select the item from the list.
To select the items to display in the report, in the View menu, select each item to display in the list that appears.
Figure 1‑12 Report items included in a template
How to set the layout type, page size, and orientation
1 Choose FilePage Setup, as shown in Figure 1‑13.
Figure 1‑13 Selecting the Page Setup option
2 Set the following options, as shown in Figure 1‑14:
1 In Orientation, select Landscape, to accommodate the selected data columns on a standard page. When you choose Auto, Report Studio sets the page orientation depending on whether the report is longer or wider.
2 In Layout Preference, select Fixed Width to set the page width and precise column widths yourself. You use the Auto Expand Width option to allow Report Studio to set column widths based on the other page options you select and on the number of columns in the table.
3 In Paper Size, if necessary, select US Letter.
4 In Margin, if necessary, set the size value to 0.5 inch, in Top, Bottom, Left, and Right.
Figure 1‑14 Specifying page setup options
Choose OK.
How to set column widths
If you want to control precisely the widths of columns in a table, first set the Layout Preference property in Page Setup to Fixed Width. The option to set a column’s width is not available if the layout type is Auto Expand Width.
1 Select and right‑click the Customer Name column, then choose ColumnColumn Width.
2 In Column Properties, as shown in Figure 1‑15, in Column Width, type:
1.5
3 In the next field, if necessary, select inches.
Figure 1‑15 Setting a column’s width using Column Properties
Choose OK.
How to display first and last names in the same column
In this task, you create a computed column that concatenates values in two columns in a report design.
1 Select and right‑click the CONTACTFIRSTNAME column. Choose ColumnNew Computed Column.
2 Calculation appears. In Calculation, perform the following tasks:
1 In Column Label, type:
Contact
2 In Enter Expression, type [. Then, select CONTACTFIRSTNAME from the list that appears.
3 Type an ampersand (&), followed by a space enclosed in double quotation marks ('' ''), followed by another ampersand (&), and a left bracket, ( [ ).
4 Select CONTACTLASTNAME from the list that appears. The final expression looks similar to the following one:
[CONTACTFIRSTNAME]&" "&[CONTACTLASTNAME]
5 Choose Validate to verify that there are no syntax errors in the expression. After a confirmation message appears, as shown in Figure 1‑16, choose OK.
The Contact column appears in the report design.
3 In the BIRT design, press Ctrl and select the CONTACTFIRSTNAME and CONTACTLASTNAME columns. Choose Delete. The columns no longer appear in the BIRT design.
Figure 1‑16 Creating a new column displaying contact first and last names
How to format currency values
In this task, you format numeric data as currency in US dollars, with two decimal places.
1 Select and right‑click the Credit Limit column. Choose FormatFormat Data.
2 Number Column Format appears. In Number Column Format, perform the following tasks, as shown in Figure 1‑17:
Figure 1‑17 Formatting currency values
1 In Format Number as, choose Currency from the list.
2 Accept the default selection for each field listed in Table 1‑1.
Table 1‑1 Default selections for number column format
Field
Default selection
Symbol
$
Symbol Position
Before
Separator
Selected
Negative Numbers
-1234.56
3 In Decimal places, select 2 from the list.
How to format a data string
You format string data as telephone numbers using a custom format code.
1 Select and right‑click the Phone column. Choose FormatFormat Data.
2 String Column Format appears. Complete the following steps:
1 In Format String as, select Custom.
2 In Format Code, as shown in Figure 1‑18, type:
(@@@) @@@-@@@@
Choose OK. All telephone numbers in the report design are formatted based on the specified format code.
Figure 1‑18 Specifying a custom format pattern
3 Set the width of the Phone column to 1.25 inches to accommodate each phone number on a single row.
The BIRT design displays the formatted data columns, as shown in Figure 1‑19.
 
Figure 1‑19 Examining a formatted BIRT design
Task 7: Saving and viewing a BIRT design
You save a BIRT design to a folder in your file repository. Your access privileges determine the folders in which you can save a report. Once the BIRT design is saved, Actuate Viewer displays the report with actual data.
How to save and view a BIRT design
1 Choose Save and View. The first time you save a BIRT design, Save As appears, as shown in Figure 1‑20. This dialog box typically displays the user’s home folder.
2 In Save in, if necessary, navigate through the folder structure to select a different folder.
3 If you know the name of the existing file you want to overwrite, type the name or relevant keywords in Search. Then, press Enter, or choose Find. Save Report Design displays the reports that match the string you provided.
4 In File Name, type:
Customer_directory
The file name can contain alphanumeric characters and spaces, but it cannot contain punctuation.
File Type shows that the report is saved as an Actuate BIRT report design file with a .rptdesign file‑name extension. Choose OK.
Figure 1‑20 Save Report Design
Actuate Viewer generates and displays the report, as shown in Figure 1‑21.
Figure 1‑21 Actuate Viewer displaying a completed BIRT design