1. Creating Custom 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 ‘Manage Variables’ page displays SYSTEM and CUSTOM variables sections. In our example, no one has created a custom variable yet, so only SYSTEM variables are displayed on the page.
Let's add two new CUSTOM 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 ‘Manage Variables’ page now looks like this:
2. Adding variables to the template
Let's create a new ‘Congratulations upon hiring’ template. Add congratulations in the description and use both variables types:
SYSTEM variable - today
CUSTOM variables - directorsName and companyName
Note that you must enter the dollar sign($) before the variable name.
Save the new template using the 'Save' button.
3. 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 ‘Create Issue’ dialog will open. Use the ‘Select Template’ button to select the ‘Congratulations upon hiring’ 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 - the current date will be substituted
for the CUSTOM variables directorsName and companyName - their default values
4. SYSTEM variables for the template
Templates cannot use all SYSTEM variables. Some of the SYSTEM variables are needed only for hierarchies.
The SYSTEM variables for templates are: time, today, dateTime, tomorrow, nextWeek, username, userEmail, projectKey, projectName, projectLeadName.