Atlassian is making changes to Jira Cloud to provide users with more control over their profile information - both in response to recent changes to data privacy legislation (i.e. GDPR) and as part of a broader effort to improve customer trust. These efforts include major breaking changes to the Jira REST API on top of which all apps, including JMWE for Jira Cloud, are built.
Despite our best efforts to makes the changes transparent to our customers, they will have an impact on your workflows, and you will need to make changes to some of the JMWE workflow post-functions you have configured.
Note | ||
---|---|---|
| ||
Atlassian pushed back the deployment of the first wave of breaking changes ("Phase 2" below) to June 2 at the earliest. You have therefore up to June 2 to make the changes required for Phase 2 (see below). |
Info | ||
---|---|---|
| ||
The Jira Cloud bug that prevented some JMWE post-functions from being listed by the GDPR Migration Tool is now fixed. The tool will now list all the required changes. |
...
What: we are releasing a new version of JMWE for Jira Cloud that is fully compatible with all your existing workflows, but enables you to identify the post-functions that need changes, and make these changes ahead of time.
Phase 2
When: April 29 May 16 June 2, 2019
What: Atlassian will deploy the GDPR breaking changes mentioned above. However, they will offer a compatibility API that will allow JMWE for Jira Cloud to continue supporting most of the existing post-function configurations, even if they still refer to usernames and user keys. The only post-functions that will stop working are those that include a Nunjucks template that compares a username to a constant string. For example:
...
Table of Content Zone | ||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||||||||||||||||||
Attempting to access the 'name' field of a user objectThis warning will be logged by post-functions that refer to the
How to fixThe reference to the
Note that fields that expect a reference to a user as their value (fields that used to expect a username or a comma-separated list of usernames, such as the Assignee field or Multi-user picker custom fields) now expect an accountId or a comma-separated list of accountIds, but they will temporarily continue to accept usernames (until phase 3).
Note that you can use the "User lookup" button of the Nunjucks editor toolbar to look up the account ID of a specific user and insert it in your template. In some cases, you might want to replace the reference to the
Note that the
When to fixThese warnings need to be fixed at the latest before:
Attempting to access the 'key' field of a user objectThis warning will be logged by post-functions that refer to the
How to fixThe reference to the
Note that you can use the "User lookup" button of the Nunjucks editor toolbar to look up the account ID of a specific user and insert it in your template. When to fixThese warnings need to be fixed at the latest before phase 2. This post-function still uses a username as the runAs userThis warning will be logged by post-functions that were configured with the "Run as this user" option before JMWE for Jira Cloud 1.1.11 was released. How to fixRun the "Automatic Migration" option of the GDPR Migration Tool. When to fixThese warnings need to be fixed at the latest before phase 3. This post-function still uses a username as the 'comment author'This warning will be logged by the Copy Comments to Linked Issues post-function if it was configured with the "Author of copied comments" option set to "this user" before JMWE for Jira Cloud 1.1.11 was released. How to fixRun the "Automatic Migration" option of the GDPR Migration Tool. When to fixThese warnings need to be fixed at the latest before phase 3. This post-function still uses a username as the 'comment as' userThis warning will be logged by the Create Issue(s) post-function if it was configured with the "Add a comment to the current issue" option with the "Create comment as this user" sub-option before JMWE for Jira Cloud 1.1.11 was released. How to fixRun the "Automatic Migration" option of the GDPR Migration Tool. When to fixThese warnings need to be fixed at the latest before phase 3. This post-function still uses user names/keys and must be updated to use accountIds insteadThis warning will be logged by any post-function that is somehow manipulating a username or user key. The most common case will be when setting a user-type field to a username, using a value such as:
Note that this warning can appear together with an "Attempting to access the 'name' field of a user object" warning. Fixing the latter will fix the former. How to fixThe simple cases, such as setting a field to a username constant, will be automatically handled by the Automatic Migration of the GDPR Migration Tool. In most other cases, you will need to update usernames in Nunjucks Templates to accountIds. If you can't figure out why your post-function is logging this warning message, please open a support request on our Help Desk. When to fixThese warnings need to be fixed at the latest before phase 3. |
...