Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Excerpt

A post-function that will unlink issues from the current issue based on the result of a Nunjucks condition.

To add '

Link

Unlink issues

to

from the current issue' post-function to a transition: 

  1. Click Edit for the workflow that has the transition you wish to add the post-function on.

  2. In the Workflow Designer, select the transition.

  3. Click on Post

Functions 
  1. Functions in the properties panel.

  2. Click on Add post function.

  3. Select Unlink issues from the current issue from the list of post-functions.

  4. Click on Add

 to
  1.  to add the post-function on the transition.

Image Removed
  1. Image Added
  2. Add a Nunjucks condition in the Condition

.Select the Options provided to add required parameters
  1. .

  2. Click on Add to add the post-function to the transition.

warningtitle
borderColorSilver

Known limitations

Common

common to all post-functions:

Filter by label (Content by label)
showLabelsfalse
max5
spacesKB
showSpacefalse
sorttitle
typepage
cqllabel = "common-issue" and type = "page" and space = "
KB
JMWEC"
labelskb-troubleshooting-article
Page Properties
hiddentrue
Related issues
Panel
titleRelated links

For information on where the post-function needs to be placed on a transition, see Placing post-functions in a transition.

Refer to the Use cases for the post-functions page for use cases for this post-function.

Refer the Troubleshooting and Support page if the post-functions does not seem to be working as you would expect.


Info

JMWE shows an error message on the issue view if any error occurs during the execution of the post-function. This message is displayed only if the current user is a Jira administrator. 

When you add this post-function to a transition and trigger

the transition

it, the add-on

unlinks

checks the specified condition against each linked issue of the current issue

from all issues it is linked to, if the specified Nunjucks condition returns any text except false.

Condition: Input a Nunjucks template that returns true or false. You can insert Nunjucks annotations in your condition to insert issue ans transition information.

Examples:

  • project = TEST, returns the issues of the project whose key is TEST
  • assignee is EMPTY returns all the unassigned issues.
  • project = project = PSDF and reporter = {{currentUser.name}}
  • project=TEST order by created desc

Max. Issues: Input the maximum number of issues that the JQL search should return. The value should not be more than 50.

Link type: Select the link type to be created between the current issue and the issues returned from the JQL search.

Customise

. If the condition evaluates to any text except false or an empty string, it will remove the issue link. If not, it will not remove the link.

Condition 

Input a condition in Condition using Nunjucks annotations. You can insert issue, linkedIssue, transition, linkTypeName, currentUser and now variables in your condition and test it using the Nunjucks tester.

Examples:

  • {{linkTypeName == "blocks"}} returns true for all linked issues linked to the current issue with blocks link type

  • {{linkedIssue.fields.status.name == "Rejected"}} returns true for all linked issues that are in the Rejected status.

Customize this post-function using the additional options provided as part of the post-function. The options are:

Run As

  • Run as current user

  • : The current user will be the author of the removal of

the field change
  • issue links.

  • Run as add-on user

  • : The add-on user will be the

author of the field change. 
  • author of the removal of issue links.

  • Run as this user

  • : Any user selected in this field will be

the author of the field change
  • the author of the removal of issue links.

Conditional

Delayed execution

To execute this post-function based on the result of a Nunjucks template see Conditional execution.
Include Page
Delayed execution
To delay the execution of this post-function see 
Delayed execution
.