Логика переходов опроса
update_quiz_logicСохраняет логические условия опроса: условные переходы между виджетами, переходы по умолчанию, логику по баллам (score). Новый формат: score-правила идут в savedLogic как обычные группы с condition.score=true; legacy savedScoring сохраняется только для backward compatibility. group.actionType ∈ {"jump","screenout","show","hide"} ("show"/"hide" — логика видимости: jumpTo указывает виджет, который показывается или скрывается, а не следующий шаг маршрута; дополнительные цели — в visibilityActions). defaultConditions разрежен: запись нужна только там, где переход отличается от следующего вопроса по порядку. Все идентификаторы виджетов (widget_id, widgetId, jumpTo и т.д.) — те же уникальные UUID, что в quiz://{id}/structure (поле ids или ids внутри child-элементов inline_group). Перед вызовом прочитайте quiz://{id}/structure и используйте id без изменений. Обновление частичное: переданная карта заменяет одноимённую целиком (пустой объект очищает её), не переданные карты остаются как были. Служебные ключи conditions ведёт бэкенд: isQuota выводится из наличия групп дисквалификации по квоте, defaultConditionsVersion=2 проставляется при передаче defaultConditions — присылать их не нужно и нельзя. Валидация: проверка существования виджетов, корректности операторов, отсутствия циклов и тупиков в маршруте. Блокируют сохранение также противоречивые действия внутри одной группы: показ и скрытие одного вопроса, переход на вопрос, который эта же группа скрывает, и изменение видимости уже пройденного вопроса. В поле warnings возвращаются переходы назад, вопросы без входящих путей, правила-дубли перехода по умолчанию, условия по ответу вопроса ниже по порядку, порядок carry-forward и риски случайной сортировки вопросов — сохранению они не мешают.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"quiz_id": "<quiz_id>"
},
"name": "update_quiz_logic"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| quiz_id | Yes | ID опроса для обновления логики. | |
| savedLogic | No | Условные переходы (включая score-логику в новом формате). Ключ — UUID виджета-источника (из structure ids). Значение — ВСЕГДА массив групп, даже если группа одна: [{ conditionGroupId, actionType, jumpTo (UUID или { widgetId, type }), conditionsData[] }]. Группа объектом вместо массива отклоняется валидацией. Порядок элементов массива сохраняется runtime-ом: группы выполняются сверху вниз. actionType: "jump" (переход; по умолчанию), "screenout" (дисквалификация; jumpTo может отсутствовать — рендерер покажет дефолтный screenout-экран) либо "show"/"hide" (условие показа). Условие показа: в группе с actionType "show"/"hide" jumpTo — это вопрос, который показывается или скрывается, а не следующий шаг маршрута. Чтобы одна группа управляла несколькими вопросами, перечислите их в visibilityActions: [{ "action": "show"|"hide", "targetWidget": { "widgetId": "<UUID>" } }]. Показ и скрытие одного вопроса в одной группе, как и переход на вопрос, который эта же группа скрывает, отклоняются валидацией. Дисквалификация по квоте: группа с actionType "screenout", пустым conditionsData и screenoutConfig = { "mode": "answer_quota", "sourceWidgetId": "<UUID вопроса>", "quotaType": "question_answers" | "answer_option", "quotaLimit": "<число строкой>", "quotaOptionId": "<UUID опции для answer_option>" }. Без screenoutConfig это обычная дисквалификация по ответу. Флаг conditions.isQuota бэкенд выставляет сам по наличию таких групп — передавать его не нужно. Переданная карта savedLogic заменяет прежнюю целиком; не переданные карты сохраняются. Чтобы поправить одно правило, сначала прочитайте conditions из структуры опроса, измените нужную запись и отправьте полную изменённую карту. Пустой объект очищает карту. conditionsData: conditionId, widget (widgetId — UUID), option (id оператора), answer, statement, score, scoreSourceType, scoreSourceWidgetId, scoreSourceCategoryId, extraField, extraFieldName, matrixData, allocationData, semanticDifferentialData, additional_option. Формы answer и операторы по типам вопросов — в описаниях этих полей. Все widgetId/jumpTo — только UUID из quiz://{id}/structure. Пример «если шкала меньше 10 — показать вопрос B»: { "<UUID шкалы>": [{ "conditionGroupId": "g1", "actionType": "show", "jumpTo": { "widgetId": "<UUID вопроса B>" }, "conditionsData": [{ "conditionId": "c1", "widget": { "widgetId": "<UUID шкалы>" }, "option": { "id": 7 }, "answer": { "label": "10", "optionId": "10" }, "statement": { "signature": "" } }] }] }. Условия по скрытым переменным опроса: пометьте condition как extraField=true и укажите extraFieldName — имя переменной из extra_fields (см. quiz://{id}/structure). Виджет у такого условия остаётся якорем группы, сравнивается значение переменной. Допустимые операторы: 1,2,3,4,5,6,7,8,9,10 (сравнение значения) и 27/28 (факт передачи, answer не нужен). statement.signature — связка условия со СЛЕДУЮЩИМ условием группы: "AND" | "OR" | "". Для «A И B» у A стоит "AND", у B — пустая строка; у последнего условия связка пустая. score-условия: если condition.score=true — runtime сравнивает не ответ пользователя, а totalScore. Допустимы только числовые операторы (option.id ∈ {1,2,7,8,9,10}); answer.label/answer.optionId содержат строковое представление порога (например "8"). Для нового контента отдавайте score-правила сюда, в savedLogic, а не в savedScoring. Источник значения для score-условия задаётся полем scoreSourceType с scoreSourceWidgetId или scoreSourceCategoryId (поля опциональны — при их отсутствии runtime трактует условие как "survey"): - scoreSourceType="survey", scoreSourceWidgetId=null — сумма по всему опросу (также трактуется runtime-ом при отсутствии обоих полей — backward compat); - scoreSourceType="widget", scoreSourceWidgetId=<UUID> — сумма по конкретному widget. UUID может указывать как на обычный scoring-виджет, так и на inline_group (runtime просуммирует scoring-enabled детей) или на ребёнка inline_group. Берите UUID из quiz://{id}/structure (вкл. groupWidgets.ids у inline_group). - scoreSourceType="category", scoreSourceCategoryId=<id шкалы>, scoreSourceWidgetId=null — значение шкалы (категории): сырой балл, а если у шкалы есть нормы — значение нормы. id шкалы — из quiz_categories настроек опроса. Удаляете шкалу — уберите и правила по ней, иначе следующая правка логики отклонится. allocation_slider условия: если condition.widget.widgetId указывает на виджет allocation_slider — в условие нужно добавить allocationData.optionId (UUID опции-слайдера из allocationSliderIds), значение которой runtime сравнит с answer.optionId (числовой порог в виде строки). Поле обязательно для операторов 1,2,7,8,9,10,11; для специального оператора hard_to_answer (23) allocationData не используется. Справочник операторов option.id: 1 — равно; 2 — не равно (форма значения зависит от вопроса). 3 — начинается с; 4 — заканчивается на; 5 — содержит; 6 — не содержит (строковое сравнение; для обычного выбора 5/6 не предлагаются и не срабатывают — используйте 1/2). 7 — меньше; 8 — меньше или равно; 9 — больше; 10 — больше или равно (числовое сравнение). 11 — любой ответ (answer не нужен). 12 — файл загружен; 13 — файл не загружен (legacy: конструктор для file пишет оператор 1 с answer.optionId "12" или "13"). 14 — дата раньше; 15 — дата позже; 16 — дата раньше или в этот день; 17 — дата позже или в этот день (datetime). 18 — ячейка отмечена; 19 — ячейка не отмечена (matrix, нужен matrixData.row/col). 20 — позиция в ранжировании равна; 21 — позиция выше (номер меньше); 22 — позиция ниже (номер больше) (ranking, нужен additional_option). 23 — затрудняюсь ответить (нужен hardToAnswer=true у вопроса; answer не нужен). 24 — ни один из вариантов (нужен noneOfAbove=true у dropdown или текстового choice; answer не нужен). 25 — увидел вариант A/B-теста; 26 — не увидел вариант A/B-теста (нужен abEnabled=true; answer.optionId — ID варианта из abVariantIds, а не вариант ответа). 27 — скрытая переменная передана; 28 — скрытая переменная не передана (только extraField=true + extraFieldName; answer не нужен). | |
| savedScoring | No | Legacy-формат переходов по баллам: UUID вопроса → ID score-условия → {score,jumpTo,inCase,inCaseMeaning}. Служебные ключи: scoringEnabledWidgets, correctAnswers, scoringSwitcher, instantFeedback (true — респондент сразу после вопроса видит, верно ли ответил, правильный ответ и пояснение). Для новых правил используйте savedLogic с condition.score:true. Это не описание назначения баллов вариантам ответа. Переданная карта заменяет прежнюю целиком. | |
| multiLogicFlags | No | Флаги мульти-логики: ключ — UUID виджета (из structure ids), значение boolean. true — несколько групп условий в savedLogic. | |
| defaultConditions | No | Переходы по умолчанию — РАЗРЕЖЕННАЯ карта: запись есть только там, где респондента надо увести не на следующий вопрос. Отсутствие записи и означает «След. шаг (по умолчанию)», поэтому НЕ заполняйте карту подряд и не пишите в неё следующий по порядку вопрос: такая запись ничего не меняет сейчас и ломает маршрут после вставки или перестановки вопросов. Ключ — UUID виджета-источника (из quiz structure ids), значение — { "widgetId": "<UUID цели>", "type": "<тип>" } или строка widgetId. Цель "submit" — финальный экран. Используйте только UUID из quiz://{id}/structure. | |
| savedInlineGroupLogic | No | Логика ВНУТРИ inline-группы. Ключ — UUID самой inline-группы (из structure ids), значение — массив групп условий. Форма группы здесь ДРУГАЯ, чем у savedLogic: маршрута внутри группы нет — все её вопросы показываются на одном экране, — поэтому нет ни actionType, ни jumpTo. Группа выглядит так: { conditionGroupId, actions: [{ "action": "show"|"hide", "targetWidget": { "widgetId": "<UUID ребёнка группы>" } }], conditionsData: [ … ] }. Условия — той же формы, что в savedLogic, но widgetId ссылаются на детей группы. ID детей берите из groupWidgets.ids в quiz://{id}/structure. Правило по баллам — ровно одно условие с score=true, его widget.widgetId — сама группа, источник баллов — survey, widget (группа, её вопрос или вопрос выше) или category. |