This page covers changes in JIRA 7.1 that can affect add-on compatibility and functionality. This includes changes to the JIRA platform and the JIRA applications (JIRA Core, JIRA Software, JIRA Service Desk).
As a rule, Atlassian makes every effort to inform add-on developers of known API changes as far in advance as possible. Where possible, we attach release targets. Unless otherwise indicated, every change on this page is expected to be released with the first public release of the JIRA Server 7.1 products. We also make release milestones available prior to the release:
We will update this page as development progresses, so please stay tuned for more updates. We also recommend following the JIRA news on Atlassian Developers blog for important announcements and helpful articles.
The risk level indicates the level of certainty we have that things will break if you are in the "Affected" column and you don't make the necessary changes.
Change. Platform/Application | Risk level. Affects |
---|---|
Platform/Application: JIRA platform | Risk level: N/A Affects: N/A (new feature) |
Change: Conditions to check for JIRA applications Platform/Application: JIRA platform | Risk level: N/A Affects: N/A (new feature) |
Change: Set entity properties on issue creation Platform/Application: JIRA platform | Risk level: N/A Affects: N/A (new feature) |
Change: New atlas-run-cloud command Platform/Application: JIRA platform* | Risk level: N/A Affects: N/A (new feature) |
Change: New asynchronous startup Platform/Application: JIRA platform | Risk level: Low Affects: Functional test suites |
Change: New 'Create board' method Platform/Application: JIRA Software | Risk level: N/A Affects: N/A (new feature) |
Change: Webhooks for Agile boards Platform/Application: JIRA Software | Risk level: N/A Affects: N/A (new feature) |
Change: New JIRA Service Desk REST API Platform/Application: JIRA Service Desk | Risk level: N/A Affects: N/A (new feature) |
*\ This\ is\ a\ JIRA\ platform\ feature,\ but\ it\ currently\ only\ works\ for\ JIRA\ Software.
As the JIRA applications are built on the JIRA platform, the changes in this section affect all JIRA products.
You can now register comment-related events for a webhook in JIRA Core. This lets JIRA Core notify your add-ons or web applications whenever a comment is created, updated, or deleted. Just choose the desired events when creating or updating your webhook. Read the webhooks documentation for details.
If you are developing an Atlassian Connect add-on, you can now set the can_use_application
condition to detect whether a particular JIRA application is licensed and active for the current user. This For example, the following condition would check whether JIRA Software is installed and enabled, and whether the current user can use it according to the application license:
1 2{ "condition": "can_use_application", "params": { "applicationKey": "jira-software" } }
Entity properties are used to add key/value stores to JIRA entities, like issues and projects. Previously, it was only possible to add entity properties to an issue entity after the issue has already been created. In this release, you can now add these properties when creating an issue (REST API only), e.g.
1 2{ "fields": { "project": { "key": "TEST" }, "summary": "Example issue", "description": "This is an example issue", "issuetype": { "name": "Bug" } } "properties": [ "propertykey" : {}, // valid JSON object here "secondPropertykey" : {} // another valid JSON object here ] }
For more information on entity properties in JIRA, see JIRA Entity Properties overview.
By default, JIRA now displays a progress page during its startup instead of holding incoming requests. Most add-on developers should not be directly affected by this change, but test suites that do not expect any response from JIRA at all until it is fully initialized may be confused by these responses. Options for dealing with this include:
curl
or something similar until you are no longer redirected to startup.jsp
jira-testkit
versions 7.0.97
and later, which will recognize the startup page and retry transparently if you use it to perform a data restore or verify that JIRA isSetup()
-Dcom.atlassian.jira.startup.LauncherContextListener.SYNCHRONOUS=``true
to disable this feature If you are building Connect add-ons, you'll be happy to know that we've added a new atlas-run-cloud
command. This command can be used to start a local Cloud instance of an Atlassian application (latest version). It currently only works for JIRA Software, but we'll be adding other JIRA products to it in future. If you want to try it out, just run the following command:
atlas-run-cloud --application jira-software
For more information on it, see atlas-run-cloud.
There are no JIRA Core-specific changes.
These changes are specific to the JIRA Software application and do not affect the other JIRA products.
The JIRA Software REST API now has a 'Create board' method. Check it out in the REST API documentation.
You can now register board-related events for a webhook in JIRA Software. This lets JIRA Software notify your add-ons or web applications whenever a board is created, updated, deleted, or has its configuration changed. Just choose the desired events when creating or updating your webhook. Read the webhooks documentation to learn more.
These changes are specific to the JIRA Service Desk application and do not affect the other JIRA products.
JIRA Service Desk now has a public REST API. Need to get the issues in a service desk queue? Or add a comment to a customer request? The new REST API has a range of resources for interacting with JIRA Service Desk.
The JIRA Service Desk REST API is currently experimental, but will eventually become stable (see our REST API policy for more details). Check it out below:
Rate this page: