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