Integration in the Yandex Tracker interface

Yandex Tracker has a built-in form builder integrated with the Yandex Forms service. With the builder, you can quickly create a form linked to your queue. On the issue creation page, the user can select the desired form and fill it out — as a result, an issue will be created in the queue: How to create an issue in Tracker.

If the queue was created using the Support template, it already has a form integrated for receiving user requests.

Managing the queue's forms requires the Queue management access rights.

You can add up to 20 forms to one queue.

Step 1. Go to the form builder

  1. In the left-hand panel, click  Queues and select a queue.

  2. In the top right corner of the queue page, click  Queue settings.

  3. Go to Integrations → Forms. If the queue already has linked forms, click Go to form list.

  4. Click Add form → Create new.

    You can also add a new form on the issue creation page. To do this, select the queue in the field at the top of the page and click Create form. How to create an issue

    Раздел «Формы» в настройках интеграций очереди с меню добавления формы

  5. Enter a name and description for the form and click Next.

Step 2. Add fields to the form

  • To add the first question, select a question type from the suggested ones in the form creation area. To view the full list of types, click All questions.

  • To add another question to the page, click Add question or hover over the created question and click the icon. A new question will appear above the current one if you hover over the top part of the block.

  • To copy or delete a question, click or .

  • To add an illustration to the question text or answer option, click the icon.

  • To split the form into multiple pages, click the Add page button below the form creation area.

The built-in form builder supports only basic question types and integration settings. You can change the form's appearance, add additional questions, and configure their display logic in the full version of the builder in Yandex Forms: Yandex Forms Help.

To go to the Yandex Forms service, open the form and click the Full version of Yandex Forms button at the bottom of the page.

Step 3. Configure issue creation

  1. Open the Integrations tab and select Forms.

  2. In the Perform actions section, specify always.
    If you need to configure conditions under which an issue will be created, select on condition. Then select a question and specify the answer upon receiving which an issue will be created in Tracker.

  3. Specify the queue in which the issue will be created. To configure a link Parent issue — Sub-issue for the created issue, select the Convert to sub-issue option and enter the key of the parent issue.

  4. Select the Issue type and Priority of the issue. Available issue types depend on the queue settings: Issue types in the queue.

  5. Enter the issue name in the Summary field and the issue description in the Description field. Use YFM markup to format text.

  6. To assign the default reporter and assignee, enter user logins without the @ symbol. If no reporter is specified, the user who filled out the form will be assigned as the reporter by default.

  7. To add an issue field that isn't available in the list of issue parameters, select Add issue parameter and start typing its name, then select the desired parameter from the suggested options.

  8. If you want to save an answer to a certain form question in your issue parameters, select an issue field, click , then click Answer and select the question.

    Mapping a form question response to the issue summary

    For more information about variables, see Yandex Forms Help.

  9. To pass attachments from the form to the issue, in the Attach files from question responses field, select a question of the File type.

  10. To display a link to the created issue, enable the Show the action result message to the user option.

  11. You can also configure integrations with other services for collaboration:

  12. Click Publish.

The created form will appear on the issue creation page: How to create an issue in Tracker.

You can manage forms for creating issues on the queue settings page: Managing forms in a queue.

Learn more:

An issue key is a unique identifier contained in the issue link. It consists of the queue key and a number, for example TEST-123.

A queue is a space for issues related to a single process, product, team, or department. A queue helps you store issues in one place and manage work according to common rules.