Rocktronic

Project Groups for Jira

Introduction

Project Groups for JIRA is a plugin for Atlassian JIRA, which allows you to combine projects into groups with multi-level hierarchy. Additionally Plugin contains handy tool for fast and effective projects settings management. Project console with projects browser with customizable columns, filters and ability to bulk change projects settings.

Installation

Install the app via the Atlassian Marketplace or follow the standard installation process through the UPM.

Group configuration

You must have the JIRA System Administrators global permission to create, edit or delete groups.

Choose: Cog > Projects > Project groups (sidebar)

You can create any number of groups with any nesting level. The only limitation is that groups on same level must have different names.

Linking project to groups

You must have the JIRA System Administrators global permission to link project to group. Navigate to the settings page for the project and find «Group» on a left sidebar. Also, you can simultaneously link several projects to group with bulk edit feature of project console (see below).

Browsing projects by groups

Choose: Projects (top menu bar) > Browse By Group. On a left sidebar is a hierarchical groups list, and links to all and ungrouped projects. Number near group name is a number of projects in current group (excluding projects in subgroups).

Click on "Subgroups" toggle (default is on) to view projects only in current group, without subgroups.

Browsing projects by leads

Choose: Projects (top menu bar) > Browse By Lead.

If current user is lead of at least one project, then list of his projects will open automatically.

Workflow condition

Plugin provides workflow "Project Group Condition" that allows you to perform transition based on project is included/not included in specified project groups.

JQL Functions

projectGroups()

Plugin provides JQL function projectGroups() that allows you to search issues based on project is included in specified groups.

project in projectGroups("Design")

You can provide multiple groups:

project in projectGroups("Design", "Development")

Please note that if you have several groups with same title, function will return all projects in all groups with that title.

projectGroupsHierarchy()

projectGroupsHierarchy() works similarly to projectGroups(), except that it returns issues in the projects of the specified group, as well as all of its subgroups at all levels.

Project console

Choose: Cog > Projects > Project console (sidebar)

Columns customization

You can change which columns is displayed in projects table with «Columns» button in upper right corner. Columns set is saved for current user. Project key with link to project page is always visible, as a cog icon with link to project administration page.

Projects filtering

You can filter projects by visible columns. Use drop-down lists at the top of table for this. Buttons with lists containing changed values are marked green.

Bulk changing projects settings

Regardless of filter active or not, you can use «Bulk Edit» button for bulk change projects settings. If filter is active, you’ll see only filtered projects. At the moment you can edit following settings:

  • Group
  • Category
  • Permission Scheme
  • Screen Scheme
  • Field Layout Scheme
  • Notification Scheme

Troubleshooting

If you find an error in our app's operation, do the following to solve the problem most effectively:

  1. Immediately after the error occurs, open Developer Tools on the same page of your browser (on Windows, press F12; on Mac, option+command+i); switch to the "Console" tab, and see if there are any errors highlighted in red. If there are errors, make a screenshot of them, or copy the text.

  2. If you can reproduce the error, enable the DEBUG logging mode for our application and reproduce it. The log will gather more complete information about what happened, which will help us solve the problem faster. To enable DEBUG mode:

    • Go to: Cog -> System -> (TROUBLESHOOTING AND SUPPORT section) Logging and profiling
    • Click "Configure logging level for another package"
    • In the window that appears, enter "systems.npe.jira.prjorg" in the "Package name" field, select "TRACE" in the "Logging level" field, and click Add.

    Important! After completing Step 3, switch our app's logging level to WARN. To do this:

    • Go to: Cog -> System -> (TROUBLESHOOTING AND SUPPORT section) Logging and profiling
    • In the package list, find systems.npe.jira.prjorg and click WARN in this row.
  3. Create a zip file containing useful information about your instance. To do this, go to: Cog -> System -> (TROUBLESHOOTING AND SUPPORT section) Support tools -> Create support zip tab The "JIRA application logs" checkbox must be checked in the list that appears; if others are also checked, it will help us solve your problem faster.

  4. Create an issue in our tracker, describe your problem, and attach the files received in steps 1 and 3.