Start integrating with ONEiO for free!

How to handle JIRA Statuses With Transitions

When it comes to changing the status of an issue, JIRA has a slightly different approach from most tools. JIRA is a workflow-based tool, which means the status of an issue cannot be changed by updating the issue with a new status value. Instead, you need to do a transition to the issue. A transition is a pre-defined object, that describes a move between different statuses.

For example.

  • To move the status from Open to In Progress, you need to set a transition Start working on the issue.
  • To move the status from In Progress to Resolved, you need to set a transition Resolve to the issue.

With integrations, this brings additional things to consider. First of all, to be able to set a correct transition, you need to know the current status of the Jira issue before the needed update. This can be done by saving (and updating) this value in a conversation variable in ONEiO. Remember that this mapping needs to be included in both directions.

The following table shows an example of how to do the mapping according to the pre-stored JIRA status and the status included in the inbound message from the other tool.


New tool State
Last JIRA Status
Transition (id)
JIRA to state
New   ->   Open
Assigned Open -> Accept (id=1) Accepted
ANY Open   Illegal transition  
In Progress Accepted -> Start working (id=2) In Progress
ANY Accepted   Illegal transition  
Awaiting customer In Progress -> Start Waiting Customer (id=3) Awaiting Customer
Pending In Progress -> Start Waiting 3rd Party (id=4) Awaiting 3rd Party
Resolved In Progress -> Resolve (id=5) Resolved
ANY In Progress   Illegal transition  
In Progress Awaiting Customer -> Set In Progress (id=6) In Progress
ANY Awaiting Customer   Illegal transition  
In Progress Awaiting 3rd Party -> Set In Progress (id=6) In Progress
ANY Awaiting 3rd Party   Illegal transition  
Closed Resolved -> Close (id=7) Solved
In Progress Resolved -> Reopen (id=8) In Progress
ANY Resolved   Illegal transition  

As you can see, there is usually a technical possibility to set a wrong state in the other tool, which then results in an error in the workflow. There are usually two different ways to handle this problem.

  1. Trying to set an illegal transition to the JIRA issue will result in a synchronous error response. A rule in ONEiO can be set to forward this error back to the ticket from where the illegal state was triggered. With this information, the user is then able to fix the wrongly set status value.
  2. There is a possibility to configure JIRA so that ONEiO integration will have dedicated transitions. With this option, the status mapping configuration becomes in most cases significantly less complicated, but in some cases, the policy of the tool/process does not allow it. 
Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request



Please sign in to leave a comment.