Creating an issue in Yandex Tracker

You can integrate your form with Yandex Tracker to automatically create issues when users complete the form. User responses are sent from the form to Yandex Tracker, where an issue is created based on them. For example, these forms add convenience when accepting service requests or collecting error messages. For more information about issues, see Yandex Tracker Help.

Set up issue creation in Yandex Tracker

1. Select the desired form and open the Integrations tab.

2. Select an action group for which you want to set up issue creation and click Tracker at the bottom of the group.

3. Enter the queue key to create the issue in.

4. To create a sub-issue, enable Convert to sub-issue and enter the parent issue key.

5. Set up the type, issue priority, and other parameters:

   • In the Author, Assignee, and Followers fields, specify a username in user format.

     To specify multiple users in the Followers field, enter their usernames separated by commas (for example, smith,johnson).

   • If the integration settings don't specify the Author and a user from your organization completes the form, that user will be specified as the issue's author.

     If an unauthorized user completes the form, Tracker robot (yndx-tracker-cnt-robot@) will be specified in the Author field.

   • Enter the values for the other fields exactly as they are specified in Yandex Tracker.

   • To add multiple values to the Components or Tags field, separate them with commas.

   • You can use YFM markup in the issue description. For more information, see Tracker Help.

   No suggestions appear when entering values in the fields such as Author, Assignee, Tags, or Components.

6. You can also create a new field if the one you need isn't available in the issue parameters. To do this, click Add issue parameter and start typing its name, then select the desired parameter from the suggested options.

   For more information about issue parameters, see Yandex Tracker Help.

7. To add an answer to a question or other form data to the issue fields:

   1. Select the field and click on the right.

   2. Select a variable from the list to add to the field.

   For example, if your form collects error messages, you can add the user's message and technical details to the issue description.

   Fields can also contain an Question answer variable. If the answer contains YFM markup elements, they will be automatically converted to text formatting elements when you add the answer to the issue description in Tracker.

   

   To add an employee specified in an answer for a People, to the Author, Assignee, Followers fields in Tracker, add a Question answer option ID variable to the field. If you use a Question answer variable, integration won't work.

8. To get a link to the new issue after filling out the form, enable the Show messages about the results of actions option under the action name.

9. Click Save.

To create multiple issues at once, add new actions by clicking Tracker at the bottom of the page.

Example

If you want an issue to only be created for users who give certain answers, set your conditions.

Example of Yandex Tracker integration for a form to request equipment. Employees can use this form to make equipment requests as tasks for the purchasing department.

Embed a form in the Yandex Tracker interface

You can set up a form to create issues and embed it into the Yandex Tracker interface. This form will be displayed on the issue creation page next to the standard one. It will help users create issues based on a certain template without being distracted by unnecessary fields and parameters. For more information about forms in Yandex Tracker, see the Yandex Tracker documentation.

Troubleshooting

To check for errors that occur during form integration:

1. Open the form where the integration is incomplete or doesn't work as expected.

2. Go to the Integrations tab and click Completed integrations.

3. Check the list for error messages related to your integration.

4. After resolving the problem, try creating an issue again.

5. If the problem persists, contact support.

Error in the Author, Assignee, or Follower fields

The error may be caused by invalid data being sent from the form to the Author, Assignee, or Followers issue field. Fill in these fields in the following way:

• To add an employee manually, enter a username like smith.

• To add an employee specified in an answer to a People,, insert a Question answer option ID variable in the field. If you use a Question answer variable, integration won't work.

• To add an employee specified in an answer for a Drop-down list or Multiple answers question, set usernames (for example, smith) as answer options and use the Question answer variable.

If an error occurs in the Author field, but the field is filled out correctly, make sure the user who submitted the form has permission to create issues in the specified Yandex Tracker queue.

Error: No rights to add issues to queue

This error occurs because the user who submitted the form doesn't have permission to create issues in the specified Yandex Tracker queue. Ask the queue owner to check access rights.

The issue description displays incorrectly

Check your YFM markup for errors if you used it to format the text in the Description field. To see how your marked-up text will appear, paste it into an issue description in Tracker or onto a Wiki page.

For example, the text may display incorrectly if there is no empty line before a block element (such as {% note %}) or if extra spaces are added after closing an HTML block (::: ). For more information about markup, see Tracker Help.