Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 3 Current »


Make your project templates even more powerful by adding placeholders to it.

Once you create a placeholder you can add it anywhere in the template settings.

During the project creation process, the user will be prompted to provide values for the placeholder and the app will automatically replace all the placeholders for the new project.

The placeholders {{projectName}} and {{projectKey}} are natively supported and therefore reserved names. You can use these placeholders in any text field within the template settings, and they will automatically be replaced with the project name and key, respectively, during project creation.

Create new placeholders

  1. Click either on ‘2. Configure template settings and predefine components/versions/issues' in the dialog or on the settings icon in under Actions.

  2. In the template settings modal, click on the tab ‘Placeholders’.

    image-20240723-135345.png
  3. Click on ‘Create placeholder’.

    image-20240723-135452.png

  4. Specify the new placeholder.

    1. Placeholder field type

    2. Placeholder name
      Will be shown to users and will be used to place the placeholder inside the template settings using this syntax: {{placeholderName}}. Must be unique, alphanumeric and max 80 characters long.

    3. Default value
      Preselect values in the placeholder prompt for users during project creation

  5. Click on ‘Create’

    image-20240723-135559.png

    Once the placeholder is created it can be selected in other areas of the project template.

Select placeholders inside the template

Text Field Placeholders

Text Field placeholders can be used inside every text field of the template settings. The available text field placeholder will be shown in the field description and can be copy pasted from there.

Examples usages:

  • To write a dynamic project description that replaces the customer name individually for each project.

image-20240731-130654.png

  • To create predefined issues with a dynamic summary and description using placeholders.

image-20240731-131040.png

User Picker Placeholders

User Picker Placeholder can be selected inside the dropdown of user pickers.

Examples usages:

  • To allocate project roles to the users selected within a placeholder.

    image-20240723-135916.png
  • To assign the project lead, reporter of cloned issues, component lead of predefined issue or assignee/reporter of predefined issue to the user selected inside a placeholder.

    image-20240723-140045.png

Prompt for Placeholder Selection During Project Creation

When a user initiates a new project, they will be prompted to input values for various placeholders within the project creation interface.

The placeholders will come with default values preselected for convenience.

Throughout the project creation process, the application will seamlessly integrate the user-selected placeholder values into the project template, replacing all instances where the placeholders were initially designated.

image-20240723-140240.png

  • No labels