Rate this page:
This changelog is the source of truth for all changes to the Forge platform that affect people developing Forge apps.
Posts are made in the Forge announcements category of the developer community when the changelog is updated. Subscribe to the Forge announcements category to get notifications.
See what's next for Forge on our platform roadmap.
We're excited to share that Forge, our app development platform for Atlassian cloud products, is now generally available. You can rely on Forge's hosted infrastructure, storage, and FaaS functions to support apps in production; all of which are backed by Atlassian's operational readiness. Learn more about building the next Marketplace hit with Forge.
Note that some functionality in Forge remains in beta while we're still making changes that may break your apps. Learn more about the current functionality in beta.
The contextId
field in the extension context of the Custom field type module is deprecated and replaced with configurationId
. The new field contains the same value as contextId
previously did.
We’re changing this up to avoid confusion around the nomenclature contextId
, which may be mistakenly interpreted as the ID of a field context. Instead, we’re referring to the ID of a field configuration here.
The contextId
field will be removed on Nov 1, 2022.
The documentation now contains a getting started tutorial for Jira Service Management. The tutorial takes you through adding a page to a Jira Service Management Queues section to display the number of queues in the project.
See Build a Jira Service Management hello world app to work through the tutorial.
Forge CLI now lints correct scope when Jira Software and Jira Service Management REST APIs are used.
The scope checks are based on the OpenAPI specifications:
Jira Service Management: https://developer.atlassian.com/cloud/jira/service-desk/swagger.v3.json
Jira Software: https://developer.atlassian.com/cloud/jira/software/swagger.v3.json
We’ve introduced the jira:workflowCondition
Forge module. You can now configure your own workflow conditions using Jira expressions.
See the Jira workflow condition documentation for more details.
Additionally, we’ve introduced a new avi:jira:failed:expression
Jira event you can subscribe to using a trigger module. This event is generated whenever an app-registered Forge workflow validator or Forge workflow condition based on a Jira expression fails while executing.
See the Jira expressions events documentation for more details.
We’ve added the UI modifications extension point for Jira. It enables you to modify fields on the global issue create (GIC) form. The possible modifications include hiding fields, changing their labels, and more.
There is a corresponding JS API for custom UI which can be found in the @forge/jira-bridge
package.
You can apply UI modifications to the following GIC fields:
summary
description
labels
assignee
priority
We've updated the Forge CLI to align the experience of upgrading and uninstalling JSM apps for classic or granular scopes. Now, for JSM Forge apps, the Forge CLI does not show JSM as an option when you upgrade and uninstall the app. When the apps are installed, upgraded, or uninstalled in Jira the changes are reflected in JSM.
For more information on classic or granular scopes, see the Jira or JSM Scopes for OAuth 2.0 (3LO) and Forge apps pages.
The Forge platform will now retry product event triggers that did not execute successfully. This includes errors such as timeouts, out-of-memory errors and app-level errors.
For more information on how you can increase the reliability of the product events, see Retry product events.
We’ve raised Forge’s Storage API operation limits in response to requests from developers. See Storage API operation limits per installation for more details.
We’ve updated how you create web trigger URLs in the Forge CLI to improve product security. You now need product admin access permissions in the product instance on the site where the web trigger app is installed.
We have updated our security requirements for cloud applications, added new security requirements, and categorized requirements by app type and security requirement type. All cloud applications in the Atlassian Marketplace must adhere to the updated requirements by October 31, 2022.
Please see the blog post and FAQ page accompanying this announcement for more details, as well as this document for specific updates.
When using the jira:customFieldType
module in UI kit, inline editing of custom fields on the issue create view wasn't enabled. As a result, the modal had to be used.
We corrected this behavior. Inline editing is now available on the issue create view for both the jira:customFieldType
and the jira:customField
module.
We’ve changed the permissions required for bulk get statuses and search statuses paginated. We’ve also added the option to filter by status category in search statuses paginated.
The permissions required for bulk get statuses and search statuses paginated are now:
Administer projects project permission for the projects that use the statuses
Administer Jira admin permission for the tenant
We’ve also added the option to filter the results by status category: TODO
, IN_PROGRESS
, DONE
.
Custom UI apps rendered within an issue view screen may now use the refresh method to update the view without performing a full-page reload.
We have relaxed our key validation in @forge/api
's properties API to allow the period character .
. We also now propagate 400
and 401
errors from the underlying API when using the get
method to ease debugging.
Run npm install @forge/api@latest
on the command line to install the latest version of @forge/api
.
We’ve updated the extension context for the UI kit of the following Jira Service Management modules:
The following property names and type have changed for the UI kit components:
Property names | From | To |
---|---|---|
|
| |
|
| |
|
| |
Property type |
|
|