Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Customers can configure validators or conditions in their workflow transitions; these can restrict which users and when can users transition from one status to another. TFS4JIRA will follow all the rules implemented in Jira and this can be an issue for the synchronization process, especially if there are no global transitions configured in the workflow.

Global transitions allow users to go and come from any status of the workflow. This is also how workitems in Azure work, so if the transition performed in Azure is not available in Jira this will throw errors in the synchronization.

For example, this Jira workflow doesn’t have global transitions, so if the user transitions from the final state to the initial state in Azure, this will throw errors because in Jira a transition from the Closed status to the Open status doesn’t exist.

Jira Workflow:

...

Azure Workflow:

...

\uD83E\uDD14 Problem

When transitioning items from ADO to Jira, an error message like: ‘Not available transition to the desired status’ is visible.

This error usually happens when the Jira workflow does not have global transitions, which is how Azure DevOps workflows work.

...

\uD83C\uDF31 Solution

Global transitions are strongly recommended when working on initial synchronizations and continuous synchronizations; that way, the Jira workflow can mirror how workitems behave in Azure DevOps.

For example, when starting an initial synchronization from Azure DevOps to Jira, the new Jira issue will follow the transition changes the workitem had.

If the Jira workflow is configured like this:

...

The workitem migration to Jira might fail, even when all statuses are mapped in TFS4JIRA, because the workitem historical transitions are like this:

...

According to the Jira workflow above, there isn’t an available transition from the ‘Open’ status to the ‘On Hold' status, so this workitem would be migrated to Jira to the incorrect status ‘Open’ instead of the 'In Review’ status.

To prevent this kind of error, and to avoid asking the customer to change their current restrictive configuration, the customer should add global transitions to the Jira workflow and these transitions must global transitions should be added to each state of the Jira workflow.

Info

Changing the workflow transitions to global transitions will allow all Jira users to use them. If this is not the desired result, then these global transitions should have a condition that only allows the TFS4JIRA add-on to use

...

Jira Workflow:

...

Azure Workflow:

...

them.

Image Added

Filter by label (Content by label)
showLabelsfalse
max5
spacescom.atlassian.confluence.content.render.xhtml.model.resource.identifiers.SpaceResourceIdentifier@bc3e0baf
maxCheckboxfalse
showSpacefalse
sortmodified
typepage
reversetrue
labelskb-troubleshooting-article
cqllabel in ( "tfs4jira-troubleshooting-article" , "tfs4jira-action-connect" , "tfs4jira-product-jira" ) and type = "page" and space = "SUPPORT"