Расширенные настройки

Выражения PEXL, параметры ссылок, автозаполнение ответов и Redirects / HOOKs.

PEXL

Синтаксис PEXL

PEXL (Poll Expression Language) — язык выражений для доступа к данным интервью, сравнения значений, логических условий, работы с переменными, параметрами, тегами ответов, подсчётами и псевдослучайными значениями.

Документ описывает синтаксис, реально поддерживаемый грамматикой pexl.g, парсером pexl.js и тестами проекта.


1. Общая модель выражений

Выражение PEXL вычисляется в контексте объекта interview и возвращает одно значение:

Примеры:

Q1
Q1 == "Q one"
Q1.A3 == "A three"
Q5.A >= 22
PARAM("PARAM1") == "PAR1"
$X = RAND(1, 10)

2. Лексические элементы

2.1. Пробелы

Пробельные символы допускаются между токенами и игнорируются.

Примеры:

Q1.A3=="A three"
Q1.A3 == "A three"
Q1 . A3

Практически использовать стоит обычную читаемую запись без разрыва внутри ссылок вида Q1.A3.

2.2. Числа

Поддерживаются только целые числа:

0
1
22
100500

Формально: последовательность цифр \d+.

Отрицательные, дробные и экспоненциальные числа синтаксисом не предусмотрены.

2.3. Строки

Поддерживаются строковые литералы в двойных кавычках:

"Hello"
"A three"
"06bf20de-9658-4afd-9e7b-d712697ccdc7"

Также лексер распознаёт литералы в одинарных кавычках, но в грамматике языка они не используются как допустимые значения выражений. Поэтому в корректном PEXL следует использовать двойные кавычки.

2.4. Ключевые слова и служебные токены

Поддерживаются следующие ключевые слова и служебные конструкции:

2.5. Операторы и знаки пунктуации


3. Базовая грамматика выражений

На верхнем уровне PEXL поддерживает два больших класса выражений:

  1. вычисление/сравнение значения;
  2. присваивание переменной.

Упрощённо:

STMT ::= STMT == STMT
       | STMT != IVALUE
       | STMT <  IVALUE
       | STMT >  IVALUE
       | STMT <= IVALUE
       | STMT >= IVALUE
       | STMT AND STMT
       | STMT OR STMT
       | NOT STMT
       | ( STMT )
       | IVALUE
       | ASSIGN_VALUE

Где IVALUE — это обычное вычисляемое значение, а ASSIGN_VALUE — присваивание переменной.


4. Приоритет операторов

Согласно грамматике проекта, используются такие приоритеты:

  1. NOT — самый высокий;
  2. сравнения: ==, !=, <, <=, >, >=;
  3. OR;
  4. AND;
  5. = (присваивание).

Важно: приоритеты в pexl.g заданы не совсем так, как в большинстве языков программирования. Для сложных выражений рекомендуется всегда явно ставить скобки.

Примеры безопасной записи:

Q1.A3 AND (NOT Q2.A1)
(Q1.A3 == "A three") AND (Q2.A1 == "A one")
($X = RAND(1, 10)) AND ($X >= 1)

5. Допустимые виды значений (IVALUE)

IVALUE может быть одним из следующих типов:

Подробно — ниже.


6. Ссылки на вопросы

6.1. Вопрос Qx

Форма:

Q<number>

Примеры:

Q1
Q2
Q10

Семантика:

Примеры:

Q1
Q1 == "Q one"
NOT Q123

6.2. Строка табличного вопроса Qx.Ry

Форма:

Q<number>.R<number>

Примеры:

Q3.R1
Q3.R2

Семантика:

Примеры:

Q3.R1 == "Q three R one"
Q3.R2

7. Ссылки на ответы

7.1. Конкретный ответ Qx.Ay

Форма:

Q<number>.A<number>

Пример:

Q1.A3

Семантика:

Примеры:

Q1.A3 == "A three"
Q7.A3 == 22

7.2. Конкретный ответ в строке таблицы Qx.Ry.Az

Форма:

Q<number>.R<number>.A<number>

Пример:

Q3.R1.A3

Примеры использования:

Q3.R1.A3 == "A three"
Q3.R2.A1

8. Текст ответа

8.1. Первый/основной текст ответа вопроса Qx.A

Форма:

Q<number>.A

Пример:

Q5.A

Семантика:

Примеры:

Q1.A == "A three"
Q5.A == 22
Q5.A >= 22

8.2. Текст ответа строки таблицы Qx.Ry.A

Форма:

Q<number>.R<number>.A

Пример:

Q3.R2.A

Примеры:

Q3.R2.A == "33"
Q3.R1.A == "A three"

9. Теги ответов

Тег кодируется как специальный токен вида:

T.<TAG_NAME>

Допустимые символы имени тега: буквы, цифры, _, -.

Примеры:

T.A_TAG_INT
T.A_TAG_STR
T.score-1

9.1. Тег конкретного ответа Qx.Ay.T.TAG

Форма:

Q<number>.A<number>.T.<TAG>
Q<number>.R<number>.A<number>.T.<TAG>

Примеры:

Q1.A3.T.A_TAG_INT
Q3.R1.A3.T.A_TAG_STR

Семантика:

Примеры:

Q1.A3.T.A_TAG_INT == 55
Q1.A3.T.A_TAG_STR == "Tag value"

9.2. Тег первого/основного ответа вопроса Qx.A.T.TAG

Форма:

Q<number>.A.T.<TAG>
Q<number>.R<number>.A.T.<TAG>

Примеры:

Q1.A.T.A_TAG_INT
Q3.R1.A.T.A_TAG_STR

Семантика:

Примеры:

Q1.A.T.A_TAG_INT == 55
Q1.A.T.A_TAG_STR == "Tag value"

10. Подсчёт количества ответов

10.1. Количество ответов вопроса Qx.COUNT

Форма:

Q<number>.COUNT

Пример:

Q2.COUNT

Семантика:

Примеры:

Q2.COUNT == 4
Q6.COUNT == 6

10.2. Количество ответов строки таблицы Qx.Ry.COUNT

Форма:

Q<number>.R<number>.COUNT

Пример:

Q3.R1.COUNT

10.3. Количество заполненных строк таблицы Qx.R.COUNT

Форма:

Q<number>.R.COUNT

Пример:

Q3.R.COUNT == 3

Семантика:


11. Доступ по UUID

11.1. Вопрос по UUID: QUUID("...")

Форма:

QUUID("<question_uuid>")

Семантика:

Примеры:

QUUID("06bf20de-9658-4afd-9e7b-d712697ccdc7")
QUUID("06bf20de-9658-4afd-9e7b-d712697ccdc7") == "Q one"

11.2. Конкретный ответ по UUID: ATUUID("...")

Форма:

ATUUID("<answer_template_uuid>")

Семантика:

Примеры:

ATUUID("a2101b08-b18e-4137-abb0-5eb2e44d751e")
ATUUID("a2101b08-b18e-4137-abb0-5eb2e44d751e") == "A three"

11.3. Текст ответа по UUID: AQUUID("...")

Форма:

AQUUID("<question_uuid>")

Семантика:

Примеры:

AQUUID("06bf20de-9658-4afd-9e7b-d712697ccdc7") == "A three"
AQUUID("c82d8380-cae4-43c1-93be-3cf5a06449f3") >= 22

11.4. Тег конкретного ответа по UUID: TATUUID("answerUuid", "TAG")

Форма:

TATUUID("<answer_template_uuid>", "<TAG>")

Примеры:

TATUUID("a2101b08-b18e-4137-abb0-5eb2e44d751e", "A_TAG_INT") == 55
TATUUID("a2101b08-b18e-4137-abb0-5eb2e44d751e", "A_TAG_STR") == "Tag value"

11.5. Тег первого/основного ответа вопроса по UUID: TAQUUID("questionUuid", "TAG")

Форма:

TAQUUID("<question_uuid>", "<TAG>")

Примеры:

TAQUUID("06bf20de-9658-4afd-9e7b-d712697ccdc7", "A_TAG_INT") == 55
TAQUUID("06bf20de-9658-4afd-9e7b-d712697ccdc7", "A_TAG_STR") == "Tag value"

11.6. Количество ответов вопроса по UUID: CQUUID("...")

Форма:

CQUUID("<question_uuid>")

Примеры:

CQUUID("06bfcccc-9658-4afd-9e7b-d712697ccdc7") == 6

11.7. Количество строк таблицы по UUID: CRUUID("...")

Форма:

CRUUID("<table_uuid>")

Примеры:

CRUUID("7a33bdab-d53b-4958-a293-60e3fded8aa8") == 3

12. Параметры интервью

Форма:

PARAM("<name>")

Примеры:

PARAM("PARAM1")
PARAM("PARAM1") == "PAR1"
PARAM("PARAM1") == PARAM("param2")

Семантика:


13. Переменные

PEXL поддерживает две формы обращения к переменным.

13.1. Переменная вида $NAME

Форма:

$<name>

Допустимые символы имени: буквы, цифры, _, -.

Примеры:

$VAR1
$var2
$MY-VAR

Чтение:

$VAR1 == "VAL1"

Присваивание:

$VAR3 = "Test3"
$N = 22
$X = Q1
$Y = Q3.R1.A3
$R = RAND(1, 10)

13.2. Переменная вида VAR("NAME")

Форма:

VAR("<name>")

Примеры:

VAR("VAR1")
VAR("var2") == "val2"
VAR("VAR4") = "Test4"
VAR("VAR_QQ") = Q1

Семантика у $NAME и VAR("NAME") общая:

13.3. Что можно присваивать переменной

Правая часть присваивания может быть:

Примеры:

$VAR3 = "Test3"
$VAR_Q = Q1
$VAR_Q = Q3.R1.A3
$MY = $VAR3
VAR("VAR4") = "Test4"
VAR("VAR_QQ") = Q1

14. Псевдослучайные значения

14.1. Короткая форма RAND(n)

Форма:

RAND(<max>)

Семантика:

Пример:

RAND(5)

14.2. Полная форма RAND(min, max)

Форма:

RAND(<min>, <max>)

Семантика:

Примеры:

RAND(3, 7)
RAND(42, 42)
$X = RAND(1, 100)
RAND(10, 20) >= 10 AND RAND(10, 20) <= 20

Особенность реализации:

Совместимость с конвертерами:


15. Операторы сравнения

Поддерживаются:

Примеры:

Q1 == "Q one"
Q1.A3 == "A three"
Q5.A != 20
Q5.A < 123
Q5.A <= 22
Q5.A > 21
Q5.A >= 22

15.1. Правила сравнения

Реализация сравнения устроена так:

  1. Левая часть должна быть truthy, иначе результат выражения будет ложным.
  2. Если и левое, и правое значения распознаются как целые числа, сравнение выполняется как числовое.
  3. Иначе сравнение выполняется как обычное JS-сравнение значений/строк.

Примеры числового сравнения:

Q7.A3 == 22
Q7.A3 < Q7.A4
Q5.A >= 22

Примеры строкового сравнения:

Q7.A1 == "AAAA"
Q7.A1 < Q7.A2

15.2. Сравнение значения слева и справа

С обеих сторон могут стоять не только литералы, но и выражения:

Q7.A1 == Q7.A1
"BBBB" == Q7.A2
22 == Q7.A3
PARAM("PARAM1") == PARAM("param2")

16. Логические операторы

16.1. AND

Форма:

<expr> AND <expr>

Примеры:

Q1.A3 == "A three" AND Q2.A1 == "A one"
Q1 == "Q one" AND Q3.R1 == "Q three R one"

Семантика: логическое И.

16.2. OR

Форма:

<expr> OR <expr>

Пример:

Q1 == "Q one" OR Q1 == "Wrong Q"

16.3. NOT

Форма:

NOT <expr>

Примеры:

NOT Q1
NOT Q123
NOT Q1.A3 == "A three"
Q1.A3 AND NOT Q2222.A1 AND Q5555.A2

16.4. Скобки

Форма:

( <expr> )

Примеры:

Q1 AND (Q1 == "Q one" OR Q1 == "Wrong Q")
Q1.A3 AND (Q2.A1 == "A one" OR Q1111.A111 == "Wrong Q")
Q1.A3 AND (NOT Q2222.A1) AND Q5555.A2

17. Поведение при отсутствии данных

Если вопрос, ответ, тег или переменная не найдены, обычно возвращается null.

Типичные последствия:

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


18. Контекст циклов

Синтаксис выражения не меняется, но семантика поиска вопроса/ответа может зависеть от options, переданных в execute(...).

Поддерживаются режимы:

18.1. DOWHILE

Требует:

{ loopType: "DOWHILE", loopPass: <number> }

В этом режиме конструкции вроде:

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

Примеры выражений:

Q2 == "Q two 2"
Q2.A1 == "A one. LoopPass2"
Q2.A == "A one. LoopPass2"
QUUID("10264445-3949-41b3-8b87-4cc20bf6c5c0") == "Q two 2"
ATUUID("4a8e4bd6-7500-4195-a731-158780787d21") == "A two. LoopPass2"

18.2. FOREACH

Требует:

{ loopType: "FOREACH", iterationTemplateAnswerId: "<uuid>" }

В этом режиме поиск значения выполняется в контексте конкретной итерации iterationTemplateAnswerId.

Примеры:

Q6 == "Q Loop"
Q6.A1 == "A six one"
Q6.A == "A six one 2"
AQUUID("06bfcccc-9658-4afd-9e7b-d712697ccdc7") == "A six one 2"
Q6.COUNT == 3

18.3. Ошибки конфигурации цикла

Реализация execute() выбрасывает ошибку, если:


19. Полный каталог синтаксических форм

Ниже перечислены все поддерживаемые формы пользовательских выражений.

19.1. Литералы

123
"text"

19.2. Вопросы и ответы

Q1
Q3.R1
Q1.A3
Q3.R1.A3
Q1.A
Q3.R2.A

19.3. Теги

Q1.A3.T.A_TAG_INT
Q3.R1.A3.T.A_TAG_STR
Q1.A.T.A_TAG_INT
Q3.R1.A.T.A_TAG_STR

19.4. Подсчёты

Q2.COUNT
Q3.R1.COUNT
Q3.R.COUNT

19.5. UUID-функции

QUUID("question-uuid")
ATUUID("answer-uuid")
AQUUID("question-uuid")
TATUUID("answer-uuid", "TAG")
TAQUUID("question-uuid", "TAG")
CQUUID("question-uuid")
CRUUID("table-uuid")

19.6. Параметры и переменные

PARAM("PARAM1")
$VAR1
VAR("VAR1")

19.7. Присваивания

$X = "abc"
$X = 10
$X = Q1
$X = Q1.A3
$X = Q1.A
$X = Q1.A3.T.A_TAG_INT
$X = Q2.COUNT
$X = AQUUID("question-uuid")
$X = TAQUUID("question-uuid", "TAG")
$X = RAND(1, 10)

VAR("X") = "abc"
VAR("X") = Q1
VAR("X") = Q1.A3

19.8. RAND

RAND(5)
RAND(1, 10)

19.9. Логика и сравнения

Q1 == "Q one"
Q1.A3 != "Wrong"
Q5.A < 100
Q5.A <= 22
Q5.A > 10
Q5.A >= 22
NOT Q123
Q1 AND Q2
Q1 OR Q2
(Q1 AND Q2) OR Q3

20. Практические рекомендации

  1. Используйте двойные кавычки для строк.

  2. Для сложной логики всегда ставьте скобки.

  3. Если значение может отсутствовать, учитывайте возможность null.

  4. Для числовых сравнений используйте числовые литералы:

Q5.A >= 22
  1. Для читаемости разделяйте длинные выражения пробелами:
Q1.A3 == "A three" AND Q2.A1 == "A one"

21. Примеры полных выражений

Простые проверки

Q1
Q1.A3
NOT Q123

Сравнение вопросов и ответов

Q1 == "Q one"
Q1.A3 == "A three"
Q3.R1 == "Q three R one"
Q3.R1.A3 == "A three"

Работа с числовыми ответами

Q5.A == 22
Q5.A != 20
Q5.A < 123
Q5.A >= 22

Теги

Q1.A3.T.A_TAG_INT == 55
Q1.A.T.A_TAG_STR == "Tag value"
TATUUID("a2101b08-b18e-4137-abb0-5eb2e44d751e", "A_TAG_INT") == 55
TAQUUID("06bf20de-9658-4afd-9e7b-d712697ccdc7", "A_TAG_STR") == "Tag value"

Параметры и переменные

PARAM("PARAM1") == "PAR1"
$VAR1 == "VAL1"
VAR("VAR1") == "VAL1"
$TMP = Q1.A
VAR("N") = RAND(1, 100)

Сложная логика

Q1.A3 AND (Q2.A1 == "A one" OR Q1111.A111 == "Wrong Q")
Q1 AND (Q1 == "Q one" OR Q1 == "Wrong Q")
Q1.A3 AND NOT Q2222.A1 AND Q5555.A2

22. Краткая формальная сводка

Вопрос:
  Qn
  Qn.Rm

Ответ:
  Qn.Am
  Qn.Rm.Ak

Текст ответа:
  Qn.A
  Qn.Rm.A

Теги:
  Qn.Am.T.TAG
  Qn.Rm.Ak.T.TAG
  Qn.A.T.TAG
  Qn.Rm.A.T.TAG

Подсчёты:
  Qn.COUNT
  Qn.Rm.COUNT
  Qn.R.COUNT

UUID:
  QUUID("uuid")
  ATUUID("uuid")
  AQUUID("uuid")
  TATUUID("uuid", "TAG")
  TAQUUID("uuid", "TAG")
  CQUUID("uuid")
  CRUUID("uuid")

Параметры:
  PARAM("name")

Переменные:
  $NAME
  VAR("NAME")

Присваивание:
  $NAME = <value>
  VAR("NAME") = <value>

RAND:
  RAND(n)
  RAND(min, max)

Логика:
  expr AND expr
  expr OR expr
  NOT expr
  (expr)

Сравнения:
  expr == expr
  expr != expr
  expr < expr
  expr > expr
  expr <= expr
  expr >= expr

23. Источник истины

Этот документ составлен по фактической реализации проекта:

Грамматики pexl.g, convert2UUID.g, convert2QA.g должны держаться в синхроне по набору поддерживаемых токенов и продакшнов: если в одной из них появляется новый оператор (например, RAND), его обязательно нужно добавить и в две другие, иначе сохранение/отображение выражений ломается.

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

Автозаполнение ответов из URL

Автозаполнение ответов интервью из URL-параметров (userCode)

Статус: реализовано· Модуль: web-интервью (CAWI) · Дата: 2026-07-16 Аудитория: методисты/администраторы опросов, интеграторы (формируют ссылки), разработчики.

Коротко

При открытии web-интервью по ссылке с параметром вида ?sex=1 приложение само выбирает нужный вариант ответа: находит вопрос, у которого код userCode == "sex", и отмечает в нём вариант, у которого userCode == "1".

Это избавляет респондента от повторного ответа на вопросы, ответы на которые уже известны заранее (пол, возраст, регион и т. п. — например, переданы панелью или из CRM).

https://<адрес-приложения>/?poll_id=<uuid>&user_name=<имя>&sex=1
                                                          ▲
                                       код вопроса = sex, код варианта = 1 → выбран автоматически

1. Контракт

Правило ровно одно и симметричное:

Часть URL Чему соответствует
Имя параметра (sex) userCode вопроса
Значение параметра (1) userCode варианта ответа

Сопоставление идёт только по userCode. Ни answerCode, ни порядковый номер, ни текст варианта в матчинге не участвуют.


2. Настройка опроса (методист / администратор)

Чтобы вопрос участвовал в автозаполнении, userCode нужно включить и заполнить в двух местах:

  1. На самом вопросе — задать код (например sex) и включить флаг userCode.enabled.
  2. На каждом варианте ответа, который должен быть выбираемым по ссылке, — задать код (например 1 для «МУЖ», 2 для «ЖЕН») и включить userCode.enabled.

Пример (эталонный тестовый опрос «AUTOTEST-12»):

Объект Текст userCode
Вопрос «Пол» sex
Вариант МУЖ 1
Вариант ЖЕН 2

Ссылка ...&sex=1 выберет «МУЖ», ...&sex=2 — «ЖЕН».

Важно: вариант без включённого userCode по ссылке выбрать нельзя — он просто не будет найден. Отката на другие коды нет by design.


3. Формирование ссылки (интегратор)

Базовый формат web-ссылки на интервью:

https://<адрес-приложения>/?poll_id=<uuid-опроса>&user_name=<имя-респондента>&<код1>=<значение>&<код2>=<значение>

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

Несколько вопросов сразу

Каждый вопрос — отдельный параметр:

...&sex=1&age=3&region=77

Мультивыбор (вопросы с несколькими ответами)

Несколько вариантов одного вопроса — через запятую в одном параметре:

...&hobby=1,3,5

Использовать повторяющийся ключ (hobby=1&hobby=3) нельзя — при разборе URL остаётся только последнее значение, предыдущие теряются.

⚠️ Кодирование символов — критично

Значения параметров автозаполнения берутся из URL как есть, без URL-декодирования. Отсюда два правила:


4. Правила сопоставления (важные нюансы поведения)

Ситуация Поведение
Значение совпало с userCode варианта Вариант выбирается автоматически
Строгое сравнение строк 01 ≠ 1, 1.0 ≠ 1. Код должен совпасть точно (пробелы по краям обрезаются)
Мультивыбор q=1,3 Выбираются оба варианта, в порядке значений из URL
В вопросе настроен autoSelect (условный автовыбор) autoSelect главнее — автозаполнение по ссылке для такого вопроса не применяется
На вопрос уже дан ответ (респондент ответил / есть черновик) Автозаполнение не перезаписывает ответ
Чекбокс с лимитом (максимум N ответов) Если по ссылке пришло больше вариантов, чем разрешено, берутся первые N (в порядке URL), остальные отбрасываются
Чекбокс с «эксклюзивным» вариантом (напр. «Затрудняюсь ответить») Если среди пришедших есть эксклюзивный вариант — выбирается только он
Вариант скрыт условием видимости Не выбирается (скрытые варианты в автозаполнении не участвуют)
Параметр есть, но подходящего варианта нет (sex=99) Ничего не выбирается, приложение продолжает работу, в лог пишется предупреждение
Параметра для вопроса нет в ссылке Вопрос остаётся пустым, респондент отвечает сам

Ключевой принцип: автозаполнение либо помогает, либо молча уступает. Оно никогда не ломает интервью, не перетирает уже данный ответ и не спорит с настроенным в опросе автовыбором.


5. Что НЕ поддерживается

Осознанно вне текущего объёма (планируется отдельно):

Для этих типов вопросов параметры в URL игнорируются без ошибок.


6. Диагностика

Фича не имеет видимой респонденту индикации — вся диагностика идёт в технический лог интервью (saveLog). Что искать при разборе:

Запись в логе Что значит
нет варианта под значение параметра <код> Параметр в ссылке есть, но вариант с таким userCode не найден (опечатка в коде варианта, вариант скрыт или userCode выключен)
неоднозначное совпадение Несколько вариантов имеют одинаковый userCode (ошибка настройки опроса)
userCode prefill пропущен (D6): ... есть autoSelect Автозаполнение не сработало, потому что в вопросе включён autoSelect (это ожидаемо)
вариант(ов) сверх maxAnswers ... отброшено Для чекбокса по ссылке пришло больше вариантов, чем разрешает лимит

Первый шаг при жалобе «ссылка не подставляет ответ»: сверить код в URL с userCode варианта в настройках опроса (регистр, ведущие нули, пробелы) и убедиться, что userCode.enabled включён и на вопросе, и на варианте.


7. Для разработчиков

Точка входа данных: параметры URL разбираются в src/main.vue (forWebApp()), складываются в профиль (SET_WEB_INFO) и доступны как getMap. Значения не декодируются, повторный ключ перетирается — см. раздел 3.

Ядро фичи:

Тесты:

npm run test:usercode-prefill   # юнит-тесты резолвера (node), + фикстура реального опроса
npm run test:lifecycle          # lifecycle-тесты интеграции в mixin'ы (jsdom)

Оба набора включены в npm run build и npm run build-web.

Проектная документация: дизайн-спека и решения D1–D7 — docs/superpowers/specs/2026-06-10-url-param-autofill-by-usercode-design.md.


8. Проверенные сценарии (QA)

Живой прогон на опросе AUTOTEST-12 (53fb0813), вопрос «Пол»:

Сценарий Результат
?sex=1 → выбран «МУЖ» ✅ Подтверждено (store + DOM)
?sex=2 → выбран «ЖЕН» ✅ Подтверждено
?sex=99 (несуществующий код) ✅ Ничего не выбрано, интервью работает, предупреждение в логе
Приоритет черновика (D1) Покрыто lifecycle-тестами; в web-флоу каждая загрузка стартует новое интервью, поэтому вживую неприменимо
Чекбокс / autoSelect (D6/D7) Покрыто lifecycle-тестами; в эталонном опросе таких вопросов нет — для live-проверки нужен опрос с чекбокс-вопросом и вопросом с autoSelect

Redirects / HOOKs

WEB интервью: Redirect/HK и входные параметры

Для чего это нужно

В WEB интервью ссылка для перехода (Redirect) и ссылка для хука (HK/hooks) могут автоматически получать значения из входной ссылки интервью.

Это позволяет:


Как это работает

1) Входные параметры берутся из URL запуска интервью

Пример входной ссылки:

https://app.example.com/?poll_id=1001&visit_id=abc123&project_id=prj55&source=telegram

Из неё система запоминает параметры (poll_id, visit_id, project_id, source и т.д.).

2) В Redirect/HK используются плейсхолдеры

В настройках URL можно писать параметры в виде:

$имя_параметра$

При выполнении Redirect/HK эти плейсхолдеры заменяются фактическими значениями.

Пример шаблона:

https://target.example.com/result/$project_id$?visit=$visit_id$&src=$source$

Результат:

https://target.example.com/result/prj55?visit=abc123&src=telegram

Важные правила

  1. Подстановка работает для всех параметров, которые пришли во входной ссылке.
  2. Подстановка работает и для:
    • обычных Redirect/HK;
    • сценария дубля (DOUBLE).
  3. Если параметр отсутствует, вместо него подставляется пустое значение.
  4. Спецсимволы в значениях кодируются автоматически (безопасно для URL).

Рекомендации по настройке


Подробности — в служебных данных

Во вкладке «Служебные данные» параметры запуска доступны полностью, с переносами длинных строк. Это помогает сверить переданные значения без перехода к исходной ссылке.

Здесь же показываются настроенные адреса перенаправления и серверного уведомления — «redirectUrl» и «hookUrl». Они выбираются по статусу интервью из текущих настроек опроса и появляются, если соответствующая настройка включена и адрес задан. Адреса отражают текущие настройки опроса для этого статуса.