Регламентные задания
Регламентные задания используются, когда необходимо выполнить определенные периодические или однократные действия в соответствии с расписанием.
Регламентные задания хранятся в информационной базе и создаются на основе метаданных регламентного задания, определенных в конфигурации. Метаданные задают такие параметры регламентного задания, как вызываемый метод, наименование, ключ, возможность использования, признак предопределенности и др. При создании регламентного задания дополнительно можно указать расписание (может быть указано в метаданных), значения параметров метода, имя пользователя, от имени которого должно выполняться регламентное задание, и др.
Создание и управление регламентными заданиями выполняются программно из любого соединения и разрешены только пользователям, имеющим административные права.
ПРИМЕЧАНИЕ. При работе в файловом варианте создавать и редактировать регламентные задания возможно без запуска планировщика заданий.
С регламентным заданием связан метод, который вызывается при выполнении регламентного задания. В качестве метода регламентного задания может выступать любая процедура или функция неглобального общего модуля, которую можно вызвать на сервере. Параметрами регламентного задания могут быть любые значения, которые разрешено передавать на сервер. Параметры регламентного задания должны в точности соответствовать параметрам той процедуры или функции, которую оно вызывает. Если методом регламентного задания является функция, то ее возвращаемое значение игнорируется.
Регламентное задание может иметь ключ – любое прикладное значение. Ключ вводит ограничение на запуск регламентных заданий, т. к. в единицу времени среди регламентных заданий, связанных с одним и тем же объектом метаданных, может выполняться только одно регламентное задание с определенным значением ключа. Ключ позволяет группировать регламентные задания, связанные с одним и тем же объектом метаданных, по определенному прикладному признаку с тем, чтобы в рамках одной группы выполнялось не более одного регламентного задания.
При конфигурировании можно определить предопределенные регламентные задания. Предопределенные регламентные задания ничем не отличаются от обычных регламентных заданий, за исключением того, что их нельзя явно создавать и удалять. Если в метаданных регламентного задания установлен признак предопределенного регламентного задания, то при обновлении конфигурации в информационной базе автоматически будет создано предопределенное регламентное задание. Если признак предопределенности снят, то при обновлении конфигурации в информационной базе автоматически будет удалено предопределенное регламентное задание. Начальные значения свойств предопределенного регламентного задания (например, расписание) устанавливаются в метаданных. В дальнейшем при работе приложения их можно менять. Предопределенные регламентные задания не имеют параметров.
Расписание регламентного задания определяет, в какие моменты времени регламентное задание должно быть запущено. Расписание позволяет:
Задавать дату и время начала и окончания выполнения задания;
Период выполнения;
Дни недели и месяцы, по которым нужно выполнять регламентное задание.
Примеры расписаний регламентных заданий:
Каждый час, только один день
Каждый день один раз в день
Один день, один раз
Через день один раз в день
Каждый час с 01.00 до 07.00 каждый день
Каждую субботу и воскресенье в 09.00
Каждый день одну неделю, неделя пропуска
В 01.00 один раз
Последнее число каждого месяца в 9.00
Пятое число каждого месяца в 9.00
Вторая среда каждого месяца в 9.00
Можно проверять, выполняется ли задание для заданной даты (метод ТребуетсяВыполнение() объекта РасписаниеРегламентныхЗаданий). Регламентные задания всегда выполняются от имени определенного пользователя. Если пользователь регламентного задания не указан, то выполнение происходит с правами, которые определяются набором ролей, указанных в свойстве конфигурации ОсновныеРоли. В том случае, если в этом свойстве не указано ни одной роли, выполнение происходит без ограничения прав доступа.
Выполнение регламентных заданий происходит с использованием фоновых заданий. Когда планировщик определяет, что регламентное задание должно быть запущено, то автоматически на основе данного регламентного задания создается фоновое задание, которое и выполняет всю дальнейшую обработку. Если данное регламентное задание уже выполняется, то оно не будет запущено повторно, вне зависимости от его расписания.
Регламентные задания имеют возможность перезапуска. Это особенно актуально, когда метод регламентного задания должен быть гарантированно выполнен. Перезапуск регламентного задания осуществляется в том случае, когда оно завершено аварийно, либо когда рабочий процесс (в клиент-серверном варианте) или клиентский процесс (в файловом варианте), на котором выполнялось регламентное задание, завершен аварийно. В регламентном задании можно указать, сколько раз нужно его перезапускать (свойство Количество повторов при аварийном завершении), а также интервал между перезапусками (свойство Интервал повтора при аварийном завершении). После выполнения заданного количества перезапусков, попытки запуска прекращаются до момента, когда наступит очередное время старта регламентного задания (в соответствии с расписанием). При этом счетчик количества повторов сбрасывается и при аварийном завершении регламентного задания, процесс перезапуска начинается сначала.
При реализации метода перезапускаемого регламентного задания нужно учитывать, что при перезапуске его выполнение будет начато с начала, а не продолжено с момента аварийного завершения.
Особенности выполнения фоновых заданий в файловом и клиент - серверном вариантах.
Механизмы выполнения фоновых заданий в файловом и клиент-серверном вариантах различаются.
Файловый вариант
Фоновые и регламентные задания выполняются клиентскими приложениями или расширением веб-сервера. Фоновые задания выполняются на том клиентском приложении, которое инициировало запуск фонового задания. Фоновые задания исполняются последовательно, т. е. на одном клиентском приложении не может одновременно выполняться два фоновых задания. В случае работы через веб-сервер, для каждой информационной базы, доступ к которой осуществляется через этот веб-сервер, организовано последовательное выполнение фоновых и регламентных заданий.
Поведение фоновых и регламентных заданий в файловом варианте имеет следующие особенности:
Информация о фоновых заданиях, вызванных с помощью методов языка или выполняющих отчеты, доступна только в том клиентском приложении, которое их выполняло. Информация не сохраняется после завершения работы клиентского приложения.
Информация о фоновых заданиях, инициированных регламентными заданиями, доступна на всех клиентских приложениях и сохраняется между запусками.
Регламентные задания выполняются только одним клиентским приложением. Имеется возможность запретить запуск регламентных заданий определенным клиентским приложением или указать, что какое-либо клиентское приложение принудительно назначается исполнителем регламентных заданий. Такое управление осуществляется с помощью:
Параметра командной строки /AllowExecuteScheduledJobs для толстого и тонкого клиентских приложений.
Атрибута allowexecutescheduledjobs элемента point файла публикации default.vrd в случае публикации информационной базы на веб-сервере.
Регламентные задания выполняются первым, по порядку запуска, клиентским приложением, у которого не указан запрет выполнения регламентных заданий. После завершения сеанса этого клиентского приложения, выполнение переходит к какому-либо из оставшихся запущенными клиентских приложений. Если запускается клиентское приложение с явным указанием на необходимость исполнения регламентных заданий, то регламентные задания начинают выполняться этим клиентским приложением, независимо от наличия других клиентских приложений (включая расширения веб-сервера).
Регламентные задания выполняются расширением веб-сервера до тех пор, пока расширение веб-сервера обслуживает хотя бы один клиентский сеанс.
Регламентные задания обрабатываются один раз в 60 секунд.
Клиент-серверный вариант
В клиент-серверном варианте для выполнения фоновых заданий используется планировщик заданий, который физически находится в менеджере кластера. Планировщик получает наименее загруженный рабочий процесс для всех поставленных в очередь на выполнение фоновых заданий и использует его для выполнения соответствующего фонового задания. Рабочий процесс выполняет задание и уведомляет планировщик о результатах выполнения.
В клиент-серверном варианте имеется возможность блокирования выполнения регламентных заданий. Блокирование выполнения регламентных заданий происходит в следующих случаях:
На информационную базу установлена явная блокировка регламентных заданий. Блокировка может быть установлена через консоль кластера.
На информационную базу установлена блокировка начала сеансов. Блокировка может быть установлена через консоль кластера.
Из встроенного языка вызван метод УстановитьМонопольныйРежим() с параметром Истина.
В некоторых других случаях (например, при обновлении конфигурации базы данных).
Создание метаданных регламентного задания
Перед тем как программно создать регламентное задание в информационной базе, необходимо создать для него объект метаданных.
Для создания объекта метаданных регламентного задания в ветке Общие дерева конфигурации для ветки регламентные задания нужно выполнить команду «Добавить».
Регламентное задание обладает рядом свойств, которые описаны ниже.
Имя метода – указывается имя метода регламентного задания.
Ключ – указывается произвольное строковое значение, которое будет использовано в качестве ключа регламентного задания.
Расписание – указывается расписание регламентного задания. Для формирования расписания следует перейти по ссылке Открыть и в открывшейся форме расписания установить нужные значения.
На закладке Общее указывается дата начала и завершения задания и режим повтора.
Рисунок 27. Общее расписание
На закладке Дневное указывается дневное расписание задания.
Рисунок 28. Дневное расписание
В расписании можно указать:
Время начала и окончания задания;
Время завершения задания, после которого оно будет принудительно завершено;
Период повтора задания;
Продолжительность паузы между повторами;
Продолжительность выполнения.
Допускается указание произвольного сочетания условий.
Рисунок 29. Недельное расписание
На закладке Недельное указывается недельное расписание задания.
Нужно установить флажки по тем дням недели, по которым задание будет выполняться. Если требуется повторять задание, указать интервал повтора в неделях. Например, задание выполняется через 2 недели, значение повтора – 2.
На закладке Месячное указывается месячное расписание задания.
Рисунок 30. Месячное расписание
Нужно установить флажки по тем месяцам, в которых задание будет выполняться. При необходимости можно указать конкретный день (месяца или недели) выполнения с начала месяца/недели или конца.
Использование – если установлено, то задание будет выполняться согласно расписанию.
Предопределенное – если установлено, то задание является предопределенным.
Количество повторов при аварийном завершении – указывает количество повторов при аварийном завершении.
Интервал повтора при аварийном завершении – указывает интервал повтора при аварийном завершении.
|
