Rich Reports
This topic describes rich reports in the StarTeam Cross-Platform Client.
About Rich Reports
The StarTeam Cross-Platform Client offers rich reports based on the BIRT report designer to create custom reports. You can easily select your data source and tables and fields from the StarTeam schema to customize your report.
For more information about BIRT reports and the BIRT report designer, refer to http://eclipse.org/birt/.
Note: Rich reports follow the same naming convention as the classic reports. When you are finished creating your report, move the .rptdesign file created with BIRT into the same folder as the classic reports so that it is available to run within the StarTeam Cross-Platform Client.
Create a New Report
To create a rich report in the StarTeam Cross-Platform Client, do the following:
-
Open the StarTeam Reports dialog box by right clicking an item and selecting Reports.
The Reports dialog box opens.
- Select the Rich Reports option.
- Enter in a name in the Output file name field.
- Enter a title in the Report title field.
-
To configure the report, click Open Report Editor.
The BIRT Report Designer opens.
-
Click File > New > Report.
The New Report dialog box opens.
- Select the folder for the report and enter the File name.
- Click Next.
- On the Report screen, select the type of report to create from the Report templates list.
- Click Finish.
Create the Data Source
To create a data source for a rich report, do the following:
- From the BIRT Report Designer, click Data > New Data Source.
- On the New Data Source page, select StarTeam Data Source.
- In the Data Source Name field, enter the data source name. For example: localhost.
-
Click Next.
The New StarTeam Data Source Profile page open.
-
Enter the following fields for the data source:
Server Address Address of the StarTeam Server. For example: localhost. TCP/IP Endpoint Port of the server. Project The name of the StarTeam project to use. View The name of the StarTeam view to use that exists in the project specified above. User name The StarTeam user to log in as. Password The user's password. - Click Finish.
Create the Data Set
To create a data set for a rich report, do the following:
- From the
BIRT Report Designer, click
Data > New Data Set.
The New Data Set page opens.
- Select an existing Data Source.
- Select StarTeam Data Set as the Data Set Type.
- Enter a name in the Data Set Name field.
-
Click Next.
The Select Query page opens.
- Use the
Select Query page to model commands that you would use in the command line. Restrictions on this page are based on how some types will or will not work with other queries or types.
The
Query Text field is editable and allows you to create your own (advanced) query. For example, you can build a
where
clause with property names:select * from File where propertyNameA ="A" and propertyNameB="Bla"
. You can also restrict the columns returned by sayingselect propertyNameA, propertyNameB from file
.If the server is down when you open the Data Set page, an error is displayed and all fields will be disabled except for Query Text. This is because many fields retrieve from the server. You can still edit/save the Query Text.
If you share a report with another user, the DataSource credentials will only decrypt if you have the same user name. If you try to edit the data set or data source, an error will be reported telling you that decryption failed and to re-enter the credentials.
- Click Check when you are satisfied with your query. You will be notified of the results.
-
Click Finish.
The Output Columns page opens.
-
Use the Output Columns page to change display names or change types.
The Edit button allows you to change the default fields for the data set. For example, you could change the display name of a column or change a string data type to an Integer data type, as long as the format is correct.
-
Click OK.
The Preview Results page opens with your results.
-
Click OK.
BIRT will display all columns in the tree, allowing you to drag them onto the report, create charts, or use any other BIRT functionality that you need.