---
metadata:
  - name: generator
    content: Diplodoc Platform v5.54.2
alternate:
  - https://yandex.ru/support/forms/en/vars.md
  - https://yandex.ru/support/forms/ru/vars.md
  - href: ru/vars.md
    type: text/markdown
    title: Markdown version
  - href: llms.txt
    type: text/markdown
    title: llms.txt
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/support/forms/ru/llms.txt

# Переменные в настройках действий

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

Для этого используйте переменные:

1. В форме на вкладке **Интеграции** [добавьте действие](https://yandex.ru/support/forms/ru/notifications.md#add-integration).

1. Выберите поле и справа нажмите значок ![](_assets/svg/add.svg)</svg>.

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

1. Если вы используете переменные **Ответ на вопрос**, **Идентификатор варианта ответа на вопрос** и подобные,  при необходимости выберите [фильтр](#var-filters) для значения переменной.

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

При отправке данных в сервис переменная автоматически преобразуется в значение — ответ на вопрос, результат теста или технические данные.

 {% note warning "" %}

Чтобы при [интеграции с Трекером](https://yandex.ru/support/forms/ru/create-task.md) добавить в поля **Автор**, **Исполнитель**, **Наблюдатели** сотрудника, указанного в ответе на вопрос типа <q>Люди</q>, добавьте в поле переменную **Идентификатор варианта ответа на вопрос**. Если вы используете переменную **Ответ на вопрос**, интеграция не сработает.

{% endnote %}

> Пример: текст письма, содержащий все ответы пользователя на вопросы формы.
>
> ![](_assets/variables-example-new.png =500x)

## Фильтры {#var-filters}

Если в настройки интеграции с помощью переменных подставлены ответы на вопросы, могут возникнуть ошибки из-за того, что ответ не соответствует формату, который требуется для интеграции. Например, если в тело HTTP-запроса добавить ответ на вопрос <q>Длинный текст</q>, содержащий переводы строк, интеграция не сработает.

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

* **Sanitize string** — удаляет из текста ответа специальные символы.

* **JSON** — преобразует текст ответа в формат, совместимый с JSON.

* **base64** — преобразует текст ответа в кодировку ASCII.


![](_assets/var-filter-json.png =300x)

## Форматирование ответов {#formatting-responses}

Если в настройках интеграции вы используете переменную «Ответы на вопросы», вы можете выбрать формат списка ответов.

* **Простой текст** — отобразит данные в формате "вопрос - ответ".

* **Старое форматирование** — отобразит ответы в виде: `%% Ответ %%`.

* **Новое форматирование** — поместит ответы в блок кода.

* **JSON** — отобразит ответ в формате `"ключ": "значение"`.

 {% note info "" %}

Для передачи ответов в Трекер или Вики рекомендуем использовать опцию **Новое форматирование**. Подробнее о разметке YFM читайте в [Справке Вики](https://yandex.ru/support/wiki/wysiwyg/text-format.html).

{% endnote %}

## Справочник переменных {#var-ref}

В настройках действий можно использовать следующие переменные:

#|
|| **Переменная** | **Описание** ||
|| **Данные пользователя** | Личные данные пользователя, заполнившего форму.<br/><br/><br/>Переменные из этой группы преобразуются в персональные данные пользователя только в том случае, если форма создана в [Формах для бизнеса](https://yandex.ru/support/forms/ru/go-to-forms.md#business-features) и заполнивший форму пользователь является сотрудником организации. Данные внешних пользователей можно получить, только если пользователи укажут свои данные в ответ на вопросы формы. ||
|| Имя | Имя пользователя ||
|| Логин | Логин пользователя ||
|| Электронная почта | Почта пользователя ||
|| Пол | Пол пользователя || 
|| Отдел | Отдел, к которому относится сотрудник (для пользователей [Форм для бизнеса](https://yandex.ru/support/forms/ru/go-to-forms.md#business-features)) || 
||Телефон | Рабочий телефон сотрудника (для пользователей [Форм для бизнеса](https://yandex.ru/support/forms/ru/go-to-forms.md#business-features)) || 
||Руководитель | Непосредственный руководитель сотрудника (для пользователей [Форм для бизнеса](https://yandex.ru/support/forms/ru/go-to-forms.md#business-features)) || 
||Команда | Команды, в которых состоит сотрудник (для пользователей [Форм для бизнеса](https://yandex.ru/support/forms/ru/go-to-forms.md#business-features)) || 
||**Данные из организации** | Информация из адресной книги организации Яндекс 360 для бизнеса ||
|| Инфо из ответа на вопрос | Для вопросов типа **Люди**, **Отделы** и **Команды** — одно из полей карточки сотрудника или подразделения, указанных в ответе. ||
|| Инфо о пользователе | Одно из полей карточки сотрудника, заполнившего форму. ||
|| **Результаты теста** | Результат прохождения [теста или квиза](https://yandex.ru/support/forms/ru/tests.md) ||
|| Максимум баллов в тесте | Максимальное количество баллов, которое можно набрать в тесте ||
|| Всего вопросов с баллами | Количество вопросов, за которые можно получить баллы ||
|| Набрано баллов | Количество баллов, набранных пользователем ||
|| Заголовок результатов теста | [Заголовок для сегмента](https://yandex.ru/support/forms/ru/tests.md#test-result), в который попал результат пользователя ||
|| Описание результатов теста | [Описание для сегмента](https://yandex.ru/support/forms/ru/tests.md#test-result), в который попал результат пользователя ||
|| Набрано баллов на вопросе | Количество баллов, которое получено за выбранный вопрос ||
|| **Форма** | Параметры формы и ответы на ее вопросы ||
|| ID формы | Уникальный идентификатор формы ||
|| Название | Название формы ||
|| Ответ на вопрос | Ответы пользователей на определенный вопрос формы — выберите вопрос и настройте [фильтры](#var-filters). В данную переменную передаются только ответы на тот вопрос, который вы выбрали. ||
|| Ответы на вопросы | Ответы пользователей на несколько вопросов формы — выберите вопросы и настройте [фильтры](#var-filters) и [форматирование ответов](#formatting-responses). В данную переменную передаются выбранные вопросы с ответами в формате "Вопрос : ответ". ||
|| Ответы на вопросы в виде JSON | Ответы пользователей на несколько вопросов формы — выберите вопросы и настройте [фильтры](#var-filters). В данную переменную передаются выбранные вопросы с ответами и информация о форме (идентификатор, дата создания и др.) в формате JSON. Такой формат может быть удобен при работе с [HTTP-запросами](https://yandex.ru/support/forms/ru/send-request.md). [Описание формата JSON](https://ru.wikipedia.org/wiki/JSON)||
|| ID ответа | Уникальный идентификатор заполненной формы. ||
|| Идентификатор варианта ответа на вопрос | Уникальный идентификатор варианта ответа для вопросов с выбором вариантов (например, <q>Люди</q> или <q>Выпадающий список</q>) ||
|| Дата ответа | Дата заполнения формы ||
|| Время отправки ответа  | Дата и время отправки ответа (UTC) ||
|| Время начала заполнения | Дата и время начала заполнения формы (UTC) ||
|| Время заполнения в секундах | Продолжительность заполнения формы в секундах |||| Email автора формы | Почта пользователя, который создал форму ||
|| **Браузер** | Информация о браузере и операционной системе пользователя ||
|| Семейство ОС | Тип операционной системы ||
|| Название ОС | Название операционной системы ||
|| Версия ОС | Версия операционной системы ||
|| Название браузера | Название ||
|| Версия браузера | Версия ||
|| **Запрос** | Технические параметры HTTP-сессии ||
|| Хост | Доменное имя сервера, с которого пришел запрос ||
|| URL | Адрес формы ||
|| Все GET-параметры | Значения всех параметров запроса.<br/><br/>[Как использовать GET-параметры для предзаполнения формы](https://yandex.ru/support/forms/ru/get-params.md) ||
|| GET-параметр | Значение определенного параметра запроса — укажите имя параметра.<br/><br/>[Как использовать GET-параметры для предзаполнения формы](https://yandex.ru/support/forms/ru/get-params.md) ||
|#

<!-- source: ru/_assets/style.md -->

<!-- endsource: ru/_assets/style.md -->
