Adding extensions to transitions

Adding extensions

There are three ways to create an extension (a Post function, Condition, or Validator):

1. Add it directly to a transition through the Jira Workflow Editor. Each extension documentation page has specific steps for this method, including configuration information specific to that extension.

2. Use the Create new button on the JMWE Workflow Extensions administration page. See the Create new section for more details on this method.

3. Copy an existing post function to a Shared Action. See below for more details on this method.
   Note: only post functions can be copied using this method.

Once an extension has been added to a transition, you must publish the workflow for the new extensions to take effect!

Copying post functions to a Shared Action

You can copy an existing post function to a Shared Action, creating a copy of the post function that can then be applied to any other transition in your Jira instance through the use of the Shared action post function. This is a particularly useful when you have created a complex post function on a single transition, and have determined that it can be used in multiple places within your Jira projects. To copy a post function to a Shared Action:

1. In your Jira instance, click Settings in the upper right corner of the screen and select Issues.

2. In the left-hand panel, click Workflows.

3. For the workflow that contains the post function you want to copy, click the Action menu ( ) and select Edit.

4. Open the transition that contains the post function.

5. To the right of the JMWE post function name, click the Copy button (Figure 1, right).

6. The Add to shared action dialog will open. Select an existing Shared action from the top pulldown menu, or enter the name of a new Shared action in Name. Click Confirm.

Placment of post functions

The position, or order, of a post-function in the list of post-functions for a transition is an important factor for its proper execution. When adding a new post function to a transition, you must move it to the appropriate position, which depends on the type of transition (a Create transition or a standard one) and the type of post function you configure. There are a few considerations:

• On the Create transition
  You need to place any JMWE post functions after the Creates the issue originally built-in post function. Failure to do so will result in the creation of new issues raising an error (see https://ecosystem.atlassian.net/browse/ACJIRA-961  for details).
  
  

• On any regular transition
  On a regular transition, most post functions can be placed anywhere in the list, except for post functions that transition issues (see below). However, it is advisable to always move them to the bottom of the list anyway.
  
  

• Transition Issue(s), Transition Parent Issue, Transition Linked Issues post functions
  Post functions that automatically transition issues should always be placed at the end of the list of post functions. This applies to the following post functions:

  • Transition issue(s)

  • Transition parent issue (Deprecated)

  • Transition linked issues (Deprecated)