Versions Compared

Key

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

1. Creating global variables

You can use variables when creating a template. In this section, we will figure out how to do this using a specific example.

The Variables page displays system and global variables. In our example, no one has yet created global variables, so only system variables are displayed on the page.

Let's add two new global variables: companyName and directorsName.

...

To do this, click on the "Create variable" button.

In the window that appears, you must specify the name of the new variable and the default value of this variable.

...

The Variables page now looks like this:

...

2. Adding variables to the template

Let's create a new template “Congratulations upon hiring”. Add congratulations in the description and use two variables:

  • system variable - today

  • global variables - directorsName and companyName

...

Note that you must enter the dollar sign($) before the variable name.

Save the new template using the “Save” button.

...

The Template can use these variables:

The variable can be used only in the single and multiline text fields - Description, Summary, Environment, etc.

Using variables in the Template created from scratch

The Variables can be added to the Template created from scratch in the Create/Edit Template Content dialog.

Info

How to create a Template from scratch:

https://appsdelivered.atlassian.net/wiki/spaces/SITFJC/pages/1707475335/Create+Template#Create-a-Template-from-Scratch

To see all available variables - type $var and the list with system and custom variables will be shown. After that click on the needed variable name to paste the selected variable.

...

Using variables in the Template created from the existing issue

To use variables in the Template created from an existing issue - you can add these variables to the Jira Issue during the Creation/Editing Jira issue or during applying the Template via the ‘Advanced Issue Creation’ mode

If you use the variables in the Jira issue it can look like this:

...

After that, you need to create the Template from this Jira Issue.

...

After applying the value of the variable will be automatically applied to the newly created Jira Issue

...

Info

How to create a Template from the existing issue:

https://appsdelivered.atlassian.net/wiki/spaces/SITFJC/pages/1707475335/Create+Template#Create-a-Template-from-the-Existing-issue

Using variables in the Template created from the Hierarchy Node

To use variables in the Template created from the Hierarchy Node - you can add these variables to the HIerarchy Node during the Creation/Editing Hierarchy Node or during applying the Template via the ‘Advanced Issue Creation’ mode

If you use the variables in the Hierarchy Node it can look like this:

...

After that, you need to create the Template from this Hierarchy Node.

image-20240328-082532.pngImage Added

After applying the value of the variable will be automatically applied to the newly created Jira Issue

...

Info

How to create a Template from the Hierarchy Node:

https://appsdelivered.atlassian.net/wiki/spaces/SITFJC/pages/1707475335/Create+Template#Create-a-Template-from-Hierarchy-Node

Applying a template with variables

A template with variables is applied in the same way as a template without variables. Create a new issue using the "Create" button

...

The issue creation window will open. Use the “Select Template” button to select the “Congratulations upon hiring” template.

...

During applying the Template via the ‘Advanced Issue Creation’ mode you can add variables to the Template, you need to type $var, to see all available variables that can be used.

...

Info

How to apply Template: Apply Template

Those template fields that have been filled in will be automatically copied to the corresponding issue fields. Variable names will be replaced with values:

  • for the system variable today tomorrow- the current date of the next day will be substituted

  • for global variables directorsName and companyName - their default values

...

4. System variables in the template

Image Removed

Info

Templates cannot use all system variables. Some of the system variables are needed only for hierarchies. The following system variables can be used in templates: time, today, dateTime, tomorrow, nextWeek, username, userEmail, projectKey, projectName, projectLeadName.