How update a list of items in Jira Align to push the data to Jira
Summary
There are some scenarios where changes can exist in work items in Jira Align (JA) that have not been pushed to Jira (like a problem with the connection, or a name change on the PI) and a manual update may be needed in JA to push these changes into Jira. Below, we will discuss some possible ways to do that.
Environment
Jira Align
Solution
Once an update is made in JA, be it through the UI, API, or Import, it will mark the work item as to be pushed to Jira, so these are possible ways to accomplish it for multiple items.
API
To use the API to do this, it would be possible to use PATCH call (with the Features or Stories REST API endpoint) to update the item or list of items, to mark them as updated. A suggestion is to add a tag on the items.
If using PATCH, a similar syntax could be used to create a tag on the items:
[
{
"op": "add",
"path": "tags",
"value": "TestTag"
}
]
If the only tag present is the one added by the connector (with the “j:”), it will be overwritten by this command but automatically re-added on the next sync cycle. If there are multiple tags, you will need to use as a value, the entire list of tags adding the new one if you want, to avoid losing any of them.
Or, if you don't have the Priority set, you can update the priority from from null to null:
[
{
"op": "add",
"path": "priority",
"value": null
}
]
In case there are multiple items to be updated, some sort of automation / API scripting should be used to use API calls to reset all the items.
Export/import
It is possible to export the impacted items and do an import in the sequence, without altering the data. This will trigger JA into “seeing" an update on them and marks them to be pushed to Jira.
To do the export:
Open the grid (list) view of the items you want to sync and configure appropriate filters for those items
Click on More Options > Export <work_item> > click on the export button
To import them:
- Go to the desired grid view (Features/Stories)
Click on More Options > Import <work_item> Select the Program > Browse (to select the file) > Import Data
You can also alter the exported data, like adding a tag to all entries, to make it easier to track later on which items were updated this way.
Mass move
It is possible to use the Mass Move option to “move" items between the current Program + PI, to the same Program + PI, which will trigger an update on JA, and push them to Jira.
To use the Mass Move:
- Open the grid (list) view of the items you want to sync and configure appropriate filters for those items
- Click on More Options > Mass Move
On the MOVE FROM section, select the desired work item type, the current Program, and Program Increment
On the MOVE TO section, select the same Program and Program Increment
Mark all the items you want to update and click on Save Changes
Manual update
If working on a small list of impacted items, you can simply do a manual update on the UI, to force them to be pushed to Jira. In this case, just open the slide-out panel of the item, add a “." to the description, and hit save.
Related Content:
This article is based on information first published by Atlassian as a Community Article. It has been reproduced in our Knowledge Base in order to allow more flexibility for any future updates or corrections. The original article is available here: