Создать задачу в Трекере

В форме можно настроить интеграцию с Трекером, чтобы автоматически создавать задачи при заполнении формы. Ответы пользователя передаются из формы в Трекере, и на их основе создается задача. Например, такие формы удобно использовать для приема заявок на обслуживание или сбора сообщений об ошибках. Подробнее о задачах читайте в Справке Трекера.

Настроить создание задач в Трекере

1. Выберите форму и перейдите на вкладку Интеграции.

2. Выберите группу действий, в которой вы хотите настроить создание задачи, и внизу группы нажмите кнопку Трекер.

3. Введите ключ очереди, в которой будет создана задача.

4. Чтобы создать подзадачу, включите опцию Сделать подзадачей и введите ключ родительской задачи.

5. Задайте тип, приоритет задачи и настройте другие параметры:

   • В полях Автор, Исполнитель, Наблюдатели указывайте логин пользователя в формате user.

     Чтобы в поле Наблюдатели указать несколько пользователей, введите их логины через запятую (например, ivanov,petrov).

   • Если в настройках интеграции не задано значение поля Автор, и форму заполнил человек, состоящий в организации, то он будет указан автором задачи.

     Если форму заполнил неавторизованный пользователь, в поле Автор записывается Робот сервиса Трекер Робот (yndx-tracker-cnt-robot@).

   • Значения остальных полей вводите в точности, как они указаны в Трекере.

   • Чтобы добавить в поля Компоненты или Теги несколько значений, введите их через запятую.

   • В описании задачи можно использовать разметку YFM. Подробнее читайте в Справке Трекер.

   Примечание

   В полях Автор, Исполнитель, Теги, Компоненты и подобных при вводе значений не работает подсказка.

6. Если нужных параметров задачи нет в списке, добавьте их: нажмите кнопку Добавить параметр задачи и начните вводить название, затем в подсказке выберите подходящий параметр.

   Подробнее о параметрах задач читайте в Справке Яндекс Трекер.

7. Чтобы добавить в поля задачи ответ на вопрос или другие данные из формы:

   1. Выберите поле и нажмите значок справа.

   2. Выберите в списке переменную, которую нужно добавить в поле.

   Например, если с помощью формы вы собираете сообщения об ошибках, вы можете добавить в описание задачи сообщение пользователя и техническую информацию.

   Вы также можете добавить в поле переменную Ответ на вопрос. Если в тексте ответа содержатся элементы разметки YFM, они автоматически преобразуются в элементы форматирования текста при добавлении ответа в описание задачи в Трекер.

   

   Важно

   Чтобы добавить в поля Автор, Исполнитель, Наблюдатели сотрудника, указанного в ответе на вопрос типа Люди, добавьте в поле переменную Идентификатор варианта ответа на вопрос. Если вы используете переменную Ответ на вопрос, интеграция не сработает.

8. Чтобы после заполнения формы пользователь получил ссылку на созданную задачу, под заголовком действия включите опцию Показывать сообщение о результате действия.

9. Нажмите Сохранить.

Чтобы создать несколько задач одновременно, добавьте новые действия с помощью кнопки Трекер внизу страницы.

Пример

Если нужно создавать задачу, только когда пользователь ответил на вопросы определенным образом, задайте условия.

Пример интеграции с Трекером для формы с заявкой на закупку оборудования. С помощью такой формы сотрудники смогут оформлять заявки на оборудование в виде задач для отдела закупок.

Встроить форму в интерфейс Трекера

Вы можете настроить форму для создания задач и встроить ее в интерфейс Трекера. Такая форма будет отображаться на странице создания задачи рядом со стандартной. Она поможет пользователям создавать задачи по определенному шаблону, не отвлекаясь на лишние поля и параметры. Подробнее о формах в Трекере читайте в документации Трекера.

Решение проблем

Чтобы проверить, какие ошибки происходят при выполнении интеграций в вашей форме:

1. Откройте форму, которой в интеграция не работает или работает неправильно.

2. Перейдите на вкладку Интеграции и нажмите ссылку Выполненные интеграции.

3. Проверьте, есть ли в списке сообщения об ошибках при выполнении вашей интеграции.

4. После устранения проблемы попытайтесь повторно запустить создание задачи.

5. Если проблему не удалось решить, обратитесь в службу поддержки.

Ошибка в полях Автор, Исполнитель, Наблюдатели

Возможная причина ошибки в том, что из формы в поля задачи Автор, Исполнитель или Наблюдатели передаются неверные данные. Заполните эти поля следующим образом:

• Чтобы добавить сотрудника вручную, указывайте логин пользователя, например ivanov.

• Чтобы добавить сотрудника, указанного в ответе на вопрос типа Люди, вставьте в поле переменную Идентификатор варианта ответа на вопрос. Если вы используете переменную Ответ на вопрос, интеграция не сработает.

• Чтобы добавить сотрудника, указанного в ответе на вопрос типа Выпадающий список или Несколько вариантов, в качестве вариантов ответов задайте логины пользователей (например, ivanov) и используйте переменную Ответ на вопрос.

Если в поле Автор возникает ошибка, но поле при этом заполнено верно, убедитесь, что у заполнившего форму пользователя есть доступ на создание задач в указанной очереди Трекера.

Ошибка: нет прав на запись в очередь

Причина ошибки в том, что у пользователя, который заполнил форму, нет прав на создание задач в указанной очереди Трекера. Попросите владельца очереди проверить права доступа.

Некорректно отображается описание задачи

Если вы использовали разметку YFM для оформления текста в поле Описание, убедитесь, что в вашей разметке нет ошибок. Чтобы проверить, как будет выглядеть ваш текст с разметкой, вставьте его в описание задачи в Трекер или на страницу Вики.

Например, текст может отображаться некорректно, если отсутствует пустая строка перед блочным элементом (например, {% note %}) или добавлены лишние пробелы после закрывающего элемента блока HTML (::: ). Подробнее о разметке читайте в Справке Трекер.