Table Configuration

1 Creating table
- 1.1 Table context
- 1.2 Column configuration
- 1.3 Display configuration

Go to Jira Settings → Apps → STAGIL Tables for Jira → Tables Configuration.

Table Configuration page

This page lists all created tables and gives you a comprehensive overview of projects and issue types involved.

When the Search Status column states Activated, data from your custom field is searchable. You can easily deactivate it by selecting Deactivate in the [···] actions menu.

To configure an existing table, select Manage in the [···] menu of a specific table.

Creating table

To create a new table, click on the Add table button.

This action will open a dialog, where the following table attributes are required for definition:

Table name: a title for the table panel/field, displayed in issue view, Customer Portal and used in JQL search queries.

Project Context: a project multi-select list where the table will be displayed.

Issue Type Context: an issue type multi-select list where the table will be displayed.
Issue types must be associated with projects selected in the previous field.

‘Create table’ dialog

Click Add to finish creating a table.

This will make a table appear on the Table Configuration page. But to see the table in issue view, column configuration must be completed first. To proceed with context & column configuration, click on [···] button of the table and select Manage.

Table context

You can create a new table context or edit an existing context, just as you would for a Jira’s custom field. STAGIL table context follows the same logic in context configuration and management as Jira's custom fields:

Please note that context updates after table has been used affect the accuracy of the JQL results.

For example, a table is set up to be displayed in both Story and Task issues, and it has values in issues of both types. If the Task issue type is then removed from the context, the JQL query will continue to list Task issues in the results. This occurs because the app stores table values in issue properties and they are not cleared after the context is updated.

Column configuration

To access column configuration, click Edit STAGIL Table field on the table context configuration page.

Then click the Add new column button. Depending on the column type, the configuration will require different settings. Such settings are described on dedicated pages describing each column separately: Supported Column Types.

However, some settings are universal for all column types:

Column Name: title for a column header.

Column Type: choose field type from those available in the drop-down menu.
This can not be edited after a column is created.

Mandatory: make the column mandatory and enable validation for empty values in this column when a new row is added.

Service Portal: allows to hide or show a column to users in the Customer Portal.

Read-only: columns can be made un-editable (as long as a default value is defined).

Default value: every time a user adds a new row, a column cell will be prefilled with this value.

Tooltip: a tooltip displayed when hovering over a column header.

Display configuration

The Display tab contains settings for the whole table in the issue view.

Show rows count: adds an additional read-only column that will automatically display a row number in the table.

Default sorting: automatically sort rows in ascending order based on the values of a specific column.

Row height (lines): allows to define the height of a row to a maximum of 3 lines.

Table row with row height set to 3 lines: text is truncated after the 3rd row; the full text can be visible in a tooltip on hover.

Table row with row height set to 1 line: text is truncated after the 1st row; the full text can be visible in a tooltip on hover.

Maximum table height (rows): allows to define the height of a table. The maximum number of lines depends on the row height.

Row height: 1 line = Table height: 30 rows

Row height: 2 lines = Table height:20 rows

Row height: 3 lines = Table height: 15 rows