К статье
Практический материал

Другое · 7 мин

Передача параметров в фоновое задание 1С

Как передать параметр в фоновое задание 1С: способы, допустимые типы данных, проверка выполнения и типичные ошибки при асинхронной обработке.

Фоновое задание в 1С выполняется асинхронно, обычно на сервере, и не ждет завершения в текущем сеансе пользователя. Поэтому все данные, которые задание должно обработать, нужно передать до запуска, а не пытаться подставить их уже в процессе выполнения.

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

Перед запуском стоит определить, какое именно действие будет выполняться в фоне: обмен данными, расчет, формирование отчета или обработка документов. От этого зависит выбор способа передачи параметров и набор проверок перед запуском.

1. Что важно понять перед передачей параметра

Фоновое задание работает независимо от интерфейса пользователя. Если вы передаете ссылку на форму, таблицу значений, открытую в сеансе, или временный объект, фоновый процесс может не получить к нему доступа. Параметр должен быть самодостаточным значением или идентификатором, по которому задание само найдет нужные данные.

Перед передачей параметра проверьте, существует ли объект, на который вы ссылаетесь, и не будет ли он удален или изменен другим пользователем до старта задания. В противном случае фоновое задание может завершиться с ошибкой или обработать устаревшие данные.

2. Способы передачи параметров в фоновое задание

В зависимости от релиза платформы и конфигурации параметры могут передаваться через параметры команды фонового задания, через свойства объекта задания или через отдельную структуру/набор значений. Суть одна: задание получает набор входных данных при создании и использует их в процедуре обработки.

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

Порядок передачи параметра
  1. 1
    Определите входные данные фонового задания
  2. 2
    Упакуйте параметры в структуру или набор значений
  3. 3
    Создайте фоновое задание и укажите команду обработки
  4. 4
    Передайте параметры при создании задания
  5. 5
    Запустите задание и зафиксируйте его идентификатор

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

Безопаснее всего передавать примитивные типы: строки, числа, даты, булевы значения, а также идентификаторы документов, справочников и регистров. Такие данные легко сериализуются и не зависят от состояния клиентского приложения.

Не рекомендуется передавать ссылки на формы, элементы управления, временные таблицы, открытые наборы записей и объекты, привязанные к текущему сеансу. Фоновый процесс может быть выполнен на другом сервере или в другом сеансе, где такие ссылки недействительны.

4. Пример подхода к созданию задания с параметрами

Типичная схема выглядит так: создать объект фонового задания, задать команду обработки, передать параметры, сохранить или добавить задание в менеджер фоновых заданий. Точные имена методов и свойств зависят от версии платформы 1С:Предприятие, поэтому перед внедрением уточните их в справочнике разработчика для вашего релиза.

Задание = МенеджерФоновыхЗаданий.СоздатьЗадание();
Задание.Команда = "ОбработатьДанныеВФоне";
Задание.Параметры.Вставить("Документ", НомерДокумента);
Задание.Параметры.Вставить("Дата", ДатаОбработки);
МенеджерФоновыхЗаданий.Добавить(Задание);

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

Контрольные точки

Как проверить результат

Статус фонового задания
Норма

Завершено без ошибок

Тревожный признак

Ошибка выполнения или зависание

Запись результата по параметру
Норма

Найдена запись с переданным идентификатором

Тревожный признак

Запись отсутствует или не соответствует параметрам

Журнал регистрации
Норма

Нет критических сообщений по заданию

Тревожный признак

Есть исключения при обработке параметров

5. Как проверить выполнение и получить результат

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

Проверьте статус задания: выполнено, выполнено с ошибкой или отменено. Если задание завершилось с ошибкой, просмотрите текст исключения и параметры, с которыми запускалось задание, чтобы понять, проблема во входных данных или в самой обработке.

Типичные ошибки
01
Передача ссылок на формы и временные объекты — задание не найдет данные после закрытия сеанса
02
Изменение параметров после создания задания — новые значения не применяются к запущенному процессу
03
Передача слишком больших таблиц в параметрах — высокая нагрузка на сервер и медленное выполнение

6. Ограничения и частые ошибки

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

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

7. Альтернативы и границы самостоятельной работы

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

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

Итог

Что важно запомнить

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

Часто задаваемые вопросы

Можно ли передать объект документа напрямую в фоновое задание?

Напрямую передавать объект документа, открытый в форме, небезопасно. Лучше передать идентификатор документа или его уникальный номер, а внутри фонового задания прочитать актуальные данные из базы.

Что делать, если фоновое задание не выполняется с переданными параметрами?

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

Можно ли изменить параметры уже запущенного фонового задания?

Обычно нет: входные параметры фиксируются при создании задания. Если нужны другие данные, создайте новое задание с обновленными параметрами.

Какие параметры наиболее безопасны для фоновой обработки?

Наиболее безопасны простые значения: строки, числа, даты, булевы флаги и идентификаторы объектов информационной базы, по которым задание само найдет нужные записи.

Нужно ли логировать переданные параметры?

Да, особенно для критических операций. Логирование параметров и идентификатора задания упрощает поиск причины ошибки, если фоновая обработка завершится некорректно.