Previous Topic Next Topic

Lesson 5: Creating a Table Report

This topic introduces how to create a Table Report.

The Jinfonet Gourmet Java company receives orders from customers in different territories around the world, and by reviewing this shipping information the Shipping Department can receive bids from various shipping vendors. You are assigned the task of creating a shipment information report. In the report, the shipment details, including order ID, order date, ship date, shipping cost, whether the payment has been received, and the shipping vendor, need to be reported for each territory.

The following prototype of the report has been given to you:

This report will be run online by employees in the Shipping Department. The interactive functionalities of Logi JReport page reports allow end users to change the view of the reports, filter the data, change the sort order, search the report and so on. Each end user can get the data he needs from a single report.

Follow the tasks below to finish creating the report:

• Task 1: Create the Table
• Task 2: Add a Web Control to the Report
• Task 3: Add Objects and Rdit their Properties

Task 1: Create the Report

Before taking this task, make sure you have enabled the Insert field name label with field option in the Options dialog as described at the last step of Lesson 3. Otherwise, the name labels will not be inserted together with the fields when you add fields to the table.

1. In Logi JReport Designer select File > New > Page Report.
2. In the Select Component for Page Report dialog, select Table (Group Above) and select OK.

   Be sure that JinfonetGourmetJava.cat is specified as the current catalog because it is the catalog we use in this track. For information about specifying this catalog, see Task 1, Step 2 and 3 of Lesson 1.

3. In the Data screen of the Table Wizard, select <New Query...> in the Queries node of Data Source 1, input ShipmentDetailsbyCustomer in the Enter Query Name dialog and select OK.
4. In the Add Tables/Views/Queries dialog, expand the JDBC connection node and then the Tables node, then select the tables Customers and Orders and select to add them to the query. Select OK to close the dialog.
5. In the Query Editor, the two tables are joined together automatically on the Customers_Customer ID and CustomerID_FK1 columns.

   

6. Check all the columns in the Orders table by selecting the * checkbox. For the Customers table, check the following columns: Customer Name, Customers_State, Customers_Country, Customers_Territory and Customers_Region.
7. Select OK at the bottom of the Query Editor to create the query. Then select Next in the Table Wizard.
8. In the Display screen, add the fields Orders_Order ID, Order Date, Ship Date, Ship Via, Payment Received and Shipping Cost to the table by selecting them and selecting one by one.

By default, the records in a table are displayed randomly; they are displayed in the order they are returned from the fetch operation. You can specify that Logi JReport sort the records in a table, and also within the groups in table if any, according to your requirement. In this lesson, we will make the records in the table sorted by order ID ascendingly.

1. Select the Sort Fields By button at the right bottom corner of the Display screen. In the Sort Fields By dialog, select Orders_Order ID in the Resources box and select to add it as the sort by field, then select OK to return back to the table wizard.

   

2. Select Next in the Table Wizard to display the Group screen.

Since the report is required to display shipment details of each customer in specific territory, we will add two groups to it: first group the report by territory and then by customer name.

1. In the Group screen, add the DBFields Customers_Territory as the first group by field and Customer Name the second one.

   

2. Select Style to switch to the screen and select to display the report in the Classic style vertically.
3. Select Finish to create the report.
4. Select the View tab to preview the report and it appears as follows:

   

The required report has been created, but it is cumbersome to locate the shipment details of specific territories. So our next task is to add web controls to the report so that the end user can easily filter the results of the report.

Task 2: Add a Web Control to the Report

Web controls empower end users of interactive reports to easily modify the report results they are viewing, and are defined by a trigger event, such as select, and a resulting web action.

In this task, we add a Drop-down List web control to the page header panel of the report. It will be used to filter the report records by territory.

1. Select View > Page Header to display the page header panel.
2. In the Report Inspector, select the Page Header Panel node and change its Height property to 1.25.
3. Select Insert > Web Controls > Drop-down List to insert a web control into the panel.

1. Right-click the web control and select Display Type from the shortcut menu.
2. In the Display Type dialog, select the Value cell and then select in it to display the Insert Fields dialog.
3. Select Customers_Territory in the Customers table in the DBField List box and select the Insert button to add it as value of the drop-down list.
4. In the Web Behaviors box, select the Events cell and select Data Change from the drop-down list, then select in the Actions cell.

   

5. In the Web Action List dialog, select the *Filter action and select OK.
6. In the Filter - Web Action Builder dialog, specify to apply the action to TableComp, select the Filter On cell and select Customers_Territory from the drop-down list, then select the Value cell and select MultiValueContainer. Select OK to apply the settings.

   

7. Select OK in the Display Type dialog to confirm the settings.
8. Resize the drop-down list horizontally to make sure the territory name can be displayed completely.

Task 3: Add Objects and Edit their Properties

In this task we will add more labels in the report, one as the report title and the other for data identification. We will also edit the properties of some objects to improve the report appearance.

1. Drag and drop twice from the Basic group in the Components panel to the page header panel to add two labels in it. Resize them and edit their text as follows:

   

2. Select the two labels by holding the Ctrl key on the keyboard and select Format > Bold.
3. Resize the Shipment Details by Customer label, set its Font Size property to 18 and Foreground property to Red in the Report Inspector.

   

4. Select the Order Date and the Ship Date DBFields by holding the Ctrl key on the keyboard and set their Format property to M/d/yyyy in the Report Inspector.
5. Resize the group by fields in the two GH rows, add two labels ahead of them and edit the text of the labels as "Territory:" for the first group by field and "Customer Name:" for the second.
6. Select the four objects in the two group header rows by holding the Ctrl key on the keyboard, set their Foreground property to 0xcc0000.

   

7. Double-click the Orders_Order ID label in the TH row and edit its text to Order ID.
8. Select the Ship Via DBField and resize it to make sure no data get truncated. Do the same to the Payment Received label.

Next, we will apply a different background color to the two group header rows and hide the second group footer row to improve the appearance and layout of the report.

1. In the Report Inspector, select the Table Group Header and Table Group Header 1 nodes from the report structure tree by holding the Ctrl key on the keyboard and set their Background property to 0xf3f3f3.

   

2. Right-click on the second GF row and select Hide from the shortcut menu to hide it.

   

3. On the report tab bar, right-click the report tab and select Rename to rename it to ShipmentDetails.

   

4. Select File > Save to save the report as ShipmentDetailsbyCustomer.cls.
5. Select the View tab to preview the report and it appears as follows:

   

   Note: If the report does not look correct, you can compare it to the final version of the report provided by Logi JReport. To do so, you will need to save and close this catalog and then open the JinfonetGourmetJava.cat catalog file located at <install_root>\Demo\Reports\TutorialReports.

The web controls are powered by Page Report Studio and therefore cannot work in Logi JReport Designer. We can use the Preview as Page Report Result command of Logi JReport Designer to preview this report, however this command is enabled only if the option Server for Previewing Reports was specified when installing Logi JReport Designer.

Select View > Preview As > Page Report Result. The report is then opened in Page Report Studio in the default web browser. Now we can select values from the drop-down list to dynamically change the report results. In the report below, we choose to view records in the Mexico territory.

You can go to Creating and Performing Data Analysis on Page Reports in the Quick Start part to get more details about working with Page Report Studio.

Previous Topic Next Topic