Sub-Tasks Mode

On this page:

1 Overview
2 Data
- 2.1 Sub-Task Types
- 2.2 Columns
- 2.3 Subtask Sequence Numbers
- 2.4 Filter JQL (since v. 2.0.0)
- 2.5 Sort By (since v. 1.6)
3 Display
- 3.1 Table Visualization
- 3.2 Issues
- 3.3 Categories
- 3.4 Jira Panels
4 Locations

Overview

In Sub-Tasks mode, the Issue Matrix table contains the sub-tasks of the current issue.

The configuration options are organized into the following groups:

Data
Display
Locations

Data

The Data configuration options let you control the content displayed in the matrix table.

Sub-Task Types

In this section, you can specify tasks of which sub-task types to be shown.

If no sub-task issue types are chosen, all sub-tasks will be shown.

Columns

You can add any Jira field that is supported by the Issue Navigator, including custom fields, to the list of columns that will be visualized in the Issue Matrix table. The field value visualized in the Issue Matrix table will be the same as in the Issue Navigator.

Adding a progress bar

If you want to have a progress bar in your matrix, you can add the Σ Progress field as a column. If you don't see it in the field selector, you must enable time tracking for your Jira instance first. To do that, go to Settings > Issues > Time tracking and click the Activate button.

You can specify the Width of the columns you add to the Issue Matrix table. For details, see https://appfire.atlassian.net/wiki/spaces/ILV/pages/198182504.

Since v. 2.8.0, you can also specify the Header of each column you add to the Issue Matrix table. If you want to have column headers adapted to your use cases, set the headers when you configure the Issue Matrix columns. When you choose a field from the list to be added as a column to the Issue Matrix table, the column header is set by default to the custom field's name. If you want to revert to the default header of a column, just delete the contents in the Header column of the configuration.

You can enable Inline Edit for the fields within each column. For details, see https://appfire.atlassian.net/wiki/spaces/ILV/pages/198182354.

Subtask Sequence Numbers

This option is disabled by default. You can enable it to hide the subtask sequence numbers that are displayed in the first column of the Issue Matrix table. You can still drag-and-drop subtasks to rearrange them within the table.

Filter JQL (since v. 2.0.0)

Use this additional JQL to further filter the sub-tasks that will be shown in the Issue Matrix table. You can also use the Issue Matrix JQL Extension. This filter will be executed only over the set of issues that would normally be shown in the Issue Matrix panel - no additional issues will be shown. For example, if you have the JQL resolution = unresolved, the Issue Matrix panel will show only the unresolved sub-tasks of the current issue. If the JQL is invalid, it is ignored, and no additional filtering is applied.

Sort By (since v. 1.6)

This setting lets you control the sort order of the sub-tasks shown in the Issue Matrix table. The order of the issues can be ascending or descending based on the values of the selected field.

If you add multiple sort fields, the sorting will be done according to their priority.

The method used is the same used in Jira - Lucene, and only the sortable fields are present as choices.

Later, each user can change the sorting directly from the table, but cannot reorder the issues in the sub-tasks table. For details, see https://appfire.atlassian.net/wiki/spaces/ILV/pages/197957270.

Display

The Display options let you control how the Issue Matrix table is visualized. In addition, you can hide the default Sub-Task panel to avoid showing the same sub-tasks twice.

Table Visualization

The options in this section are:

Show Table Headers: If enabled, this option will visualize the fields configured in the Column selection as table headers. Users will be able to sort the table by clicking the table headers. See https://appfire.atlassian.net/wiki/spaces/ILV/pages/197957270.
Show Empty Table: If enabled, the Issue Matrix table will be shown even if there are no issues to be displayed. This allows adding new sub-tasks directly to the issue.

Issues

Since v.5.0, the Issue Matrix table includes pagination when viewed in Issue Detail View and Agile Boards for improved performance. You can choose the default page size of the Issue Matrix table. The page size must be a value between 1 and 1,000, and it is initially set to 10.

This setting automatically applies to all users. Later, each user can change this setting for their account directly from the table. For details, see https://appfire.atlassian.net/wiki/spaces/ILV/pages/197957270.

Issue Matrix pagination is not available in the Issue Navigator, Issue Matrix preview, nested matrices, dashboards, Service Desk queue, and as a Confluence macro. In these locations, the Issue Matrix table displays all issues.

In earlier versions, this section lets you specify the number of initially visible issues in the Issue Matrix table. The remaining issues will be shown after clicking the Show more link. To remove the limit, either choose All or set the Selected entry to 0.

After upgrading to v. 5.0 or later, the current number of issues initially visible becomes the default page size of the Issue Matrix table.

Jira Panels