Versions Compared

Key

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

...

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.

Info

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 (Only User Picker supported, for now)

    2. Name
      (Placeholder name
      Will be shown to users and must be unique)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

Info

Currently, only placeholders of the user picker type are supported. We are actively working on incorporating additional types as well.

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.

...

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

...

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

...