Другое · 8 мин
Как передать параметры в регламентное задание 1С
Как передать параметры в регламентное задание 1С: способы через настройки и общие модули, проверка запуска, ограничения и типичные ошибки для самостоятельной настройки.
Регламентные задания в 1С выполняются по расписанию на сервере и не предполагают ввода значений в момент старта. Пользователь не может передать параметр напрямую из формы задания, как это иногда делается при запуске обычной обработки. Поэтому основной вопрос сводится к тому, где хранить нужные данные и как процедура задания их получит.
Способ выбора зависит от конфигурации, версии платформы и того, какие именно значения нужно передать: дата начала периода, организация, номер документа, флаг обработки или путь к файлу. Не все параметры одинаково безопасно передавать в фоновом режиме, особенно если задание меняет остатки, проводки или настройки учета.
Ниже рассмотрены практические подходы, условия их применения и способы проверить, что задание отработало корректно. Рекомендуется сначала отрабатывать изменения на копии базы или в изолированной информационной базе.
Почему параметры не передаются напрямую
Регламентное задание привязано к объекту конфигурации и процедуре, которая вызывается платформой по расписанию. В типовом интерфейсе настройки задания есть расписание, активность и сервер, но нет универсального поля «параметры запуска», доступного для произвольных значений. Это связано с тем, что задание выполняется без текущего пользовательского сеанса.
Из-за отсутствия сеанса недоступны многие формы, диалоги и пользовательские настройки, которые зависят от интерактивного режима. Если процедура использует текущего пользователя, его права или открытую форму, выполнение может завершиться ошибкой или отработать некорректно.
Способ 1: хранить параметры в регистре сведений, константе или настройках
Самый частый подход — создать отдельное место для значений: регистр сведений, константу, план обмена или справочник настроек. Перед запуском задания пользователь или другая процедура записывает нужные параметры в это хранилище, а регламентное задание при старте читает их и использует в расчетах.
Пример логики: задание «Ежемесячное начисление» берет из регистра сведений «ПараметрыРегламентныхЗаданий» запись с именем «НачислениеЗаМесяц» и полем «Месяц». Процедура задания выбирает актуальную запись на дату запуска и формирует документы. Если записи нет, задание должно завершиться с сообщением, а не выполнять расчет по умолчанию.
Когда этот способ уместен
Подходит для параметров, которые меняются редко и готовятся заранее: период, организация, контрагент, флаг включения/выключения. Удобно, если несколько заданий используют одни и те же настройки. Не подходит для значений, которые должны вводиться каждый раз вручную перед каждым запуском.
Способ 2: общий модуль и процедура с параметрами через обёртку
Можно вынести логику в общий модуль с процедурой, принимающей параметры, а регламентному заданию назначить обёртку без параметров. Обёртка читает значения из хранилища или вычисляет их автоматически и вызывает основную процедуру с нужными аргументами.
Это разделяет тестируемую бизнес-логику и механизм запуска. Основную процедуру можно проверить отдельно, передав параметры вручную в консоли или тесте, а обёртка отвечает только за получение контекста серверного задания.
Где задать расписание и как проверить запуск
Расписание настраивается в конфигураторе или в интерфейсе администрирования, в зависимости от конфигурации. Важно проверить, что задание помечено как активное, сервер приложений доступен, а время запуска совпадает с часовым поясом сервера, а не с локальным временем пользователя.
Признаком успешного запуска является запись в журнале регистрации или сообщении о выполнении регламентного задания, отсутствие ошибок и ожидаемые изменения в базе: новые документы, проведенные операции, обновленные остатки. Если задание завершается с ошибкой, нужно смотреть текст исключения, стек вызовов и доступ пользователя от имени которого выполняется задание.
- 1Определите, какие значения нужны заданию и где их хранить
- 2Создайте хранилище параметров: регистр сведений, константу или настройки
- 3Напишите процедуру задания, которая читает параметры перед выполнением
- 4Укажите расписание и активируйте задание
- 5Проверьте журнал регистрации и результат в базе
Ограничения и риски фонового выполнения
Регламентное задание выполняется на сервере без интерактивного пользователя, поэтому операции с формами, выбором из списков или диалогами могут быть недоступны. Права доступа определяются учетной записью сервера или профилем, указанным при настройке, а не правами текущего сотрудника.
Изменение параметров во время выполнения задания может привести к неконсистентным данным, особенно если задание меняет регистры накопления или проводки. Не рекомендуется править значения хранилища параметров, пока задание активно, без понимания этапа выполнения.
| Способ передачи | Где хранятся параметры | Когда подходит | Ограничение |
|---|---|---|---|
| Регистр сведений / константа | Отдельное хранилище настроек | Период, организация, флаги, повторные запуски | Требуется отдельная запись значений перед стартом |
| Общий модуль с обёрткой | Хранилище или вычисление в обёртке | Сложная логика, разделение тестирования и запуска | Нужно поддерживать две процедуры: обёртку и основную |
| Прямые параметры задания | Не поддерживается универсально | Редко, только если конфигурация предоставляет такое поле | Зависит от конфигурации и версии платформы |
Частые ошибки при настройке
Одна из типичных ошибок — считать, что регламентное задание видит текущего пользователя и его настройки. Если процедура опирается на текущего пользователя, в фоновом режиме она может получить пустого пользователя или недостаточно прав.
Другая ошибка — отсутствие обработки ситуации, когда параметры не заданы. Задание может начать расчет с пустыми значениями и создать некорректные документы. Также часто забывают про часовой пояс сервера: задание запускается не в то время, которое ожидает пользователь.
Альтернативы и когда регламентное задание не подходит
Если параметры нужно вводить интерактивно перед каждым запуском, лучше использовать обычную обработку или отчет с параметрами, запускаемую пользователем. Для долгих операций с отслеживанием прогресса могут подходить фоновые задания или асинхронные вызовы, если они поддерживаются конфигурацией.
Регламентное задание уместно для повторяющихся фоновых операций: закрытие месяца, обмен данными, рассылки, пересчет остатков. Оно не подходит для разовых действий, требующих подтверждения пользователя или работы с открытыми формами.
Как проверить результат
Завершено без ошибок
Ошибка выполнения или отсутствие записи о запуске
Ожидаемые документы, остатки или настройки обновлены
Данные не изменились или появились некорректные записи
Совпадают с запланированными
Пустые или неактуальные параметры
Как проверить, что задание отработало корректно
Проверяйте не только факт записи в журнале, но и бизнес-результат: количество созданных документов, дату последнего выполнения, отсутствие необработанных ошибок. Если параметры хранятся в регистре, сверьте, какое значение было прочитано в начале выполнения, с тем, которое планировалось.
При повторных запусках убедитесь, что задание не выполняется дважды из-за неправильного расписания или нескольких активных копий. Дублирование может привести к повторному проведению документов или искажению расчетов.
Что важно запомнить
Параметры в регламентное задание передаются косвенно: через хранилище настроек или обёртку в общем модуле. Перед изменением параметров проверяйте задание на копии базы и контролируйте журнал регистрации.
Можно ли передать параметр прямо в форме регламентного задания?
В типовой настройке регламентного задания нет универсального поля для произвольных параметров запуска. Значения обычно задаются заранее в регистре сведений, константе или настройках, а процедура задания считывает их при старте.
Что делать, если задание не запускается по расписанию?
Проверьте активность задания, доступность сервера приложений, соответствие часового пояса сервера и наличие прав у учетной записи, от имени которой выполняется задание. Также просмотрите журнал регистрации на наличие ошибок при старте.
Безопасно ли менять параметры во время выполнения задания?
Не рекомендуется. Если задание уже читает значения и меняет данные, изменение параметров в процессе может привести к неконсистентным результатам. Лучше вносить изменения между запусками и проверять их на копии базы.
Когда лучше не использовать регламентное задание?
Не используйте его для операций, требующих ввода параметров пользователем при каждом запуска, работы с открытыми формами или разовых действий с обязательным подтверждением. В таких случаях подойдет обычная обработка с параметрами.