Переменные в настройках интеграции
При настройке интеграции формы с другими сервисами вы можете передавать в сервис ответы на вопросы или другие данные из формы. Например, можно вставить ответы пользователя в текст письма или записать данные в поля задачи в Tracker.
Для этого используйте переменные:
-
В форме на вкладке Интеграции добавьте действие.
-
Выберите поле и справа нажмите значок
-
Выберите в списке переменную, которую нужно добавить в поле.
-
Если вы используете переменные Ответ на вопрос, Идентификатор варианта ответа на вопрос и подобные, при необходимости выберите фильтр для значения переменной.
-
Нажмите кнопку Сохранить.
При отправке данных в сервис переменная автоматически преобразуется в значение — ответ на вопрос, результат теста или технические данные.
Важно
Чтобы при интеграции с Tracker добавить в поля Автор, Исполнитель, Наблюдатели сотрудника, указанного в ответе на вопрос типа Люди
, добавьте в поле переменную Идентификатор варианта ответа на вопрос. Если вы используете переменную Ответ на вопрос, интеграция не сработает.
Пример: текст письма, содержащий все ответы пользователя на вопросы формы.
Фильтры
Если в настройки интеграции с помощью переменных подставлены ответы на вопросы, могут возникнуть ошибки из-за того, что ответ не соответствует формату, который требуется для интеграции. Например, если в тело HTTP-запроса добавить ответ на вопрос Длинный текст
, содержащий переводы строк, интеграция не сработает.
Чтобы избежать ошибок, связанных с форматом данных, используйте фильтры для переменных:
-
Sanitize string — удаляет из текста ответа специальные символы.
-
JSON — преобразует текст ответа в формат, совместимый с JSON.
-
base64 — преобразует текст ответа в кодировку ASCII.
Форматирование ответов
Если в настройках интеграции с помощью переменных вы используете ответы на вопросы, вы можете выбрать формат ответов, которые будут отправлены после заполнения формы.
-
Простой текст — отобразит данные в формате "вопрос - ответ".
-
Форматированный — поместит в блок кода вопросы и ответы.
-
JSON — отобразит ответ в формате
"ключ": "значение"
.
Справочник переменных
В настройках действий можно использовать следующие переменные:
Переменная | Описание |
---|---|
Данные пользователя | Личные данные пользователя, заполнившего форму. Переменные из этой группы преобразуются в персональные данные пользователя только в том случае, если форма создана в Yandex Forms для бизнеса и заполнивший форму пользователь является сотрудником организации. Данные внешних пользователей можно получить, только если пользователи укажут свои данные в ответ на вопросы формы. |
Имя | Имя пользователя. |
Логин | Логин пользователя. |
Электронная почта | Почта пользователя. |
Пол | Пол пользователя. |
Отдел | Отдел, к которому относится сотрудник (для пользователей Yandex Forms для бизнеса). |
Телефон | Рабочий телефон сотрудника (для пользователей Yandex Forms для бизнеса). |
Руководитель | Непосредственный руководитель сотрудника (для пользователей Yandex Forms для бизнеса). |
Команда | Команды, в которых состоит сотрудник (для пользователей Yandex Forms для бизнеса). |
Данные из организации | Информация из адресной книги организации в Yandex Cloud Organization |
Инфо о пользователе | Одно из полей карточки сотрудника, заполнившего форму. |
Инфо из ответа на вопрос | Для вопросов типа Люди, Отделы и Команды — одно из полей карточки сотрудника или подразделения, указанных в ответе. |
Результаты теста | Результат прохождения теста или квиза. |
Максимум баллов в тесте | Максимальное количество баллов, которое можно набрать в тесте. |
Всего вопросов с баллами | Количество вопросов, за которые можно получить баллы. |
Набрано баллов | Количество баллов, набранных пользователем. |
Заголовок результатов теста | Заголовок для сегмента, в который попал результат пользователя. |
Описание результатов теста | Описание для сегмента, в который попал результат пользователя. |
Набрано баллов на вопросе | Количество баллов, которое получено за выбранный вопрос. |
Форма | Параметры формы и ответы на ее вопросы. |
ID формы | Уникальный идентификатор формы. |
Название | Название формы. |
Ответ на вопрос | Ответ пользователя на определенный вопрос формы — выберите вопрос и настройте форматирование ответа. В данную переменную будет передаваться только ответ на тот вопрос, который вы выбрали. |
Ответы на вопросы | Ответы пользователя на несколько вопросов формы — выберите вопросы и настройте форматирование ответов. В данную переменную будут передаваться вопросы с ответами в формате "Вопрос : ответ". |
ID ответа | Уникальный идентификатор заполненной формы. |
Идентификатор варианта ответа на вопрос | Уникальный идентификатор варианта ответа для вопросов с выбором вариантов (например, Людиили Выпадающий список). |
Дата ответа | Дата заполнения формы. |
Email автора формы | Почта пользователя, который создал форму. |
Браузер | Информация о браузере и операционной системе пользователя. |
Семейство ОС | Тип операционной системы. |
Название ОС | Название операционной системы. |
Версия ОС | Версия операционной системы. |
Название браузера | Название. |
Версия браузера | Версия. |
Запрос | Технические параметры HTTP-сессии. |
Хост | Доменное имя сервера, с которого пришел запрос. |
URL | Адрес формы. |
Все GET-параметры | Значения всех параметров запроса. Читайте подробнее, как использовать GET-параметры для предзаполнения формы. |
GET-параметр | Значение определенного параметра запроса — укажите имя параметра. Читайте подробнее, как использовать GET-параметры для предзаполнения формы. |