Using Nunjucks Templates

Introduction to Nunjucks

One of the powerful features of JMWE is the ability to use Nunjucks templates to calculate field values dynamically, including text and date values for Jira fields, setting links between Jira issues using complex logic, and calculating transition values for Jira issues using values from other issues. Nunjucks is a sophisticated templating engine for JavaScript. It allows for dynamic content generation in any text field through the use of templates. A template contains variables and/or expressions, which get replaced with values when a template is rendered; and tags, which control the logic of the template. 

Nunjucks in JMWE for Jira Cloud

Nunjucks in JMWE for Jira Cloud can be used to insert information in a variety of configuration values for numerous extensions; both issue and transition information can be inserted into new values using the various templating features. These include:

• Setting post-function field values

  • Set issue fields

  • Set field value of linked issues

  • Comment issue(s)

  • Comment linked issues
    
    

• The Create issue(s) post-function to

  • Calculate a project by selecting Calculated for the Project field under Destination

  • Calculate a parent issue key by selecting Another issue for the Parent issue field (only available when Issue type is set to Sub-task)

  • Set specific fields of new issue by selecting Set field value to for any field added under Set specific fields of new issue(s)

  • Add dynamic values when using the Add a comment to the current issue option

• The Email issue(s) post-function to

  • Write the Subject, HTML body, and/or Text body fields

  • Set recipients from the Users from template and Groups from template fields

• The Conditional Execution section to conditionally execute a post-function

• Calculating the transition to be triggered in Transition post-functions

  • Transition issue(s)

  • Transition linked issues

  • Transition parent issue

• Unlink issues from the current issue post-function to unlink issues based on the result of a Nunjucks template

• Link issues to the current issue post-function to generate an expression for the JQL search expression field

Additional Information

Additional information on accessing the data about an issue or a transition can be found on Issue and Transition Data.

Use cases that include Nunjucks annotations can be found on Use cases for post-functions.