Power Actions Wizard Configuration

Owned by Jonathan Muse
Last updated: Oct 11, 2024 by Shane Smith
2 min read

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

  1. Go to the Power Actions custom field configuration (Jira Admin → Custom Fields)

  2. Click the Edit Buttons link on the custom field configuration

  3. Click the code icon next to the appropriate field button

     

  4. A special version of the SIL Editor will appear.

  5. Click the plus icon next to the first screen in your wizard

     

  6. A new step (screen) will appear in the list with its own set of scripts that can be customized.

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.