The configuration page is essentially used for customizing the display and management of issues in Jira, tailored to the specific needs of the team or project. It offers flexibility in organizing and filtering issues, customizing fields for data representation, and ensuring that all changes are intentional and saved appropriately. The user-friendly interface, with its simple tab navigation and clear options for adding, editing, and deleting configurations, makes it accessible for users with varying levels of expertise in Jira.
...
You can find the project settings page in inside each project in the Apps section of the project menu.
...
If the project did not contain any previous settings, then the first thing you will see is an empty settings page, where your only option is to create a new configuration for your project.
...
You can create multiple tabs for one project, where every tab can hold a configuration for the configured issue type. You can save as many tab settings as many issue type the project contains.
...
Click on the menu icon located at the top right of the configuration page.
From the menu, select Add new Tab.
A dialogue panel will appear where you can set the new tab’s name.
Press Add to create the tab.
A new tab will be added, and you can start configuring it according to your needs.
...
Renaming a tab
You also have the ability to rename tabs, ensuring they reflect the configurations' purpose better.
...
Click on the tab you want to edit.
Click on the menu icon located at the top right of the configuration page.
From the menu, select Edit name.
A dialogue panel will appear where you can set your existing tab’s new name
Press Edit to save the changes
...
...
Copying a tab
It is possible to copy a tab to create a new tab with predefined configuration. This action will copy the custom fields of the tab and the filtering options but not the issue type since it can not be duplicated.
To copy a tab:
Click on the tab you want to copy.
Click on the menu icon and choose Copy Tab.
A dialogue panel will appear where you can set the new tab’s name.
Press Add to create the tab.
A new tab will be added most of the configuration from the copied tab.
...
Deleting a tab
You can also delete existing tabs when you are no longer in need of it.
...
In the Issues section, choose an Issue Type from the dropdown menu. You can select from issue types that are available in the current project, ensuring that the panel only displays the types of issues relevant to their current needs or tasks. You can choose multiple issue types for the same configuration, which would mean that you will se see the same issue panel on different issues.
...
Link Type: This option allows users to filter issues based on their linkage to other issues. Users can specify a linked issue type, and the panel will dynamically display only those issues that have the defined linkage. This is particularly useful in complex projects where understanding the relationship between different issues is crucial.
Filter: Our plugin allows you to integrate Jira Filters directly into your configuration, enabling you to reuse the same JQL query across multiple setups. By referencing a single Jira Filter, any changes to the query need to be made only once, automatically updating all configurations that use it. You have to type the name of the Filter into the search bar, and a user can set any filter that they can access. This option requires permission for the user to see the Filter they want to configure.
JQL: For users who require more advanced and customized filtering, the JQL filter option enables the creation of specific queries using Jira Query Language. The results of these JQL queries are then presented in the panel, offering a tailored view of issues based on the user-defined criteria. This feature is ideal for users who are familiar with JQL and need to perform complex searches or data segmentation. This options also includes a feature to validate your query by clicking the text below the JQL field.
Child Issue: This filter is designed to show only the child issues of a selected parent issue. It's particularly useful in scenarios where tracking the progress or details of sub-tasks or dependent issues is necessary. By focusing on child issues, users can easily manage and navigate through the hierarchical structure of tasks.
...
In the Fields section, users are have the option to add custom fields to their issue display panel. Users can select from a range of available fields to be displayed for each filtered issue, ensuring that only relevant information is presented on the panel.
...
Average Aggregation: This option allows users to calculate and display the average value of a selected field across all displayed issues. It is particularly useful for fields that contain numerical data, where an average value can provide meaningful insights, such as average cost, or other quantifiable metrics.
Sum Aggregation: Users can also opt for the sum aggregation, which calculates the total sum of values for a selected field across all issues displayed in the panel. This feature is extremely valuable for fields where the total value is more informative than individual entries, such as total expenses, or any other cumulative data points.
Count Aggregation: The Count option allows users to calculate how many custom field values are filled in the configured column. When it comes to custom fields where multiple options can be selected, each selected value will count as one.
Field Configuration
The issue key is a default field when you create a new tab, but you can also add new fields to your configuration manually.
...
Saving
Save Settings
Click the Save settings button at the end of the page to save all the configured settings. A flag will be displayed to indicate whether the saving operation was successful. It will also indicate if something is missing from the configuration.
Cancel
Click the Cancel button at the end of the page to revert any unsaved changes.
...