The Table data region is available in Page and RDLX reports. It is used to display the information in tabular format in Tabular Reports. The Table data region consists of columns and rows that organize data. By default, a table has three columns and three rows, a total of nine cells, where each cell is filled with a text box. At design time, you can add or remove columns, rows, and groupings to suit your needs. Also, you can embed other data regions in the table cells.

Structure

Column is a vertical group of cells in a table. If you right-click a column handler, you can add new columns or delete existing ones using the context menu that appears.

Row is a horizontal group of cells in a table. If you right-click a row handler, you can add new rows or delete existing ones using the context menu that appears.

Cell is the intersection of a row and column. By default, each table cell contains a TextBox report item. But you can replace it with other report controls, such as an Image, by drag-and-drop the corresponding item from the Toolbox into the cell.

Header row appears at the beginning of a table. If its RepeatOnNewPage property is set to 'True', it prints on every page taken by the table content. You could use the header row to display the title or the logo of a tabular report. A table may have several header rows.

Group header row appears at the beginning of a group. If its RepeatOnNewPage property is set to 'True', it prints on every page taken by the table content. You could use a group header row to display the group's field value or summary value. A group may have several header rows.

Details row repeats for each bound dataset record that passed through the dataset filters and data region filters. If a table has the grouped data, then the details row appears between the header and footer of the enclosing group instance. A table may have more than one details row.

Group footer row appears at the end of a group. If its RepeatOnNewPage property is set to 'True', it prints on every page taken by the table content. You could use the group footer row to display summary values. A group may have several footer rows.

Footer row appears at the end of a table. If its RepeatOnNewPage property is set to 'True', it prints on every page taken by the table content. You could use the footer rows to display grand totals.

Table Layout Actions

The Table data region provides context menu options to perform basic layout actions. You can access layout options for Table rows from the context menu by right-clicking on a selected row.

• Insert Row Above: Add a row above the selected row. The inserted row type is similar to the type of selected row, that is, if the selected row type is a header row, a new header row is added.
• Insert Row Below: Add a row below the selected row. The inserted row type is similar to the type of selected row, that is, if the selected row type is a header row, a new header row is added.
• Delete Rows: Delete the selected rows.
• Distribute Rows Evenly: Set the same height for multiple selected rows.
• Table Header: Show or hide table header rows.
• Table Details: Show or hide table detail rows.
• Table Footer: Show or hide table footer rows.
• Insert Group: Insert groups in a table.
• Edit Group: Edit a group in a table.
• Delete Groups: Delete groups in a table.

You can access layout options for Table columns from the context menu by right-clicking on a selected column.

• Insert Column to the Left: Add a column to the left of the selected column.
• Insert Column to the Right: Add a column to the right of the selected column.
• Distribute Columns Evenly: Set the same width for multiple selected columns.
• Add Columns: Add one or more column(s) to the right of the selected column.
• Delete Columns: Delete the selected columns.

Table Dialog Properties

You can set the Table properties in the Table dialog. To open it, with the Table selected on the report, under the Properties window, click the Property dialog link.

Adding Data to Table

Once you place the Table data region on a report, you can add data to its cells. As with any data region, you can drag fields from your Fields list onto cells in the table. Although the default report control within each cell of the table is a text box, you can replace it with any other report control or a data region. When you drag a field into a cell in the details row, ActiveReports automatically provides a label in the table header. As with all report controls, you can use expressions to further manipulate the data within the cells of the table. For more information, see Expressions.

1. From the Toolbox, drag-drop the Table data region onto the design area.
2. From the Report Explorer, expand the DataSet  and drag-drop data fields onto the cells in the details row.  

Alternatively, in the table, select a TextBox in the Details row and, from the Fields Selection Adorner, select a field from the list.

Table Features

Table Grouping

Groups provide a way to organize data and make data analyses easy. In a Table data region, you can also create a document map based on the groups by specifying the group expression in the Document map label option. For information on document map and navigation, see the Document Map topic for more details.

Let us understand grouping using the report shown. The report consists of a Table that displays Movie details – Title, MPAA, and User Rating fields. The report connects to the 'Movie' table from 'Reels.db' data source on GitHub.

You can group the table data according to the other dataset field, 'Year Released', to group the details based on the year when a movie was released.

The following steps add a group in the table using Group On expression. 

1. With the Table data region selected, under the Properties window, click the Property dialog link to open the Table dialog.
   Note: Alternatively, you can add a group by selecting Insert Group in the context menu of the Table data region, and adding a group in the Table - Groups dialog that opens.
2. Go to the Groups page and click Add.
3. Under Group on, enter the expression on which you want to group the data. For e.g.,
   =Fields!YearReleased.Value.
   
4. Click OK to close the dialog. A Group Header and a Group Footer are added as shown.
   
5. Merge the cells in the Group Header row and enter the expression in the Value property as
   =[YearReleased]
   
   This makes the group value appear and span above each group.
6. Preview the report. Here's how the table will look like.
   

Detail Grouping

Another way of grouping the table data is by grouping the Details row without adding a group. The Detail Grouping groups the data in such a way that only one row per distinct grouping value or expression is displayed for each row of data in Details row. Also, it does not add a Group Header and Group Footer. Detail grouping is useful when you do not want the values to repeat within the details as many times as they are present in the data source.

Let us use Detail Grouping to group the table data. For example, we have a report with the Table that displays Movie details – Title, MPAA, and User Rating fields. The report connects to the 'Movie' table from 'Reels.db' data source on GitHub.
   

1. With the Table selected on the report, under the Properties window, click the Property dialog link to open the Table dialog.
2. Go to the Detail Grouping page and, under Group on, enter the expression on which you want to group the data. For e.g.,
   =Fields!YearReleased.Value.
   
3. Click OK to close the dialog.
4. Preview the report. Here's how the table will look like.
   Note that the report size is smaller after applying the Details Grouping since the details row is shown once for every grouping value.
   

Merge Cells

You can combine adjacent cells in horizontal (same row) or vertical (same column) direction into a single cell. Vertical cell merging is possible within the same row type, that is, within the Header, Group Header, Footer, Group Footer, or Details row.

To merge cells,

1. Select the cells (Ctrl+Click) and the right-click.
2. From the context menu, select Merge Cells.

Auto Merge

The AutoMergeMode property lets you set the mode to merge the adjacent cells (text boxes) in details row with the same value. This property takes Always, Never, and Restricted values. The details row with the same data values and with AutoMergeMode property set to:

• Always - are merged.
• Never - are not merged.
• Restricted - are merged only if the corresponding cells in the previous columns are similarly merged. If for example, cells in Column 2 (with same data values) are set 'Restricted' and the corresponding cells (with same the data values) in previous column, that is Column 1, are set 'Never', then cells in Column 2 are not merged.

The following steps take you through how to add automatic merge to the cells in the following table. The report connects to the 'Orders' table from 'NWIND.db' data source on GitHub.

1. Select the cell with EmployeeID field and set the Layout > AutoMergeMode property to 'Restricted'. This merges employee ids depending on whether the corresponding ship names (cells in the previous column) are merged.
2. Select the cell with ShipName field and set the Layout > AutoMergeMode property to 'Always'. This merges the cells with similar ship names.    
3. Preview the report. Here's how the table will look like.
   

Freeze Rows and Columns (RDLX Reports)

When you use a Table data region containing a large amount of data in an RDLX report, the user must scroll to see all of the data. On scrolling the column or row headers out of sight, the data becomes difficult to understand. To resolve this problem, you can use the FrozenRows and FrozenColumns properties that take effect in the JSViewer in Galley mode, and allow you to freeze headers so that they remain visible while scrolling through the data region. You can freeze as many rows or columns as you have headers in the data region.

• If your data stretches downward, set the FrozenRows property to a value to float the column headers when scrolling.
• If your data stretches to the right, set the FrozenColumns property to a value to float the row headers when scrolling.
• If your data stretches both downward and to the right, set both FrozenRows and FrozenColumns properties.

Here's how a report with one frozen column looks like in JS Viewer.

If any header cells that you want to freeze are merged, you should not set the FrozenRows or FrozenColumns property to a value that would split a merged cell.

Nesting in Tables

To display data from different datasets, you can use nested tables that are bound to different datasets. You can do any one of the following to achieve this:

• add a filter to a child table (Filters property) which filters the data in the table data region based on the common field in two datasets
• create a parameter for the child table (DataSetParameters property) that is passed to the dataset query and filters the dataset fields based on the common field in the two datasets 

For example, the following report shows three nested Table data regions that fetch data from three different datasets.

The report connects to the 'NWIND.db' data source on GitHub.

Table1 is bound to 'Products' dataset, Table2 is bound to 'Invoices' dataset, and Table3 is bound to 'Customers' dataset. The parent table, Table1, shows the Product Name and Units In Stock information from the Products dataset. For each ProductID, child table, Table2 shows the Ship Name and Ship Country information from the Invoices dataset. And for each CustomerID, the child table, Table3, shows the Contact Name, City, and Phone information from the Customers dataset.

Let us create this report using both methods.

Using a filter

For the child tables, add a filter using the Filters property as elaborated below:

1. Select Table2 and go to the Filters property.
2. In the Table - Filters, add a filter with the expression =[ProductID]==[ProductID], the common field in the datasets of the parent table and the child table.
   
   
   

Similarly,

1. Select Table3 and go to the Filters property.
2. In the Table - Filters, add a filter with the expression =[CustomerID]=[CustomerID], the common field in the datasets of the parent table and the child table.

Using a parameter

For each child table, we create a parameter to pass to the dataset and then modify the dataset query to filter the dataset fields. 

The following steps elaborate the procedure.

1. Select Table2 and go to the DataSetParameters property.
2. Add a new parameter with Name: Parameter_ProductID and Value: =Fields!ProductID.Value.
    
3. Go to the dataset to which the Table2 is bound, that is, Invoices.
4. In the DataSet designer dialog, go to Parameters and add a new parameter (same name as DataSetParameter): Parameter_ProductID.
   
5. Go to Query and add a substring with the parameter to the existing dataset query so the updated query is:
   select * from Invoices where ProductID = @Parameter_ProductID

Similarly,

1. Select Table3 and go to the DataSetParameters property.
2. Add a new parameter with Name: Parameter_CustomerID and Value: =Fields!CustomerID.Value.
3. Go to the dataset to which Table3 is bound, that is, Customers.
4. In the DataSet designer dialog, go to Parameters and add a new parameter (same name as DataSetParameter): Parameter_CustomerID.
5. Go to Query and add a substring with the parameter to the existing dataset query so the updated query is:
   select * from Invoices where ProductID = @Parameter_CustomerID

Filter, Sort, and Interactive Sort

Filter

Filtering allows you to set filters on a large set of data that has already been retrieved from the data source and use them with datasets or data regions to limit the information you want to display on your report. Although not as efficient performance-wise as query parameters which filter data at the source, there are still scenarios that demand filters. The obvious case is when the data source does not support query parameters.

To apply a filter in a Table data region,

1. Select the table and go to Filters property.
   
2. In the Table - Filters dialog, click Add.
   You can also first go to the Property dialog and then select the Filters page.
3. In the Expression field, select the data field expression (=[UserRating]) available from the dataset to which the table is bound.
4. Select the filter Operator (GreaterThanOrEqual).
5. Enter the Value (say 9) to which the expression should evaluate to filter the data.
6. Click OK.
7. Preview the report. Here's how the table will look like with the 'User Rating' column showing a rating above '9'.
   

Sort

Sorting helps better organize and present data in your report, you can sort alphabetically or numerically in ascending or descending order.

To apply sort in a Table data region,

1. Select the table and click the Property dialog link to open the Table dialog.
   
2. Go to the Sorting page and click Add.
3. In the Expression field, select a value to sort the report data (for example, =[Title]).
4. Select the sorting direction by clicking Ascending or Descending options.
5. Click OK.
6. Preview the report. Here's how the table will look like with the 'User Rating' column sorted in ascending order.
   

Interactive Sort

You can use interactive sort or user sort on a TextBox control to sort data columns within a data region in a published report. The Interactive Sort page in the TextBox dialog allows you to enable interactive sorting. See Sort Data topic for further information on applying this kind of sorting on a table.

Dynamic Columns

The dynamic columns in tables are the columns that grow or shrink depending on the visibility of other columns. When a Table has hidden column(s), the other column(s) can be made dynamic by setting the column's AutoWidth property to 'Proportional'.

So, for example, in the following table, we have five columns: Title, MPAA, User Rating, Country, and Language. The visibility of columns MPAA, User Rating, and Language is being toggled by a text box. We want the columns Title and Country to grow or shrink when the visibility of the other three columns is toggled.  

The above report can be created as elaborated below:

1. First set the visibility of columns MPAA, User Rating, and Language and set the toggle control:
   1. Select the columns MPAA, User Rating, and Language (Ctrl+Click the column handlers).
   2. From the Properties window, set the Visibility > Hidden to 'False' and ToggleItem to the name of the textbox from which we will toggle the visibility of these columns.    
2. Now make columns Title and Country dynamic:
   1. Select the columns Title and Country.
   2. From the Properties window, set their AutoWidth property to 'Proportional'.
3. Preview the report. 
   The column width of the visible columns is expanded to take up the width of the Table data region. This way, regardless of how many columns a table displays, the width stays the same.

Limit Number of Rows in Table Details

You can control the number of Table Details rows, displayed on a page, with the MaxDetailsPerPage property. If the number of rows exceeds the value, specified in the MaxDetailsPerPage property, a page break is added after the specified number of rows.

For example, we have a Table with six Details rows.

If the MaxDetailsPerPage property is set to '5', a page break is added after five rows and the Table is split to two pages.

Page 1

Page 2

If a Table contains a group (for example, a SalesID group) and the MaxDetailsPerPage property is set to '5', a page break is not added after five rows because, in this case, the Details rows are counted in each group. In the screenshot below, each group has three Details rows and no page break is added.