Documentation Center

Configuring parameters for segmenting large tables

Large tables are segmented to make them easier to navigate and view.

Reasonably sized tables can be readily displayed and perform very well in a standard web browser. These moderate size tables do not require additional handling to meet the performance expectations of most users, and these tables can continue to be displayed as a single table.

Providing a mechanism for defining the lower limits for extremely large tables will be important to enable the additional processing and management required for these larger tables, while allowing reasonably sized tables to continue to be processed as a single entity.

A configuration option is used to define this lower limit. The limit should express the minimum number of rows a table must include before triggering the additional processing required for extremely large tables.

For example, if the lower limit is set at 7500, tables with less than 7,500 rows would be handled normally as a single continuous table. A table with 7,500 rows or more would be subject to the special handling required for extremely large tables.

Extremely large tables should to be split into sections. The number of sections for a given table can be determined by the number of rows in a given table and the defined section size associated with a publication’s configuration.

You must add these config file settings in each publication's configuration file, or in the Contenta publication configuration file if publishing from Contenta. If you do not add these config settings, large tables will not be segmented.

<configitem name="hugeTableLowerLimit">
   <value>8000</value> 
</configitem>
<configitem name="hugeTableSectionSize">
   <value>200</value> 
</configitem>
More on the hugeTableLowerLimit config item:
  • The value you enter is expressed as the minimum number of rows in the extremely large table.
  • Individual tables with row counts less than the related value will not be segmented; they will display as a single, continuous table.
  • Individual tables with row counts at or above the related value will be segmented into smaller sections when published. You will be provided with a view that displays a single section at a time.
  • Navigation controls let you move among sections.
More on the hugeTableSectionSize config item:
  • The value you enter is expressed as the number of rows in one section. The large table will be divided into sections that contain 'hugeTableSection' pages. The last section may contain fewer rows than was entered in this config item. It depends from the total number of rows inside the large table.
  • Segments an extremely large table into sections no greater than the related value.
  • Displayed section size may vary based on applicability.
  • Navigation controls let you move among sections.