Как работает регламентное задание 1с. Запуск фонового задания программно

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

Недавно я разместил статью: пришло время это автоматизировать:

Регламентные и фоновые задания

Механизм заданий предназначен для выполнения какой-либо прикладной или функциональности по расписанию или асинхронно.

Механизм заданий решает следующие задачи:

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

Механизм заданий состоит из следующих компонентов:

Метаданных регламентных заданий;
Регламентных заданий;
Фоновых заданий;
Планировщика заданий.

Фоновые задания & предназначены для выполнения прикладных задач асинхронно. Фоновые задания реализуются средствами встроенного языка.

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

Регламентное задание имеет расписание, которое определяет, в какие моменты времени нужно выполнять связанный с регламентным заданием метод. Расписание, как правило, задается в информационной базе, но может быть задано и на этапе конфигурирования (например, для предопределенных регламентных заданий).

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

С описанием, думаю, хватит - приступим к реализации:

Создание регламентного задания

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

Использование – признак использования регламентного задания.

Предопределенное – указывает, является ли регламентное задание предопределенным.

Если хотите что бы регламентное задание заработало сразу после помещения в БД, укажите признак Предопределенное . В противном случае вам необходимо будет использовать обработку “Консоль заданий” или вызывать запуск задания программно.

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

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

Настройка расписания

Расписание выполнения задания:

Каждый час, только один день	ПериодПовтораДней = 0, ПериодПовтораВТечениеДня = 3600
Каждый день один раз в день	ПериодПовтораДней = 1, ПериодПовтораВТечениеДня = 0
Один день, один раз	ПериодПовтораДней = 0
Через день один раз в день	ПериодПовтораДней = 2
Каждый час с 01.00 до 07.00 каждый день	ПериодПовтораДней = 1ПериодПовтораВТечениеДня = 3600ВремяНачала = 01.00 ВремяКонца = 07.00
Каждую субботу и воскресенье в 09.00	ПериодПовтораДней = 1ДниНедели = 6, 7ВремяНачала = 09.00
Каждый день одну неделю, неделя пропуска	ПериодПовтораДней = 1ПериодНедель = 2
В 01.00 один раз	ВремяНачала = 01.00
Последнее число каждого месяца в 9:00.	ПериодПовтораДней = 1ДеньВМесяце = -1ВремяНачала = 09.00
Пятое число каждого месяца в 9:00	ПериодПовтораДней = 1ДеньВМесяце = 5ВремяНачала = 09.00
Вторая среда каждого месяца в 9:00	ПериодПовтораДней = 1ДеньНеделиВМесяце = 2ДниНедели = 3 ВремяНачала = 09.00

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

Механизмы выполнения фоновых заданий в файловом и клиент-серверном вариантах различаются.

В файловом варианте необходимо создать выделенный клиентский процесс, который будет заниматься выполнением фоновых заданий. Для этого в клиентском процессе должна периодически вызываться функция глобального контекста ВыполнитьОбработкуЗаданий. Только один клиентский процесс на информационную базу должен выполнять обработку фоновых заданий (и, соответственно, вызывать данную функцию). Если клиентского процесса для обработки фоновых заданий не создано, то при программном доступе к механизму заданий будет выдана ошибка «Менеджер заданий не активен». Не рекомендуется клиентский процесс, выполняющий обработку фоновых заданий, использовать для других функций.

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

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

В клиент-серверном варианте имеется возможность блокирования выполнения регламентных заданий. Блокирование выполнения регламентных заданий происходит в следующих случаях:

На информационную базу установлена явная блокировка регламентных заданий. Блокировка может быть установлена через консоль кластера;
На информационную базу установлена блокировка соединения. Блокировка может быть установлена через консоль кластера;
Из встроенного языка вызван метод УстановитьМонопольныйРежим() с параметром Истина;
В некоторых других случаях (например, при обновлении конфигурации базы данных).

Обработки запуска и просмотра регламентных заданий вы можете скачать здесь.

Управление регламентными заданиями баз 1С из обновлятора

2018-11-20T15:18:30+00:00

В этой заметке пробежимся по возможностям обновлятора для управления регламентными заданиями в базах.

Прежде всего в пункте "Ещё" -> "Управление регламентными заданиями...":

В контекстном меню выделенной базы (или группы баз):

И, наконец, в шаблонах для пакетных скриптов (это позволяет выполнять операции над регламентными заданиями из скрипта по расписанию):

Вот так выглядит диалог управления регламентными заданиями в базах:

Какие задачи он позволяет решать в нужной группе баз (или одной базе)?

Выбор регламентных заданий

Обратите внимание на возможность выбора списка регламентных задач во многих операциях ниже:

Но в диалоге выбора может не быть регламентных заданий именно для вашей базы:

В этом случае вы можете указать имена нужных вам регламентных заданий в разделе "Свои задания...", например, так:

Имена для таких регламентных заданий можно брать прямо из отчёта по всем регламентным заданиям (о нём рассказывается ).

Выводим текущее состояние заданий

Для этого переходим на закладку "Вывести" нажимаем кнопку "Вывести...":

В результатах мы можем видеть:

Включен или выключен запуск новых регламентных заданий на сервере 1С.
Список регламентных заданий в базе.
Их расписание.
Включены задания или выключены.
Если последний запуск задания был с ошибкой - эта ошибка выводится красным цветом рядом с заданием.

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

Выключаем все или некоторые задания

Для этого переходим на закладку "Выключить":

Для всех или выбранных регламентных заданий будет снят флажок "Использование".

Вот результат для одной базы (нажмите, чтобы раскрыть)

Включаем все или некоторые задания

Для этого переходим на закладку "Включить":

Для всех или выбранных регламентных заданий будет установлен флажок "Использование".

Обратите внимание, что в этой закладке доступен флаг "Сделать резервную копию базы" в нижнем левом углу.

Вот результат для одной базы (нажмите, чтобы раскрыть)

Управляем запуском регламентных заданий на сервере 1С

Для этого переходим на закладку "Сервер 1С":

Выбираем "блокировать" или "разблокировать" и нажимаем кнопку "Выполнить".

Настраиваем расписание заданий

А что если нам нужно настроить расписание запуска какого-нибудь задания (или группы заданий) сразу во многих базах?

Для этого переходим на закладку "Настроить расписание":

Настраиваем расписание (диалог и его возможности полностью совпадают с штатным в самой 1С) и нажимаем "Настроить...".

Запускаем задания на выполнение

Для этого переходим на закладку "Запустить":

Выбираем нужные задания и нажимаем кнопку "Запустить":

Сохраняем настройки заданий во внешний файл

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

Для этого мы сначала выгружаем все настройки заданий в идеальной базе во внешний файл:

Восстанавливаем настройки заданий из внешнего файла

А затем загружаем этот файл с настройками заданий во все остальные базы:

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

Напутствие

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

Регламентные задания в 1С предназначены для выполнения определенных процедур по расписанию, с некоторой периодичностью.

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

выделить специального пользователя для выполнения регламентных заданий;
должна быть открыта база под этим пользователем, в которой периодически должна выполняться функция ВыполнитьОбработкуЗаданий().

Создание регламентного задания

Регламентные задания — объект метаданных конфигурации 1С. Находится в группе Общие. Рассмотрим параметры и свойства регламентных заданий.

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

Ключ — позволяет создать несколько регламентных заданий одного типа. Например, выполнение синхронизации данных между несколькими информационными базами может быть реализовано с помощью одного объекта метаданных РегламентноеЗадание , при этом самих регламентных заданий будет создано несколько (по количеству баз для обмена). Различаться эти регламентные задания будут с помощью свойства Ключ. Одновременно может выполняться только одно задание с одинаковым ключом.

Использование — флаг, показывающий, включено ли регламентное задание.

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

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

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

Программная работа с регламентными заданиями

В данных примерах будем рассматривать работу с обычными, не предопределенными, регламентными заданиями.

Программное создание регламентного задания

//Создаем задание
"ИмяРегдаментногоЗадания" ) ;

//Устанавливаем ключ регламентного задания (не обязательно)
Задание. Ключ = "КлючЗадания" ;

//Включаем регламентное задание
Задание. Использование = Истина ;

//Записываем регламентное задание
Задание. Записать() ;

Программное получение регламентного задания для изменения параметров

В этом примере предположим, что существует только одно регламентное задание данного типа. Если заданий несколько, то, зная , нетрудно внести в код соответствующие изменения.

"ИмяРегламентногоЗадания" ] ) ) ;

Если Задания. Количество() > 0 Тогда
Задание= Задания[ 0 ] ;

Иначе
Задание = РегламентныеЗадания. СоздатьРегламентноеЗадание("ИмяРегламентногоЗадания" ) ;

КонецЕсли ;

//Регламентное задание находится в переменной Задание. Можно изменять его параметры.

Вызов диалога изменения расписания регламентного задания

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

//Получаем массив с регламентными заданиями нужного типа
Задания= РегламентныеЗадания. ПолучитьРегламентныеЗадания(новый Структура("Метаданные" , Метаданные. РегламентныеЗадания[ "ИмяРегламентногоЗадания" ] ) ) ;

//Если задание существует, то по условию оно одно
Если Задания. Количество() > 0 Тогда
Задание= Задания[ 0 ] ;

//Если задания нет, создадим его
Иначе
Задание = РегламентныеЗадания. СоздатьРегламентноеЗадание("ИмяРегламентногоЗадания" ) ;

КонецЕсли ;

Расписание= Задание. Расписание;

//Создаем диалог изменения расписания регламентного задания
ДиалогРедактирования= Новый ДиалогРасписанияРегламентногоЗадания (Расписание) ;

//Показываем диалог пользователю и обрабатываем изменения расписания
Если ДиалогРедактирования. ОткрытьМодально() Тогда
Задание. Расписание = ДиалогРедактирования. Расписание;
Задание. Записать() ;
КонецЕсли ;

Нередко при ведении учета возникает необходимость в периодическом выполнении тех или иных действий без вмешательства пользователя. Регламентные и фоновые задания в 1С – те механизмы, которые предусмотрены для этой цели в восьмой версии программы и позволяют:

Настроить своевременное допреведение документов;
Рассчитать остатки и итоги;
Обеспечить периодичность почтовой рассылки;
Проверить и удалить неактуальные данные.

Фоновое и регламентное задание – что это и где настраивается

Регламентное задание – заложенный в 1С механизм, который позволяет настроить и, в соответствии с заложенным расписанием и периодичностью, выполнить определенную последовательность действий.

Фоновое задание – действие, порожденное регламентной операцией и не требующее непосредственного участия пользователя.

Создание регламентного задания происходит в режиме конфигуратора:

В окне дерева конфигурации находим соответствующую ветку (Рис.1);

Нажимаем кнопку добавить;
В открывшемся окне необходимо задать имя, позволяющее идентифицировать объект в конфигурации;

Рис.2

Напротив надписи «Расписание» (Рис. 2) есть надпись «Открыть», нажатие на которую открывает окно настройки времени и периодичности выполнения обрабочика (Рис.3);

Рис.3

Также необходимо заполнить «Имя метода» (сюда будет введено название процедуры, вызываемой из общего модуля и описывающей алгоритм поведения программы);
Поля «Наименование» и «Ключ» позволяют группировать объекты;
Установленный флажок «Использование» указывает на активность регламентной операции;
«Предопределенное» следует установить, если обработчик должен запуститься сразу после его добавления в базу в противном случае запуск можно произвести из соответствующей обработки (о ней ниже);
Параметры «Количество повторов» и «Интервал повторов» описывают поведение программы в случае возникновения исключительной ситуации при выполнении фонового задания.

Итак, используя механизм регламентных операций можно задать расписание и основные действия фоновых заданий. Давайте теперь рассмотрим их особенности.

Особенности фоновых заданий

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

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

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

Особенности работы в клиент-серверном режиме

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

Фоновые задания в файловом режиме

До версии платформы 8.3.3.641 работа с фоновыми заданиями в файловом варианте представляла некоторые трудности:

Необходимо было запускать отдельный сеанс, который бы круглосуточно работал, заменяя собой планировщик;
Этот сеанс должен был периодически выполнять метод ВыполнитьОбработкуЗаданий().

После обновления каждый старт толстого и тонкого клиентов, в случае если в настройках запуска (Рис.4) в поле «Дополнительные » указан ключ AllowExecuteScheduledJobs, инициирует дополнительный поток подключения к базе, который ни как не влияет на работу пользователя, а занимается только выполнением фоновых операций.

Рис.4

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

Как отключить регламентные задания

Неиспользуемые задания можно отключить, просто сняв в свойствах объекта галочку «Использовать».

В случае, когда администратору необходимо запретить использование регламентных и фоновых операций для всей базы в целом (допустим, не сервере хранится несколько баз, из которых только одна основная, а остальные используются только для разработки) необходимо воспользоваться утилитой администрирования баз. Также можно в создаваемой на сервере базе поставить галочку «Установить блокировку регламентных заданий».

Кроме этого на дисках ИТС имеется специальная обработка «Консоль заданий», позволяющая редактировать расписание фоновых процессов и менять их активность.

Наверное, ни одна серьезная конфигурация на 1С 8.3 или 8.2 не обойдется без использования регламентных и фоновых заданий. Они очень удобны, так как по четко заданному расписанию будут выполняться без вмешательства пользователя и программиста.

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

Для начала разберемся, что же они обозначают и в чем их отличие:

Регламентное задание позволяет запускать на выполнение какие-либо конкретные действия по заранее настроенному расписанию.
Фоновое задание – это объект, в котором содержатся выполняемые действия.

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

Откройте конфигурацию и добавьте регламентное задание.

Настройка свойств

Рассмотрим самые важные параметры, которые необходимо заполнить в его свойствах.

В поле «Имя метода » выбирается та процедура какого-то определенного общего модуля, которая будет непосредственно выполняться. В ней будут указаны все действия по выгрузке цен на наш сайт. Обратите внимания, что выполнение будет происходить на сервере. Это логично, ведь регламентные операции выполняются без участия пользователя.
Регламентное задание можно отключать или включать по необходимости. Не нужно каждый раз править его расписание. Для этого в палитре свойств установите или снимите флаг «Использование ».
Еще одной немаловажной является настройка, будет ли являться данное регламентное задание предопределенным , или нет. Предопределенные регламентные задания запускаются автоматически. Если данный признак не установлен, то вам будет нужно запускать их программно, либо воспользоваться обработкой «Консоль заданий» с ИТС.
Так же вы можете указать количество повторов и интервал между ними при аварийном завершении. Под аварийным завершением подразумеваются те ситуации, когда задания не отработали по причине возникновения ошибки.

Настройка расписания

Завершающим шагом мы настроим расписание нашей выгрузки на сайт по соответствующей гиперссылке в палитре свойств.

Перед вами откроется типовая настройка расписания в 1С 8.3. Здесь нет ничего сложного. В рамках данного примера мы настроили запуск нашей выгрузки цен на сайт ежедневно с пяти до семи утра. В том случае, если регламентное задание не успеет отработать до 7:00, оно будет выполнено уже на следующий день.

Блокировка регламентных заданий

Запустите стандартную утилиту «Администрирование серверов 1С Предприятия» и откройте свойства той информационной базы, где вы создали регламентное задание (для клиент-серверных версий 1С).

В открывшемся окне (после ввода логина и пароля для доступа к ИБ) проверьте, чтобы не был установлен флаг на пункте «Блокировка регламентных заданий включена». Если вы столкнулись ситуацией, когда задание не отрабатывает, первым делом проверяйте эту настройку.

Таким же образом можно полностью отключить регламентные задания в 1С 8.3. Для отключения конкретных фоновых заданий можно воспользоваться встроенной в последние релизы обработкой «Консоль фоновых заданий».

Фоновые и регламентные задания в файловом режиме

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

Активация регламентных заданий в данном случае производится при использовании метода «ВыполнитьОбработкуЗаданий()».

Так же вы можете воспользоваться следующей конструкцией:

В качестве имени процедуры необходимо указать имя клиентской процедуры, которая должна будет выполниться. Интервал показывает, через сколько секунд будет произведено выполнение. Параметр «Однократно» не обязателен к заполнению. Он отражает, будет ли выполнена данная процедура однократно, либо несколько раз.

Отслеживание ошибок в фоновых заданиях

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

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