This page relates to the Cloud version of Rich Filters for Jira Dashboards. Please see the documentation index for Server & Data Center versions.

Configuring Views

In this section:

  1. About Views
  2. Views' Key Attributes
  3. Adding & Editing Views and Columns
  4. Working with Special Columns

1. About Views

Views allow users to define the columns to be displayed by the Rich Filter Results gadgets. Each view contains a list of columns which can be based on issue fields, special columns, custom values, or tags based on static filters or smart filters. Additionally, a view can also contain a Gantt chart. The Rich Filter Results gadgets can display multiple views of the issue collection returned by the rich filter.

Views enable the Rich Filter Results gadgets to display large amounts of information in a clean and compact manner:

  • Each view can contain columns which are relevant for a particular purpose – users in different roles might need to see different columns;
  • The Rich Filter Results gadgets can display multiple views at once allowing the users to easily switch between them by clicking on tabs located at the top of the gadget;
  • For any column, users can customize the column header to be displayed in Rich Filter Results gadgets;
  • The computed columns based on static and smart filters allow users to display computed tags (labels) and to add color coding;
  • Users can customize the display format of the columns based on numeric fields (number of decimals, thousand separator) and on time-tracking fields (Jira's time display format or days, hours, minutes or seconds);
  • Views can optionally show totals for columns based on numeric and time-tracking fields or custom values. The formula used for aggregation can be selected for each column among four options: sum, average, minimum, or maximum value;
  • Views can optionally display a Gantt chart.

2. Views' Key Attributes

You can add new and see existing views and their configuration in the Views section of your rich filter.

The key attributes of a view are:

AttributeDescription
NameEach view has a name which is used to identify and display the view. It is mandatory and must be unique among the views within the rich filter.
Show Gantt chartIf enabled, the view will have a Gantt chart as its last column, in addition to the columns selected in the Columns list.
Show totals row

If enabled, the view will have an extra row at the bottom, showing totals for columns based on numeric and time-tracking fields, or custom values.

For numeric and time-tracking fields the total formula (sum, average, min, or max) can be configured for each column individually. For custom values the total formula is the one selected in the custom value configuration.

One-line rows by default

If enabled, the view will be displayed with one line per row by default (compact layout). Users can still switch between the two layouts in the Rich Filter Results gadgets.

Views with Gantt chart enabled can only be displayed with one line per row.

Columns

Each view contains a list of columns that are displayed when the view is used in Rich Filter Results gadgets. The columns can be:

3. Adding & Editing Views and Columns

The Views section of your rich filter allows you to perform the following operations:

To achieve this:Do the following:
Add a new View

Click on the Create view button at the top-right of the page.

Type a name and check the checkboxes you need for the view, then click on the Create button.

You can add up to 50 views in each rich filter.

Browse the Views list

The Views section of your rich filter allows you to browse the views list. You can click on any view to view and/or edit its properties (see below), depending on your rights. 

Reorder the Views

In the views list, hover over the vertical “grid” icon of the view, then drag and drop up or down to the new position.

Copy (duplicate) a View

Click on the Copy option available in the corresponding view’s menu.

Type the name of the new view and click on the Copy view button. A new view with the same columns is created.

Delete a View

In the views list, click on the Delete option available in the corresponding view's menu. 

When you create a new view or if you click on an existing view, a new screen focusing on the selected view is displayed. This screen allows you to perform the following operations on the selected view: 

Edit a View’s name

Click on the edit icon located next to the view’s name.

Enable totals and one-line rows by default

Toggle the corresponding switch by clicking on it.

Enable Gantt chart

Toggle the Show Gantt chart switch to enable or disable the Gantt chart.

 

When the Gantt chart is enabled for the first time in a view, a configuration dialog is displayed. To configure the Gantt chart, follow these steps:

  • Select the issue fields to be used as start and end date. In the example below, the chart is based on the issue fields Start date and Target end. This means that the bars start on the issues' Start date and finish on their Target end.
  • Optionally, configure the dependencies to be shown in the chart. The dependencies represent the order in which issues need to be done. They are based on the issue link types that are configured in your Jira instance. To add a new dependency, select an issue link type from the Add a link type dropdown – the dependency will be added to the list. In the example below, we have configured a dependency based on the issue link type Blocks, so the dependency will use the blocks / is blocked by links existing between the issues. You can reverse the precedence order by clicking on the swap link at the right of the dependency line. When issue A precedes issue B (i.e., issue A must be done before issue B), in the chart a link to issue A will be displayed to the left of the bar of issue B, and a link to issue B will be displayed to the right of the bar of issue A. The dependencies in the Gantt chart configuration are optional and purely informative – they do not affect any calculation.
  • Specify how the bars should be colored. You can select either Status Category (the default option – for predefined bar colors) or one of the smart filters defined in the rich filter (for custom bar colors). With the Status Category option, the bars will have the color of the issue's status, as defined in Jira. If you select a smart filter, the bars will have the color of the first clause of the selected smart filter that matches the issue (first match logic); if none of the clauses matches the issue, a default gray color will be used for that issue. This means that, by using a smart filter, you can specify the colors of the bars depending on the priority of the issues, or on any other filtering criteria that can be expressed in JQL.

For details about using Gantt charts in the Rich Filter Results gadget, have a look at Use Gantt charts.

Edit the Gantt chart

 If the Gantt chart is already enabled, click on the edit icon to view or edit the configuration of the Gantt chart – the configuration dialog described above will be displayed.

Add columns to a View

Click on the Add a column... button. A drop-down menu is displayed with all the available options: issue fields, special columns, static filters, smart filters and custom valuesScroll through the list, use the section scroll buttons to quickly jump between sections or use the search box to rapidly find the columns you're looking for.

The views with no columns are not displayed by Rich Filter Results gadgets.

You can add up to 30 columns in each view.

Edit columns 

Click on the edit icon at the right of the column.

Depending on the type of column, the following options are available:

  • Column heading – for any column you can customize the column header to be displayed in Rich Filter Results gadgets:
  • Display as – for static and smart filters, you can customize the way tags are displayed:
  • Total formula – for numeric and time-tracking fields, if the view is configured to show the totals row, you can select the formula to be used for computing totals. The possible options are sum, average, minimum, maximum, and none if you want to hide the total for the field.
  • Value formatting – for columns based on numeric and time-tracking fields, you can choose the format of the values (including the total if enabled) among the following options:
    • For numeric fields:
      • Thousand separator on/off
      • Number of decimals: none or maximum 3, 2 or 1 or exactly 3, 2 or 1
    • For time-tracking fields:
      • Jira's time display format – uses the time format as configured in Jira by the administrator of the instance
      • Days, hours, minutes or seconds

What's the difference between maximum 2 and exactly 2 decimals?

If you select the exactly 2 option, the value will always be displayed with 2 decimals. This is achieved by rounding to 2 decimals if more than 2 are available (e.g. 23.4567 → 23.46) or padding with zeros up to a total of 2 decimals if fewer than 2 are available (e.g. 23.4 → 23.40).

If you select the maximum 2 option, the value will be displayed with 0, 1 or 2 decimals. This is achieved by rounding to 2 decimals if more than 2 are available (e.g. 23.4567 → 23.46) and leaving the value as it is if 2 or fewer decimals are available (e.g. 23.4 → 23.4).

Reorder columns

Hover over the vertical “grid” icon of the column, then drag and drop up or down to the new position. Rich Filter Results gadgets will display the columns in this order.

Delete columns

Click on the delete icon located at the right of the column.

Have a look at the The Rich Filter Results Gadget documentation page to see how to display views in dashboards.

4. Working with Special Columns

Special columns display issue-related information which is not available in issue fields. The available special columns are:

  • Last comment – displays the most recent comment added to an issue
  • Jira Service Management special columns – the following special columns are available only for issues in Service Management projects:
    • Last external comment – the most recent external comment added either by a Service Management agent or by a customer
    • Last internal comment – the most recent comment added internally
    • Last reply from customer – the most recent comment added by the customer
    • Last reply to customer – the most recent external comment added by a Service Management agent

In order to add a special column, click on the Add a column... drop-down menu and scroll to the Special Columns section (Hint: you can click the quick scroll button available in the drop-down menu):