Что такое режим модальности в 1С и как с ним работать

Режим модальности в 1С — это свойство конфигурации и способ взаимодействия программы с пользователем, при котором открытое окно или вызов блокирует выполнение остального кода до тех пор, пока пользователь не закроет окно или не ответит на вопрос. Классический пример — метод Вопрос() или Предупреждение(), которые останавливают выполнение модуля и ждут реакции пользователя.

Такой подход долго был стандартом в платформе 1С:Предприятие, но с развитием веб-клиента и мобильной платформы он стал проблемой: браузеры и мобильные ОС не поддерживают блокирующие вызовы. Поэтому платформа получила свойство конфигурации «Режим использования модальности», а разработчикам пришлось переходить на асинхронные методы с описанием оповещений.

Понимание режима модальности нужно и разработчику, который дорабатывает конфигурацию, и администратору, столкнувшемуся с ошибкой «Использование модальных окон в данном режиме запрещено». Ниже разберём, какие бывают режимы, как проверить текущую настройку и как переписать код на асинхронные вызовы.

Что такое модальное окно и почему оно блокирует работу

Модальное окно — это окно, которое перехватывает управление и не позволяет работать с остальными окнами приложения, пока его не закроют. В толстом клиенте такое окно реально блокирует интерфейс, а выполнение кода приостанавливается в точке вызова. После ответа пользователя код продолжает работу с того же места, и результат возвращается как обычное значение функции.

Для логики программы это удобно: код пишется линейно, без цепочек обработчиков. Но в веб-клиенте, который работает внутри браузера, блокирующий вызов невозможен технически — JavaScript не позволяет «заморозить» выполнение до действия пользователя. То же ограничение действует на мобильной платформе.

Какие значения принимает режим использования модальности

Свойство конфигурации «Режим использования модальности» задаётся в конфигураторе в палитре свойств корневого узла конфигурации. Доступны три значения:

• Использовать — модальные и синхронные методы разрешены. Подходит только для решений, которые гарантированно работают в толстом или тонком клиенте.
• Не использовать — модальные вызовы запрещены, при попытке вызова возникает ошибка. Обязательный режим для веб-клиента и мобильной платформы.
• Использовать с предупреждениями — вызовы работают, но платформа выдаёт предупреждения, помогая постепенно находить проблемные места.

Дополнительно существует свойство «Режим использования синхронных вызовов расширений платформы и внешних компонент» — оно отдельно регулирует синхронные методы работы с файлами, криптографией и компонентами. Для полной совместимости с веб-клиентом оно тоже должно быть установлено в «Не использовать».

Как проверить и изменить режим в конфигураторе

Проверка занимает меньше минуты. Откройте конфигуратор, выделите корень дерева конфигурации и откройте палитру свойств (правый клик → «Свойства»). В списке найдите «Режим использования модальности» и «Режим использования синхронных вызовов расширений платформы и внешних компонент».

1. 1
   Откройте конфигурацию в конфигураторе и выделите корневой узел дерева объектов.
2. 2
   Откройте палитру свойств и найдите «Режим использования модальности».
3. 3
   Установите «Не использовать», если планируется работа в веб-клиенте или мобильной платформе.
4. 4
   Проверьте свойство режима синхронных вызовов расширений и при необходимости тоже установите «Не использовать».
5. 5
   Обновите конфигурацию базы данных (F7) и запустите проверку модальных вызовов через «Конфигурация → Проверка конфигурации».

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

Учтите: если конфигурация большая и код писался годами, модальных вызовов могут быть сотни. Менять режим «в лоб» на рабочей базе без предварительной доработки нельзя — пользователи начнут получать ошибки в самых неожиданных местах.

Как переписать модальный код на асинхронный

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

// Было (модально):
// Ответ = Вопрос("Провести документ?", РежимДиалогаВопрос.ДаНет);
// Если Ответ = КодВозвратаДиалога.Да Тогда ...

// Стало (асинхронно):
Оповещение = Новый ОписаниеОповещения("ПослеОтветаНаВопрос", ЭтотОбъект);
ПоказатьВопрос(Оповещение, "Провести документ?", РежимДиалогаВопрос.ДаНет);

// Отдельная процедура-обработчик:
&НаКлиенте
Процедура ПослеОтветаНаВопрос(Результат, ДопПараметры) Экспорт
    Если Результат = КодВозвратаДиалога.Да Тогда
        ПровестиДокумент();
    КонецЕсли;
КонецПроцедуры

Основные пары замены: Вопрос → ПоказатьВопрос, Предупреждение → ПоказатьПредупреждение, ОткрытьФормуМодально → ОткрытьФорму с описанием оповещения о закрытии, ПоместитьФайл → НачатьПомещениеФайла. В новых версиях платформы асинхронные методы имеют префикс «Начать»: НачатьПоказВопроса и аналогичные.

Главная сложность — не синтаксис, а изменение структуры кода. Линейная логика «спросил → проверил → выполнил» разбивается на цепочку процедур. Если после ответа нужно задать следующий вопрос, цепочка оповещений удлиняется. Дополнительные данные между вызовами передаются через параметр «ДополнительныеПараметры» описания оповещения.

Модальные формы и блокирование интерфейса

Модальность касается не только диалогов, но и обычных форм. Параметр РежимОткрытияОкна.БлокироватьОкноВладельца или БлокироватьВесьИнтерфейс при открытии формы делает её модальной визуально, но в асинхронной модели код продолжает выполняться — результат закрытия приходит через оповещение.

Практическая рекомендация: блокируйте окно владельца, а не весь интерфейс, если нет жёсткой необходимости. Блокировка всего интерфейса мешает пользователю параллельно посмотреть данные в других окнах и ухудшает работу в веб-клиенте, где каждое окно — нагрузка на соединение.

Как проверить, что конфигурация работает без модальности

После доработки нужно убедиться, что модальных вызовов не осталось. Первый уровень контроля — проверка конфигурации в конфигураторе с включённой проверкой модальных и синхронных вызовов. Второй уровень — запуск в веб-клиенте: именно там запрещённые вызовы проявляются быстрее всего.

Отдельно проверьте расширения конфигурации и внешние обработки, которые используются в базе. Проверка конфигурации не анализирует внешние обработки — их нужно открывать и проверять по одной либо тестировать в рабочих сценариях.

Частые вопросы о режиме модальности