Issue Status Helper
Issue Status Helper is a Forge application that helps teams using Jira (especially those using the additional issue hierarchy levels provided by Advanced Roadmaps). It monitors updates to issues and can update the status of its ancestors (i.e. the issues above it within its hierarchy) to reflect their status relative to their children. For example, it ensures that when all stories in an epic have been completed that the epic is also completed.
It can also be configured to set start and end dates of issues based on their state transition (i.e. setting a start date when an issue is moved to "In Progress") or by the dates of the sprint that the issue is assigned to.
Automatically setting this data set ensures that higher-level issues can be trusted to reflect the state and estimated completion date of the work.
This application has been open-sourced to provide a "real-world" example of how to use Forge to enhance Atlassian products to meet your team needs!
Usage
After installation, navigate to the "Apps" > "Manage your apps" page in Jira (this requires admin access) and enable the Issue Status Helper for the projects you want to monitor. For each project you can configure whether to add a comment when a change is made, whether to set dates from sprints and the issue status to use for each issue status category for every issue type used by the project.
It is possible to set default issue statuses for each status category and configure whether to update date fields (and which fields to use) from the "Global Settings" tab.
Installation
You can install the latest release from the Atlassian Marketplace
To build and test the application you will need to:
- Follow the Forge Getting Started Guide to get yourself setup for Forge application development
- Clone this repository
- Use the CLI to re-register the application
- Use the CLI to deploy and install the application to your own instance
Please Note: If you make a pull request you should not include the updated app id in the manifest.yml file!
Documentation
Coming soon!
Tests
Please note: There is not yet full automated test coverage, the remaining tests will be added over time!
You can use npm test from the root of the project to run the unit tests.
Contributions
Contributions to Issue Status Helper are welcome! Please see CONTRIBUTING.md for details.
License
Copyright (c) 2023 Atlassian US., Inc. Apache 2.0 licensed, see LICENSE file.
