При разработке механизмов асинхронного выполнения кода в 1С:Предприятие 8 программисты часто сталкиваются с неочевидным поведением метода ФоновыеЗадания.Выполнить(). Одной из самых распространенных ошибок является несоответствие количества передаваемых данных и количества входящих аргументов в процедуре-обработчике. В этой статье мы подробно разберем, как работает механизм «распаковки» параметров, проанализируем типичные ошибки и составим алгоритм правильной реализации фонового выполнения кода.
Рассмотрим ситуацию: разработчик создает процедуру в общем модуле, которую планирует запускать в фоне. Для передачи данных он использует Массив, добавляет в него несколько значений (например, дату, подразделение и список номенклатуры) и передает этот массив в метод ФоновыеЗадания.Выполнить(). Однако при запуске система выдает критическую ошибку в Журнале регистрации: «Много фактических параметров для метода фонового задания».
Выясним причину такого поведения. Согласно спецификации 1С, метод Выполнить() принимает вторым параметром объект типа Массив. Но важно понимать: этот массив не передается в целевую процедуру как один объект. Система производит автоматическую «распаковку» элементов массива. Каждый элемент массива становится отдельным входящим параметром вызываемой процедуры в порядке их следования.
Проанализируем пример. Если мы передаем массив из четырех элементов:
ПараметрыФЗ = Новый Массив;
ПараметрыФЗ.Добавить(СписокНоменклатуры); // Элемент 1
ПараметрыФЗ.Добавить(ДатаНачала); // Элемент 2
ПараметрыФЗ.Добавить(ДатаОкончания); // Элемент 3
ПараметрыФЗ.Добавить(Подразделение); // Элемент 4
Задание = ФоновыеЗадания.Выполнить("МойМодуль.ВыполнитьРасчет", ПараметрыФЗ);
Тогда вызываемая процедура ВыполнитьРасчет обязательно должна иметь ровно четыре параметра. Если в описании процедуры указан только один параметр (например, Процедура ВыполнитьРасчет(МассивДанных)), платформа попытается «запихнуть» четыре значения в один аргумент и выдаст ошибку о переизбытке параметров.
Самый прозрачный способ — переписать сигнатуру экспортной процедуры так, чтобы количество её аргументов совпадало с количеством элементов в передаваемом массиве. Разберем по шагам, как это должно выглядеть в коде.
В месте вызова фонового задания мы формируем массив:
ПараметрыДляЗапуска = Новый Массив;
ПараметрыДляЗапуска.Добавить(Объект.СписокТоваров);
ПараметрыДляЗапуска.Добавить(Объект.ДатаНачала);
ПараметрыДляЗапуска.Добавить(Объект.ДатаОкончания);
ПараметрыДляЗапуска.Добавить(Объект.Склад);
ФоновыеЗадания.Выполнить("РасчетСервер.ОбработатьДанные", ПараметрыДляЗапуска);
В общем модуле РасчетСервер процедура должна выглядеть следующим образом:
Процедура ОбработатьДанные(СписокТоваров, ДатаНачала, ДатаОкончания, Склад) Экспорт
// Здесь идет логика обработки
Для Каждого СтрокаТовара Из СписокТоваров Цикл
// ...
КонецЦикла;
КонецПроцедуры
Важный нюанс: обратите внимание, что параметры в процедуру придут именно в том порядке, в котором вы добавляли их в массив методом Добавить(). Названия переменных в процедуре могут быть любыми, но их позиция критична.
Иногда требуется передать в процедуру именно один массив (например, если количество элементов заранее неизвестно или вы хотите сохранить универсальность кода). Чтобы обойти механизм автоматической распаковки, мы должны поместить наш целевой массив внутрь другого, вспомогательного массива.
Рассмотрим, как реализовать «массив массивов»:
// Наш основной массив с данными
ДанныеДляФона = Новый Массив;
ДанныеДляФона.Добавить(Значение1);
ДанныеДляФона.Добавить(Значение2);
// Контейнер, который увидит метод ФоновыеЗадания.Выполнить
КонтейнерПараметров = Новый Массив;
КонтейнерПараметров.Добавить(ДанныеДляФона); // Единственный элемент контейнера
ФоновыеЗадания.Выполнить("ОбщийМодуль.ПроцедураСОднимПараметром", КонтейнерПараметров);
В этом случае платформа «распакует» КонтейнерПараметров, увидит в нем один элемент (наш массив ДанныеДляФона) и передаст его в процедуру, ожидающую ровно один аргумент:
Процедура ПроцедураСОднимПараметром(МассивДанных) Экспорт
// МассивДанных здесь — это и есть наш исходный ДанныеДляФона
КонецПроцедуры
Даже если количество параметров совпадает, фоновое задание может не запуститься, если не соблюдены правила описания программных интерфейсов. Проанализируем основные требования:
Экспорт.Выполнить() не может вызывать процедуры из модулей объектов (справочников, документов) напрямую. Только методы общих модулей.Часто ошибка «параметров» маскирует другую проблему — невозможность передать конкретный тип данных в фон. Посмотрим на ограничения. Все данные, передаваемые через массив параметров, должны поддерживать сериализацию. Это связано с тем, что параметры копируются из одного сеанса (вашего) в другой сеанс (фоновое задание).
Что нельзя передавать напрямую:
Запрос, ТаблицаЗначений (в некоторых режимах), ДеревоЗначений.Если вам необходимо передать большой объем данных (например, таблицу из 100 000 строк), лучше использовать Временное хранилище. Поместим таблицу в хранилище, получим адрес (строку) и передадим этот адрес в качестве параметра фоновому заданию. Внутри задания выполним ПолучитьИзВременногоХранилища(Адрес).
Бывают ситуации, когда вы уже исправили количество параметров, но ошибка «Слишком много фактических параметров» продолжает появляться. Рассмотрим причину — это кэширование конфигурации на сервере 1С. Серверный рабочий процесс может хранить старую версию скомпилированного модуля.
Чтобы исключить влияние кэша, рекомендуем:
-debug.Для отладки самого фонового задания в Конфигураторе необходимо зайти в меню Отладка -> Подключение и настроить Автоматическое подключение для типа «Фоновые задания». После этого точка останова внутри вашей процедуры сработает, как только задание начнет выполнение.
Разберем полезный прием, который помогает избежать дублирования заданий при пакетной обработке (например, по подразделениям). Третий параметр метода Выполнить() — это уникальный Ключ.
КлючЗадания = "РасчетПодразделения_" + Строка(Подразделение.УникальныйИдентификатор());
Задание = ФоновыеЗадания.Выполнить("Модуль.Расчитать", Параметры, КлючЗадания);
Если вы запустите задание с таким ключом, пока предыдущее с таким же ключом еще не завершено, система либо не запустит новое, либо позволит вам программно отследить наличие уже работающего процесса. Это критически важно при массовой генерации фоновых заданий, чтобы не перегрузить сервер 1С идентичными вычислениями.
Подводя итог: всегда проверяйте соответствие количества элементов в массиве Параметры количеству аргументов в Процедура Имя(П1, П2...Пn). Помните о сериализации и используйте временное хранилище для сложных структур данных.