Power Actions Configuration

Owned by Alexandra Topoloaga (Unlicensed)
Last updated: Oct 21, 2021 by Jonathan Muse

Looking for the documentation on the newest versions of Power Actions for Jira 8? Click here and leave these dusty old pages behind!

Power Actions™ wizard is implemented as a list of steps that start from the main button. You can configure them on the custom field configuration page.

The configuration page displays a list of buttons with their steps. A button is actually the first screen of the wizard.

For every button you can do the following operations:

  • edit the scripts – condition, screen, and action
  • change the description
  • rename it
  • add or remove a step
  • reorder the steps to suit your needs. 

Adding new steps

In order to add a new step, click the Add Next Step button (the "+" icon) for the needed button. A new line with a step is added to the configuration table. 

The name of the step starts with the word "Step" and its position in the list. This is non-editable data but for your convenience, you can change the description of the step by clicking Change Description. 

For each step you can also configure the scripts.

You can reorder the steps within a button, but the step names will always retain the current position of the step.

Configuring a step

The condition script for a step is similar to the one for a button, you can decide whether an action should be available for the user or not. By default, when you add a new action, it will have the following default condition script.

number ENABLED = 1;
number DISABLED = 2;
number HIDDEN = 3;
 
return ENABLED;

The script should return one of the predefined variables: ENABLED, DISABLED, or HIDDEN. The main difference between the condition script for a button and the condition script for a step is how we interpret the DISABLED / HIDDEN values.

  • Enabled actions are visible and available for the user to execute
  • Disabled actions mean that the screen for the action will not be visible and thus unavailable for the user to execute
  • Hidden actions mean that the screen for the action will not be visible but the action script will still be executed

Of course, with the help of Simple Issue Language (SIL), the return value of the script can be conditional.

number ENABLED = 1;
number DISABLED = 2;
number HIDDEN = 3;
 
if(<some_condition>){
    return ENABLED;
}
if(<some_other_condition>){
    return DISABLED;
}
return HIDDEN;

Sharing values between wizard screens

You can configure a wizard so that certain values on the wizard screen depend on other values from another screens. For this we implemented additional routines that help with the sharing mechanism.

See also