How to change the workflow buttons on the issue screen?

PlanningDev February 26, 2013

Is there a way to make the buttons on the issue screen follow a custom workflow? I added a step called "ready for migration to prod" however in order to move the issue to the step you have to find it in the drop down vs being able to just click the button.

Right now I just see "Resolve" and "Close" for the buttons.

Thanks

18 answers

1 accepted

34 votes
Answer accepted
Matheus Fernandes
Atlassian Team
Atlassian Team members are employees working across the company in a wide variety of roles.
February 26, 2013

Hello,

To change how many buttons are displayed in the Issue View, you'll need to:

  1. Edit the <tt>jira-config.properties</tt> file in your JIRA Home Directory - if you don't have this file, you'll need to manually create it (see Advanced JIRA Configuration);
  2. Add the following property in a new line, and change the X to the number of transition buttons required <ins>before</ins>the 'Workflow' button:
    ops.bar.group.size.opsbar-transitions = X
    
  3. Save the updated <tt>jira-config.properties</tt> file;
  4. Restart JIRA.
    Please note that it is not possible to set this value to "0", as mentioned in this bug report: JRA-25264.

To change the order of transition buttons and 'workflow' menu items, you'll need to add the property key '<tt>opsbar-sequence</tt>' to each workflow transition that you wish to re-order. To do it, please:

  1. Access the workflow transition's properties - <tt>Administration » Workflows » 'Your Workflow' » 'Your Transitions' » View properties of this transition</tt>;
  2. Type <tt>opsbar-sequence</tt> into the 'Property Key' field in the 'Add New Property' section;
  3. In the Property Value field, type a positive integer value (starting at '0') that defines the order of the transition action on issue views (lower values equals the first transitions to appear);
  4. Click the Add button.

For each workflow transition, you may wish to use gaps in your <tt>opsbar-sequence</tt> property values (for example, 10, 20, 30, etc.) rather than consecutive values. This will allow you to 'insert' new workflow transitions more easily at a later point in time.

Also, more information about how to configure this can be found in our Customising workflow transitions on the 'view issue' page documentation.

I hope this helps!

Best regards,
Matheus Fernandes

Karel Skokan February 27, 2013

I am not sure if it works in JIRA ver 5.2.x

I tried it without success.

Matheus Fernandes
Atlassian Team
Atlassian Team members are employees working across the company in a wide variety of roles.
February 27, 2013

Hi Karel,

I've just tested with JIRA 5.2.7 and works fine. Just please ensure the file is jira-config.properties not jira-config.properties.txt, for example; and that there is no white space after the '= X' (i.e. '= 5 '). Try with this file attached (remove the .txt in the end of the file - Answers didn't allow me to upload a .properties file :P). (jira-config.properties.txt)

Cheers,
Matheus Fernandes

Matheus Fernandes
Atlassian Team
Atlassian Team members are employees working across the company in a wide variety of roles.
February 27, 2013

No worries. :)

Yes, the jira-config.properties file needs to be stored inside the JIRA Home directory - the same folder where .jira-home.lock and dbconfig.xml are stored. After copying the file to this folder and ensuring the option is correctly configure, just restart JIRA. After that it should work. :)

Karel Skokan February 27, 2013
Hi Matheas, Thanks For your replay. Actually I writedown this parameter to file JIRA-application.properties not to JIRA-config.properties. Probably this is a reason for unsucesss. :-(. Where you have stored this file? In same directory as JIRA lock file? Thanks for help. Last time when I work actively work with JIRA it was with version 4.x. A lot of things are new for me.
RambanamP
Rising Star
Rising Star
Rising Stars are recognized for providing high-quality answers to other users. Rising Stars receive a certificate of achievement and are on the path to becoming Community Leaders.
February 28, 2013

Oracle or Mysql will be suggestable to use as a database for jira

Karel Skokan February 28, 2013
Thank for your advice. It is working properly. Btw: which DB are you use for JIRA? Have a nice day.
Karel Skokan February 28, 2013

We use both. For current instance we have MySQL, but we have some troubles with collation. We use UTF-8 and collation by CZECH alphabetic order. Correct collation is c,č,d,... when we use SQL querry to database, we receive correct order of items. But when we want to sort issues in Issue Navigator based on Summary fields, the issues from standard alphaber appear first, than issues started with special characters which is used in Latin2 or Win1250 codeset. It means for example:

ALOHA
BETA
CEYLON
DAVID
EROS
....
ZOO
ČESKO
ŽÍŽALA

and another story is suppress sorting UPPER/LOWER CASE. :-)

KSK

Matheus Fernandes
Atlassian Team
Atlassian Team members are employees working across the company in a wide variety of roles.
February 28, 2013

Have you configured the Indexing Language in JIRA? Try setting it to Czech https://confluence.atlassian.com/display/JIRA/Configuring+JIRA+Options

Patrick Richards September 26, 2013

Is there any way to reorder them in the hover menu that shows up when you hover over the gear on the right of any issue in either the filter view or a list of sub-tasks on a parent issue? I have tried the opsbar-sequence approach, which works when you're on the issue page itself in the upper navigation bar but it doesn't seem to apply when using the "hover" menu.

thanks

Kevin (Fake) March 5, 2014

Matheus - Not sure if I'm technically adept enough to mess with the XML file. I'm also worried about affecting other projects at my company. Are you saying there is no simple way (within JIRA) to put the buttons in order or choose which ones display under the "Workflow" dropdown?

MattS
Rising Star
Rising Star
Rising Stars are recognized for providing high-quality answers to other users. Rising Stars receive a certificate of achievement and are on the path to becoming Community Leaders.
March 5, 2014

There are ways to do it (the order you create transitions, the opsbar-sequence transition property) but I've found editing XML is faster and more precise

Laszlo Kremer
Rising Star
Rising Star
Rising Stars are recognized for providing high-quality answers to other users. Rising Stars receive a certificate of achievement and are on the path to becoming Community Leaders.
March 23, 2014

Thanks, cool! The opsbar-sequence trick does the work nicely! messing with the xml may look faster, but you'll take care of the xml format, and you'll need to be very careful with importing. Re-adding transitions are also prone to errors as you may forget a validator or a post-function.

Thanks again!

3 votes
Thorbjørn Sigberg April 2, 2013

How do I do this on JIRA On-demand?

priory_rory April 15, 2013

I can't see any way to change the number of buttons, but changing the order as described does work for me in OnDemand.

Thorbjørn Sigberg April 16, 2013

I was also able to change the order using on-demand by adding the opsbar-sequence, thanks for pointing that out! :)

2 votes
William Crighton _CCC_
Rising Star
Rising Star
Rising Stars are recognized for providing high-quality answers to other users. Rising Stars receive a certificate of achievement and are on the path to becoming Community Leaders.
July 21, 2014

We wrote a plugin to do this and believe it's worth it's price if you have a large installation. The plugin provides a drag and drop gui and allows reordering of workflow transitions within a step (reordering workflow transition steps is the next feature in our roadmap for the plugin).

You can find more out/install it/etc from the Marketplace page

We're currently offering a promotion for folks interested in our CCC Last Comment plugin where we include a free license to Transition Reorder X (what we call it) - had nearly $10K in sales of last comment since the promo went live and...nobody's bothered to download TRX. Strange when you can't even give it away...

-wc

1 vote
William Crighton _CCC_
Rising Star
Rising Star
Rising Stars are recognized for providing high-quality answers to other users. Rising Stars receive a certificate of achievement and are on the path to becoming Community Leaders.
June 4, 2014

Hi! Please excuse the blatent marketing. We have a plugin - CCC Transition Reorder X - which allows you to reorder workflow transitions via a drag'n'drop GUI. You can find more out about it/download a free trial - here:

Please let me know what you think

wcrighton@capitalcityconsultants.com

To modify the number of workflow options you can see available on an issue you need to modify the file jira-config.properties located in your <jira.home> directory. If the file does not exist just create it. Here is an example file we use in our production system:

--PRODUCTION--:root@ns1:[/home/jrasvr/prod/jira.home]
--PRODUCTION--(05:11:28)--&gt; cat jira-config.properties 
#
# This is dfault group size for the View Issue Operations Bar group size (before adding a dropdown)
#
#ops.bar.group.size = 2
#
# This is the size of the actions group in the Operations Bar
#
#ops.bar.group.size.opsbar-operations = 2
#
# This is the size of the workflow group in the Operations Bar
#
ops.bar.group.size.opsbar-transitions = 5
#
# -- 20120114 - WC - Added to allow creation of reports greater than 2 months
jira.timesheet.plugin.maxDays = 800

NOTE: you want to modify the uncommented line reading 'ops.bar.group.size.opsbar-transitions = 5' changing the number '5' to whatever number of transitions you wish to always display as a button.

-wc

1 vote
MattS
Rising Star
Rising Star
Rising Stars are recognized for providing high-quality answers to other users. Rising Stars receive a certificate of achievement and are on the path to becoming Community Leaders.
October 30, 2013

If you want the ultimate control over this, export the workflow XML and change the order in the XML, then reimport it. The schema isn't too complex

0 votes
Mat_Chavez March 1, 2017

Key factor - you can't do it using the Diagram view.

In Diagram, if you go to the properties of the transition, it's only the transition.

In List, you can select the properties of the individual transition from single state to single state. That's what you give a 0-99 value. You do that to each transitional permutation, and for the cloud version at least, you get lowernumber, nexthighernumber, Workflow. Unless you have exactly 3, which you get low, medium, high. Until they add the ability to change ops.bar.group.size for Cloud, that's all you get.

The most confusing, time sucking problem with the documentation is that there is no UI difference between the general transition "Properties" and the single-state-to-single-state transition "Properties".

Good luck all.

 

0 votes
John Bayne
Rising Star
Rising Star
Rising Stars are recognized for providing high-quality answers to other users. Rising Stars receive a certificate of achievement and are on the path to becoming Community Leaders.
March 18, 2015

Hi,

 

I'm on 6.3.12 and just want to check that if I wish to increase the number of state transition buttons on the detail screen, then I have to edit the file as per the above advice?

 

1) This resource cannot be maintained via the GUI?

 

2) If I make this change will it survive upgrade to JIRA or wil I have to redo it after upgrade?

 

Thanks

0 votes
Michael Schwager March 10, 2015

Works like a champ in JIRA 6.3.15.

0 votes
Senouci Zoulikha June 4, 2014

Hello,

I work woth JIRA 4.4.1, and I would like to modifie the buttons dispalyed on Issue type. I understand I have to modifie the jira-configuration.properties file but I don't have this file in my JIRA Home Directory.

It's normal,? may be I made a mistake when I installed the application JIRA in my server?

Can you help me please,

Thanks

0 votes
Richard olsson April 2, 2014

Isn't that what this article is all about...?

You can switch place of the "Close" and "ready for migration to prod" buttons with the "opsbar-sequence" parameter described in this article.
Because I don't think you can add more buttons with On-Demand. But possible with local installation as described here.

0 votes
Richard olsson April 2, 2014

Hi,

Still no support for number of status transition buttons in menu for On-Demand?

0 votes
Cristian _Southend_ February 5, 2014

it is working properly in Jira 6.1.6

Thank you!!!

Matheus Fernandes
Atlassian Team
Atlassian Team members are employees working across the company in a wide variety of roles.
February 5, 2014

You are most welcome! :)

0 votes
Higashi
Rising Star
Rising Star
Rising Stars are recognized for providing high-quality answers to other users. Rising Stars receive a certificate of achievement and are on the path to becoming Community Leaders.
November 4, 2013

It works better if all transitions has it's own weight

0 votes
Patrick Richards October 31, 2013

Now that this is getting a little traction again.., has anybody figured out how to order the transitions in the hover menu accessed via the gear icon on the right?

MattS
Rising Star
Rising Star
Rising Stars are recognized for providing high-quality answers to other users. Rising Stars receive a certificate of achievement and are on the path to becoming Community Leaders.
November 4, 2013

Do you mean the Workflow button with all the transitions in it except the first two? Those are affected by the same methods described above - transition properties and ordering in the XML file

0 votes
skjar October 31, 2013

THAT I never thought about. Thanks :-)

0 votes
skjar October 30, 2013

seems like the value is limited for 0-99

I have values 1, 2 and 3 and it worked.

but add a transition value = 100 place this transition in front.

So 100 comes before 0??

Replace 100 with 10 works

0 votes
skjar October 30, 2013

Thank you. You saved my day.

This sort order problem on transition was driving me nuts.

0 votes
Karel Skokan February 28, 2013

done as first during configuration, there is something else

I already asked atlassian (https://support.atlassian.com/browse/JSP-150890). :-)

Suggest an answer

Log in or Sign up to answer
TAGS
AUG Leaders

Atlassian Community Events