Разница между задачами и функциями. Регламентные и фоновые задания (1Cv8)
Регламентные задания в 1С предназначены для выполнения определенных процедур по расписанию, с некоторой периодичностью.
Регламентные задания хранятся в информационной базе, имеют расписание запуска. Сам запуск производится полностью автоматически, если режим работы информационной базы клиент-серверный. Если же база файловая, то необходимо выполнить следующие действия:
- выделить специального пользователя для выполнения регламентных заданий;
- должна быть открыта база под этим пользователем, в которой периодически должна выполняться функция ВыполнитьОбработкуЗаданий().
Создание регламентного задания
Регламентные задания — объект метаданных конфигурации 1С. Находится в группе Общие. Рассмотрим параметры и свойства регламентных заданий.
Имя метода — путь к экспортной процедуре в общем модуле, которая будет выполняться по заданному расписанию. Процедура должна выполняться на сервере. В этом регламентные задания чем-то похожи на объект Подписка на событие.
Ключ — позволяет создать несколько регламентных заданий одного типа. Например, выполнение синхронизации данных между несколькими информационными базами может быть реализовано с помощью одного объекта метаданных РегламентноеЗадание , при этом самих регламентных заданий будет создано несколько (по количеству баз для обмена). Различаться эти регламентные задания будут с помощью свойства Ключ. Одновременно может выполняться только одно задание с одинаковым ключом.
Использование — флаг, показывающий, включено ли регламентное задание.
Предопределенное — здесь можно провести аналогию с предопределенными элементами справочника. Предопределенные элементы создаются в конфигураторе и применяются пользователями в работе. Обычные элементы пользователь создает сам. С регламентными заданиями точно так же: если оно предопределенное, то оно существует и может выполняться по расписанию сразу после создания в конфигураторе. Если же флаг Предопределенное не установлен, то пользователю нужно самому создать одно или несколько регламентных заданий данного типа (например, через Консоль заданий ).
Количество повторов при аварийном завершении задания — определяет, сколько раз будет выполнен перезапуск фонового задания, если оно было завершено с ошибкой.
Интервал повтора при аварийном завершении задания — определяет, с какой периодичностью будет выполнен перезапуск фонового задания, если оно было завершено с ошибкой.
Программная работа с регламентными заданиями
В данных примерах будем рассматривать работу с обычными, не предопределенными, регламентными заданиями.
Программное создание регламентного задания
//Создаем задание
"ИмяРегдаментногоЗадания"
)
;
//Устанавливаем ключ регламентного задания (не обязательно)
Задание.
Ключ =
"КлючЗадания"
;
//Включаем регламентное задание
Задание.
Использование =
Истина
;
//Записываем регламентное задание
Задание.
Записать()
;
Программное получение регламентного задания для изменения параметров
В этом примере предположим, что существует только одно регламентное задание данного типа. Если заданий несколько, то, зная , нетрудно внести в код соответствующие изменения.
"ИмяРегламентногоЗадания"
]
)
)
;
Если
Задания.
Количество()
>
0
Тогда
Задание=
Задания[
0
]
;
Иначе
Задание =
РегламентныеЗадания.
СоздатьРегламентноеЗадание("ИмяРегламентногоЗадания"
)
;
КонецЕсли ;
//Регламентное задание находится в переменной Задание. Можно изменять его параметры.
Вызов диалога изменения расписания регламентного задания
Для работы с расписанием регламентного задания существует особый тип диалога. Все еще предполагаем, что у нас есть только одно регламентное задание данного типа.
//Получаем массив с регламентными заданиями нужного типа
Задания=
РегламентныеЗадания.
ПолучитьРегламентныеЗадания(новый Структура("Метаданные"
,
Метаданные.
РегламентныеЗадания[
"ИмяРегламентногоЗадания"
]
)
)
;
//Если задание существует, то по условию оно одно
Если
Задания.
Количество()
>
0
Тогда
Задание=
Задания[
0
]
;
//Если задания нет, создадим его
Иначе
Задание =
РегламентныеЗадания.
СоздатьРегламентноеЗадание("ИмяРегламентногоЗадания"
)
;
КонецЕсли ;
Расписание= Задание. Расписание;
//Создаем диалог изменения расписания регламентного задания
ДиалогРедактирования=
Новый
ДиалогРасписанияРегламентногоЗадания (Расписание)
;
//Показываем диалог пользователю и обрабатываем изменения расписания
Если
ДиалогРедактирования.
ОткрытьМодально()
Тогда
Задание.
Расписание =
ДиалогРедактирования.
Расписание;
Задание.
Записать()
;
КонецЕсли
;
Как правило фоновые задания в 1C:Предприятии запускаются из-под регламентного.
То есть при старте регламентное задание порождает фоновое. Но в случае необходимости
мы можем запустить фоновое задание и программно.
При этом оно может использовать любые методы и свойства доступные на сервере, т.к. и выполняется оно на сервере.
По сути само фоновое задание никаких действий не производит. Оно лишь запускает
на выполнение процедуру из общего модуля. Если в процедуре используются параметры,
их также можно передавать в момент запуска фонового задания.
Рассмотрим простейший пример. Создадим обработку, которая будет запускать фоновое
задание, которое в свою очередь будет делать запись в журнале регистрации.
Поскольку
для фонового задания нам нужна процедура общего модуля, создадим этот общий модуль
с возможностью выполнения его процедур на сервере.
Создадим в этом общем модуле процедуру, которая будет делать запись в журнал
регистрации
Как видим в процедуре есть параметры. Значит фоновое задание должно их будет каким-то
образом в процедуру передать.
Теперь создадим обработку с помощью которой будем запускать фоновое задание.
Сделаем ее на управляемой форме, но для обычных форм принципиальной разницы не будет,
методы используются те же самые. Создаем простейшую форму с одной командой:
В модуле формы пишем следующий код:
Запускается фоновое задание при помощи метода Выполнить()
менеджера фоновых заданий.
В качестве первого параметра этого метода указывается
имя общего модуля и имя процедуры, которая будет выполняться, тип — строка.
Второй параметр — это массив со значениями парметров для вызываемой процедуры.
Порядок следования элементов в массиве должен совпадать с порядком параметров в
процедуре.
Могут еще указываться Ключ
и Наименование
фонового задания.
А теперь протестируем работу обработки. Откроем ее в режиме 1С:Предприятия и
запустим на выполнение. Далее открываем журнал регистрации и видим, что задание
отработало успешно и сделало в журнале соответствующую запись.
Платформы
: 1С:Предприятие 8.3, 1С:Предприятие 8.2, 1С:Предприятие 8.1
Конфигурации
: Все конфигурации
2012-11-13
53136
В документообороте существуют задачи, которые требуют периодического выполнения — к примеру, по двадцатым числам, либо ежедневно. Как правило, в компаниях специально для этого, создаются определенные правила, в которых обозначено, когда и как должна выполняться необходимая задача, и кто должен проконтролировать процесс. Такие задачи выполняются согласно регламенту и называются — регламентированными.
Довольно часто, в ИТ соблюдается регламент при мониторинге. Такой метод отлично знаком администраторам, так как для этого существуют специальные программы, применяемые для периодической проверки работоспособности сетевой инфраструктуры и серверов. Об обнаруженных неполадках они извещают администратора с помощью СМС, либо электронного письма.
Похожая система действует и для веб-мастеров, при этом, доступность сайта проверяется в течение суток. При помощи механизма "Регламентные задания" в 1С осуществляются задачи мониторинга, а также, периодические задачи, которые выполняются по расписанию в автоматическом режиме в 1С. Рассмотрим подробнее данную тему.
Регламентные задания 1С
Объект 1С, который называется "Регламентные задания" — дает возможность выполнить обработку информации не после возникновения проблемы, а по расписанию. В конфигураторе, регламентное задание является способом задать настройки и установить расписание. Кроме этого, существует возможность в последствии изменять расписание в режиме 1С Предприятие.
При использовании файловой базы данных, задания автоматически не выполняются. Для того, чтобы запустить процесс, необходимо запустить сеанс 1С, в режиме 1С Предприятие и уже в нем запустить выполнение регламентного задания.
Все типовые конфигурации обладают настройкой пользователя, позволяющей уточнить, что при работе 1С, регламентные задания будут выполняться автоматически.
Использование клиент-серверного варианта 1С дает возможность автоматического выполнения задач на сервере. Во запланированное время — осуществляется запуск фонового задания, которое и выполняет необходимые действия. Для параллельных вычислений на сервере, фоновое задание может быть создано из текста программы, при помощи языка 1С, без использования регламентного задания 1С. Действие регламентного задания можно временно отключить, используя для этого консоль управления сервером 1С.
Добавление регламентного задания
Регламентные задания расположены в — Конфигуратор — Общие — Регламентные задания. Добавьте новое "задание" и укажите имя. Дальше, необходимо зайти в свойства «Задания». И выбрать Имя метода. Здесь, нужно указать функцию обработчика, так же, как это происходит в подписке на событие. Данная функция будет расположена в общем модуле и обозначена "птичкой" Сервер в свойствах. Это значит, что необходимый модуль требуется добавить заранее.
Наименование задания в Свойствах регламентного задания позволяет определить его название, которое далее будет фигурировать в средствах управления заданиями. Функция Свойства регламентного задания — является ключем, позволяющим группировать несколько разных регламентных заданий. При этом одновременно может быть запущено лишь одно задание с одинаковым значением ключа. Здесь, значение может быть произвольным, но заполнять его обязательно, так как пустое значение не учитывается системой.
В Бухгалтерии редакции 2.0, которая является типовой конфигурацией, регламентные задания, такие как: "Пересчет итогов" и "Обновление конфигурации" — являются предопределенными, а такие, как например "Отложенные движения" и "Обмен данными" — не предопределенными.
Повтор при аварийном завершении — перезапуск действующего задания. Предусмотрен для осуществления запуска, который не был успешно выполнен с первого раза. Здесь, указано, сколько раз можно перезапускать и по прошествии какого времени после аварийного завершения.
Мониторинг и средства управления регламентным заданием 1С
За управление регламентным заданием отвечает типовая обработка "Консоль заданий", которую можно найти на дисках ИТС. Данная обработка является универсальной внешней типовой обработкой 1С. Как правило, она не входит в конфигурацию, а приобретается отдельно.
С ее помощью можно осуществлять следующие действия:
Включать и выключать регламентное задание;
Назначать и изменять расписание;
Обозначить имя пользователя, с помощью которого будет выполняться регламентное задание;
Видеть выполненные задачи (когда и с каким результатом), а также, ошибки задания;
Регламентное задание и копии баз данных
При использовании серверной 1С, может возникнуть такой момент:
Для программирования необходимо сделать копию рабочей базы;
Необходимость работы в копиях базы (тестирование);
По каким-то причинам не включено регламентное задание в тестовой базе.
Если одна из таких ситуаций возникла во время выполнения задач регламентным заданием, которые связаны только со своей базой данных, то это не несет за собой негативных последствий. Но, зачастую, регламентное задание может сохранять файлы, либо другие данные, высылать электронные письма, проводить обмен. В таком случае, может возникнуть путаница между результатами работы «задания» и копиями. Для того чтобы этого не происходило, необходимо отключить «задачи» в консоли управления сервером.
Выполненные и не выполненные регламентные задачи
Во время создания регламентных задач, важно проверить может ли задача быть выполнена как регламентное задание. Важно знать, что серверный модуль не дает многих вещей, которые возможны на клиенте. Далее, задача, имеющая дело с чем-то, что находится вне базы — важную роль при этом, играют права пользователя Windows, под которым происходит выполнение задания.
Последний фактор является особенно важным, так как если модуль не выполняется на сервере, то и задание не может быть выполнено в принципе. Чтобы проверить, необходимо запустить одно задание и оценить результат.
Создаем регламентное задание
Создадим регламентное задание «Выполнение обработки».
Отключим использование регламентного задания, чтобы при обновлении конфигурации оно автоматом не запускалось.
Назначим процедуру, которая будет срабатывать при запуске регламентного задания: МодульРегламентныхЗаданий.РегламентноеЗаданиеВыполнениеОбработки .
Сама процедура имеет вид:
Процедура РегламентноеЗаданиеВыполнениеОбработки(Ключ) Экспорт
ПараметрыРегламентныхЗаданий.ВыполнитьОбработкуСПараметрами(Ключ);
КонецПроцедуры
Создаем справочник для регламентных заданий
Наше регламентное задание может порождать множество фоновых процессов - по одному на каждую обработку. У каждого задания в платформе 1С8 есть ключ. Но метод регламентного задания не знает ключ фонового задания, поэтому нужно использовать параметры фонового задания. В результате мы можем видеть фоновое задание в консоли заданий, но не можем вручную из этой консоли создать фоновое задание, т.к. задания с параметрами вручную не создаются.
Справочник «Параметры регламентных заданий» :
Реквизиты :
· КодПередЗапуском - неограниченная строка - код на языке 1С, который нужно выполнить перед запуском.
· Обработка из конфигурации - строка (100) - идентификатор обработки из конфигурации
· Обработка из справочника - строка (100) - ссылка на элемент справочника «Внешние обработки», если такой имеется в конфигурации
· Выполнять через приложение 1С - булево - будет создано отдельное приложение 1С и в нем будет запущено регламентное задание. Создано для 8.1, где не все методы приложения доступны на сервере, где работает регламентное задание.
· КодЗапуска - - неограниченная строка - код на языке 1С, который будет выполняться при запуске регламентного задания.
Создадим форму элемента :
По нажатию на кнопку «Создать регл. задание» программно создается регламентное задание с ключом-кодом:
Процедура ОсновныеДействияФормыСоздатьРеглЗадание(Кнопка)
Перем Задание;
Ключ = СокрЛП(Код);
Задание = РегламентныеЗадания.СоздатьРегламентноеЗадание("ВыполнениеОбработки");
Задание.Наименование = Ключ;
Задание.Ключ = Ключ;
Параметры = Новый Массив();
Параметры.Добавить(Ключ);
Задание.Параметры = Параметры;
Задание.Записать();
КонецПроцедуры
Запуск регламентного задания
Каждое созданное нами регламентное задание имеет ключ:
Этот ключ соответствует коду справочника «Параметры регламентных заданий», по нему осуществляется поиск при старте задания. Если элемент справочника не найдено, задание не выполняется.
Далее, если задан код КодПередЗапуском то будет выполнен этот код. Далее, если переменная Выполнять примет значение ложь, то задание не будет выполнено. При анализе доступна переменная Параметры , где хранится ссылка на найденный элемент справочника «Параметры регламентных заданий».
В зависимости от выбранных значений реквизитов или запустится код на языке 1С, или запустится обработка из конфигурации, или обработка из типового справочника «Внешние обработки».
Для 1С81 предусмотрено выполнение в новом приложении - чтобы можно было использовать код, доступный только на клиенте, в том числе и использование внешних обработок. Для этого нужно установить галочку «Выполнять через приложение 1С». Иначе регламентное задание будет выполняться на сервере.
Рекомендую устанавливать пользователя в поле «Пользователь» у вновь созданного регламентного задания, чтобы задание выполнялось под определенными правами. Рекомендую такому пользователю давать полные права. У меня используется пользователь « robot ».
Расписание регламентного задания создается по гиперссылке «Расписание» из формы регламентного задания. Можно использовать обработку «Консоль регламентных заданий».
Наверное, ни одна серьезная конфигурация на 1С 8.3 или 8.2 не обойдется без использования регламентных и фоновых заданий. Они очень удобны, так как по четко заданному расписанию будут выполняться без вмешательства пользователя и программиста.
Например, вам нужно раз в сутки вам нужно совершать обмен данными с другой программой. Используя регламентные и фоновые задания, 1С сможет производить данные действия самостоятельно, например, в нерабочее время. Такой способ никак не повлияет на работу пользователей и поможет сэкономить время.
Для начала разберемся, что же они обозначают и в чем их отличие:
- Регламентное задание позволяет запускать на выполнение какие-либо конкретные действия по заранее настроенному расписанию.
- Фоновое задание – это объект, в котором содержатся выполняемые действия.
Предположим, что наша фирма что-нибудь продает и имеет собственный сайт, на котором расположены цены. Раз в сутки мы хотим их выгружать для поддержания актуальности.
Откройте конфигурацию и добавьте регламентное задание.
Настройка свойств
Рассмотрим самые важные параметры, которые необходимо заполнить в его свойствах.
- В поле «Имя метода » выбирается та процедура какого-то определенного общего модуля, которая будет непосредственно выполняться. В ней будут указаны все действия по выгрузке цен на наш сайт. Обратите внимания, что выполнение будет происходить на сервере. Это логично, ведь регламентные операции выполняются без участия пользователя.
- Регламентное задание можно отключать или включать по необходимости. Не нужно каждый раз править его расписание. Для этого в палитре свойств установите или снимите флаг «Использование ».
- Еще одной немаловажной является настройка, будет ли являться данное регламентное задание предопределенным , или нет. Предопределенные регламентные задания запускаются автоматически. Если данный признак не установлен, то вам будет нужно запускать их программно, либо воспользоваться обработкой «Консоль заданий» с ИТС.
- Так же вы можете указать количество повторов и интервал между ними при аварийном завершении. Под аварийным завершением подразумеваются те ситуации, когда задания не отработали по причине возникновения ошибки.
Настройка расписания
Завершающим шагом мы настроим расписание нашей выгрузки на сайт по соответствующей гиперссылке в палитре свойств.
Перед вами откроется типовая настройка расписания в 1С 8.3. Здесь нет ничего сложного. В рамках данного примера мы настроили запуск нашей выгрузки цен на сайт ежедневно с пяти до семи утра. В том случае, если регламентное задание не успеет отработать до 7:00, оно будет выполнено уже на следующий день.
Блокировка регламентных заданий
Запустите стандартную утилиту «Администрирование серверов 1С Предприятия» и откройте свойства той информационной базы, где вы создали регламентное задание (для клиент-серверных версий 1С).
В открывшемся окне (после ввода логина и пароля для доступа к ИБ) проверьте, чтобы не был установлен флаг на пункте «Блокировка регламентных заданий включена». Если вы столкнулись ситуацией, когда задание не отрабатывает, первым делом проверяйте эту настройку.
Таким же образом можно полностью отключить регламентные задания в 1С 8.3. Для отключения конкретных фоновых заданий можно воспользоваться встроенной в последние релизы обработкой «Консоль фоновых заданий».
Фоновые и регламентные задания в файловом режиме
В данном режиме настройку и запуск данных заданий намного труднее организовать. Чаще всего создается дополнительная учетная запись, сеанс которой всегда будет открыт.
Активация регламентных заданий в данном случае производится при использовании метода «ВыполнитьОбработкуЗаданий()».
Так же вы можете воспользоваться следующей конструкцией:
В качестве имени процедуры необходимо указать имя клиентской процедуры, которая должна будет выполниться. Интервал показывает, через сколько секунд будет произведено выполнение. Параметр «Однократно» не обязателен к заполнению. Он отражает, будет ли выполнена данная процедура однократно, либо несколько раз.
Отслеживание ошибок в фоновых заданиях
Посмотреть ход выполнения фоновых заданий, а так же наличие возможных ошибок можно в журнале регистрации. В фильтре установите отбор приложению «Фоновое задание» и при необходимости выберите интересующую важность, например, только «Ошибки».
В журнале регистрации будут показаны все записи, соответствующие вашему отбору с указанием комментария, по которому вы можете понять причину ошибки.
