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

Интеграцию с Трекером могут настроить только пользователи Форм для бизнеса.

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

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

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

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

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

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

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

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

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

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

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

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

Как задать параметры задачи

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

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

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

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

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

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

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

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

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

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

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

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

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

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

    О разметке читайте в Справке Трекера.

Пример

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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