Configure the Work Items Table

The Table customization is done by editing the table-settings.xml file for the scope you want to customize, either online in the Table Configuration topic of Administration, or offline by downloading the file from that topic, editing offline, and then uploading the modified file back to the Polarion server in the same Administration topic.

The configuration file contains <column> tags for all the available data fields that can be displayed in the Work Items Table. The tags for the columns that appear by default are uncommented. Other available tags are placed inside a comment. If you want to remove one of the default columns so that it does not appear in the Table, cut it and move it into the comment that contains the other available column tags. To make one of the other available columns appear in the Table, cut its tag from the comment that contains the other available columns and paste it into the block of uncommented column tags in the position you want it to appear.

For example, if you wanted to add resolution as the third column in the table, cut the tag <column id="resolution" ...> from the block of commented tags and paste it as the fifth tag in the block of uncommented <column> tags.

1. Log in with administrator permissions and enter the Administration interface.

2. Open the scope you want to configure: Repository, or a project. (Click the current repository or project name in Navigation, just under the logo image.)

3. In the Navigation pane, expand Work Items and select Table Configuration.

You can now download the relevant configuration file. If you are making a project configuration and no configuration file for the project scope exists, you can use the controls in the Edit Project Configuration section to create a project-scope copy of the global configuration file in the text editor, where you can modify and save it.

User queries on Work Items can sometimes find very large numbers of Work Items. However, it is not likely that all of the items are actually needed. So for performance reasons, you may want to set a limit on the number of Work Items that can be loaded in tables of Work Items. You can do this with the system configuration property loadAllLimit (in the polarion.properties file.) By default, the limit is 3000 Work Items.

Note that setting this limit in the configuration does not mean that is the number of items that is always loaded. It reflects only the maximum number of items that are allowed to be loaded in the table. When the number of items found by a query exceeds the configured limit, users are presented with a link Load first NNNN where NNNN is the configured load limit. For example: Load first 3000. When a user clicks the link to start the loading, items are loaded in blocks of 50. The count of loaded items is updated after each block loads, so the user can estimate when the loading will be finished.

In a new, clean installation the fields available to display as table columns are listed in the configuration file in comments. However, you may have an upgrade installation which has a version of the configuration file without such comments. Therefore, it may be useful to have a complete list of fields that you can optionally configure for display in the Work Items Table. The following table lists the field IDs of fields that you can display as columns in the Work Items table, along with which ones are shown by default in new installations.