Другое · 7 мин
Передача параметров в фоновое задание 1С
Как передать параметр в фоновое задание 1С: способы, допустимые типы данных, проверка выполнения и типичные ошибки при асинхронной обработке.
Фоновое задание в 1С выполняется асинхронно, обычно на сервере, и не ждет завершения в текущем сеансе пользователя. Поэтому все данные, которые задание должно обработать, нужно передать до запуска, а не пытаться подставить их уже в процессе выполнения.
Основная сложность заключается не в самом запуске, а в совместимости передаваемых значений с механизмом фоновой обработки. Параметр должен оставаться доступным после того, как инициализирующий сеанс продолжит свою работу или вообще завершится.
Перед запуском стоит определить, какое именно действие будет выполняться в фоне: обмен данными, расчет, формирование отчета или обработка документов. От этого зависит выбор способа передачи параметров и набор проверок перед запуском.
1. Что важно понять перед передачей параметра
Фоновое задание работает независимо от интерфейса пользователя. Если вы передаете ссылку на форму, таблицу значений, открытую в сеансе, или временный объект, фоновый процесс может не получить к нему доступа. Параметр должен быть самодостаточным значением или идентификатором, по которому задание само найдет нужные данные.
Перед передачей параметра проверьте, существует ли объект, на который вы ссылаетесь, и не будет ли он удален или изменен другим пользователем до старта задания. В противном случае фоновое задание может завершиться с ошибкой или обработать устаревшие данные.
2. Способы передачи параметров в фоновое задание
В зависимости от релиза платформы и конфигурации параметры могут передаваться через параметры команды фонового задания, через свойства объекта задания или через отдельную структуру/набор значений. Суть одна: задание получает набор входных данных при создании и использует их в процедуре обработки.
Если нужно передать несколько значений, удобнее упаковать их в структуру или набор значений с понятными ключами. Это упрощает отладку и снижает вероятность перепутать порядок параметров при запуске.
- 1Определите входные данные фонового задания
- 2Упакуйте параметры в структуру или набор значений
- 3Создайте фоновое задание и укажите команду обработки
- 4Передайте параметры при создании задания
- 5Запустите задание и зафиксируйте его идентификатор
3. Какие значения можно передавать
Безопаснее всего передавать примитивные типы: строки, числа, даты, булевы значения, а также идентификаторы документов, справочников и регистров. Такие данные легко сериализуются и не зависят от состояния клиентского приложения.
Не рекомендуется передавать ссылки на формы, элементы управления, временные таблицы, открытые наборы записей и объекты, привязанные к текущему сеансу. Фоновый процесс может быть выполнен на другом сервере или в другом сеансе, где такие ссылки недействительны.
4. Пример подхода к созданию задания с параметрами
Типичная схема выглядит так: создать объект фонового задания, задать команду обработки, передать параметры, сохранить или добавить задание в менеджер фоновых заданий. Точные имена методов и свойств зависят от версии платформы 1С:Предприятие, поэтому перед внедрением уточните их в справочнике разработчика для вашего релиза.
Задание = МенеджерФоновыхЗаданий.СоздатьЗадание();
Задание.Команда = "ОбработатьДанныеВФоне";
Задание.Параметры.Вставить("Документ", НомерДокумента);
Задание.Параметры.Вставить("Дата", ДатаОбработки);
МенеджерФоновыхЗаданий.Добавить(Задание);
После запуска запишите идентификатор задания в журнал или временное хранилище, чтобы позже найти запись о выполнении. Это особенно важно, если пользователь закрыл форму и не дождался результата на экране.
Как проверить результат
Завершено без ошибок
Ошибка выполнения или зависание
Найдена запись с переданным идентификатором
Запись отсутствует или не соответствует параметрам
Нет критических сообщений по заданию
Есть исключения при обработке параметров
5. Как проверить выполнение и получить результат
Результат фонового задания редко возвращается напрямую в тот же интерфейс. Обычно результат записывается в регистр сведений, журнал регистрации, документ-отчет или отдельное хранилище выполнения. Параметр, переданный в задание, может служить ключом для поиска соответствующей записи результата.
Проверьте статус задания: выполнено, выполнено с ошибкой или отменено. Если задание завершилось с ошибкой, просмотрите текст исключения и параметры, с которыми запускалось задание, чтобы понять, проблема во входных данных или в самой обработке.
6. Ограничения и частые ошибки
Частая ошибка — изменение параметров после создания задания. В большинстве реализаций входные данные фиксируются при запуске, и попытка обновить их уже не влияет на выполняющийся процесс. Все корректировки нужно вносить перед добавлением задания в очередь.
Другая проблема — передача больших объемов данных. Если параметр содержит много строк или большую таблицу, фоновое задание может работать медленно или потреблять много ресурсов сервера. Лучше передать идентификатор набора данных, а само прочитать данные уже внутри фоновой обработки.
7. Альтернативы и границы самостоятельной работы
Если задача требует интерактивного уточнения параметров в процессе выполнения, фоновое задание может быть неудобным выбором. Тогда стоит рассмотреть отложенные операции, регламентные задания или обработку по расписанию с фиксацией параметров в документе.
При работе с критическими данными, финансовыми расчетами или обменом с внешними системами изменения в механизме фоновых заданий лучше проверять на копии информационной базы. Неправильно переданный параметр может привести к повторной обработке или пропуску документов.
Что важно запомнить
Параметры передаются при создании фонового задания, должны быть сериализуемыми, а результат проверяется по идентификатору задания и записям о выполнении.
Часто задаваемые вопросы
Можно ли передать объект документа напрямую в фоновое задание?
Напрямую передавать объект документа, открытый в форме, небезопасно. Лучше передать идентификатор документа или его уникальный номер, а внутри фонового задания прочитать актуальные данные из базы.
Что делать, если фоновое задание не выполняется с переданными параметрами?
Проверьте статус задания, текст ошибки и соответствие переданных значений ожидаемым типам. Убедитесь, что параметры не содержат ссылок на закрытые сеансы или временные объекты.
Можно ли изменить параметры уже запущенного фонового задания?
Обычно нет: входные параметры фиксируются при создании задания. Если нужны другие данные, создайте новое задание с обновленными параметрами.
Какие параметры наиболее безопасны для фоновой обработки?
Наиболее безопасны простые значения: строки, числа, даты, булевы флаги и идентификаторы объектов информационной базы, по которым задание само найдет нужные записи.
Нужно ли логировать переданные параметры?
Да, особенно для критических операций. Логирование параметров и идентификатора задания упрощает поиск причины ошибки, если фоновая обработка завершится некорректно.