Асинхронная функция в 1С: что это и как её использовать

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

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

Путаница возникает из-за того, что под «асинхронностью» в 1С понимают разные вещи: новые конструкции Асинх/Ждать, старый механизм описаний оповещений (НачатьВыполнениеОбработкиОповещения) и фоновые задания через ФоновыеЗадания.Выполнить. Ниже разберём каждый вариант, когда его применять и каких ошибок избегать.

Что такое асинхронность в контексте платформы 1С

В классическом синхронном коде каждая строка выполняется после завершения предыдущей. Если строка — это обращение к внешнему сервису на 10 секунд, весь сеанс ждёт эти 10 секунд. Асинхронная модель меняет порядок: вызов запускается, управление возвращается коду, а результат обрабатывается позже — когда операция завершится.

В 1С асинхронность исторически развивалась в три этапа. Сначала использовались модальные методы (Вопрос, Предупреждение), которые блокировали интерфейс. Затем появились описания оповещений — механизм «вызови метод и укажи, какую процедуру выполнить по завершении». В современных версиях платформы добавлены ключевые слова Асинх и Ждать, которые делают код линейным и читаемым, сохраняя неблокирующее поведение.

Ключевые слова Асинх и Ждать: как это работает

Ключевое слово Асинх ставится перед объявлением функции или процедуры в клиентском модуле. Такая функция может содержать оператор Ждать, который приостанавливает выполнение именно этой функции до получения результата асинхронного метода, не блокируя при этом интерфейс и остальной код. Вызов выглядит так: Результат = Ждать АсинхронныйМетод();.

Методы платформы, поддерживающие асинхронный вызов, имеют пары: например, НачатьПомещениеФайла, НачатьВопрос, НачатьКопированиеФайла. С Ждать используются их варианты, возвращающие обещание: ПоместитьФайлАсинх, ЗадатьВопросАсинх и другие — точный список зависит от версии платформы и указывается в синтакс-помощнике.

Важное ограничение: Асинх/Ждать работают только в клиентских модулях (модули форм, команд, общие клиентские модули). На сервере эти конструкции недоступны — там асинхронность достигается фоновыми заданиями.

&НаКлиенте
Асинх Процедура ЗагрузитьФайл(Команда)
	Результат = Ждать ПоместитьФайлАсинх(,,, Истина, УникальныйИдентификатор);
	Если Результат <> Неопределено Тогда
		Сообщить("Файл помещён во временное хранилище");
	КонецЕсли;
КонецПроцедуры

Фоновые задания: асинхронность на сервере

Фоновое задание — это отдельный сеанс на сервере, который выполняет указанную процедуру независимо от сеанса пользователя. Запускается вызовом ФоновыеЗадания.Выполнить("ИмяМодуля.ИмяПроцедуры", Параметры, Ключ, Наименование). Пользователь сразу получает управление, а серверная процедура работает параллельно.

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

Параметр Ключ у фонового задания предотвращает запуск дубликатов: два задания с одинаковым ключом и методом не выполняются одновременно. Это удобно для защиты от повторного нажатия кнопки «Сформировать отчёт».

Описания оповещений: когда встречаются в старом коде

До появления Асинх/Ждать асинхронность оформлялась через объект ОписаниеОповещения: вы создавали описание с именем процедуры-обработчика и передавали его в метод вида ПоказатьВопрос или НачатьПомещениеФайла. По завершении операции платформа вызывала указанную процедуру с результатом.

Такой код массово встречается в конфигурациях, доработанных несколько лет назад. Он остаётся рабочим, но при рефакторинге имеет смысл переводить цепочки оповещений на Асинх/Ждать: линейный код проще отлаживать, а вложенные «колбэки» быстро превращаются в трудночитаемую лестницу процедур.

Как выбрать подходящий механизм

Ориентируйтесь на место выполнения и характер операции. Если нужно спросить пользователя, выбрать файл или дождаться внешней компоненты в форме — используйте Асинх/Ждать в клиентской процедуре. Если нужно выполнить тяжёлый расчёт, провести пакет документов или сформировать большой отчёт — запускайте фоновое задание на сервере, а в форме покажите индикатор и обработайте завершение.

Частая архитектурная ошибка — пытаться выполнить серверный расчёт через клиентский Ждать. Это не снимает нагрузку: серверный вызов всё равно выполняется в рамках сеанса, а сеанс занят. Реальную разгрузку даёт только фоновое задание с отдельным сеансом.

Типичные ошибки и ограничения

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

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

Как проверить, что асинхронный код работает правильно

Простейший тест: во время выполнения длительной операции попробуйте взаимодействовать с формой — она должна оставаться отзывчивой (для фоновых заданий). Для клиентского Асинх проверьте, что после Ждать выполняется ветка обработки результата, включая случай отмены пользователем (результат Неопределено).

Для фоновых заданий контролируйте состояние через консоль заданий или метод ФоновыеЗадания.ПолучитьФоновыеЗадания с отбором по ключу: задание должно завершаться состоянием «Завершено», а не «Ошибка». Текст ошибки задания доступен через свойство ИнформацияОбОшибке объекта задания.

Ответы на частые вопросы