Какие основные свойства содержит регламентное задание
1. В общем случае, регламентные задания следует использовать, когда необходимо выполнить определенные периодические или однократные действия в соответствии с расписанием.
2. При этом если регламентные задания не требуется добавлять или удалять в зависимости от действий пользователя или логики конфигурации, следует использовать предопределенные регламентные задания. Такие задания автоматически создаются в информационной базе с тем расписанием и состоянием, которое было задано разработчиком в Конфигураторе. Примеры предопределенных регламентных заданий:
- загрузка курсов валют;
- извлечение текста для полнотекстового индексирования;
- обновление агрегатов.
3.1. Если выполнение регламентного задания зависит от включенных одной или нескольких функциональных опций (ФО), то необходимо программно управлять признаком предопределенного регламентного задания Использование в зависимости от установленных ФО. Иначе регламентное задание будет приводить к запуску сеанса, занимая вычислительные ресурсы сервера 1С:Предприятие.
Например, имеем регламентное задание ПолучениеИОтправкаЭлектронныхПисем (с установленным флажком Использование), которое должно выполняться только в том случае, если установлена ФО ИспользоватьПочтовыйКлиент.
Неправильно: создавать предопределенное регламентное задание, зависящее от ФО, с установленным флажком Использование.
Правильно: снять флажок Использование и управлять использованием регламентного задания в зависимости от включения/выключения функциональной опции.
Если в конфигурации используется подсистема «Регламентные задания» Библиотеки стандартых подсистем (БСП), то для такой настройки следует использовать процедуру ПриОпределенииНастроекРегламентныхЗаданий общего модуля РегламентныеЗаданияПереопределяемый. Например:
Настройка = Настройки.Добавить();
Настройка.РегламентноеЗадание = Метаданные.РегламентныеЗадания.ОбновлениеСтатусовДоставкиSMS;
Настройка.ФункциональнаяОпция = Метаданные.ФункциональныеОпции.ИспользоватьПочтовыйКлиент;
Настройка.ДоступноВМоделиСервиса = Ложь;
После чего в состав определяемого типа МестоХраненияФункциональныхОпций необходимо добавить константы, соответствующие функциональным опциям, используемым для управления регламентными заданиями.
Для конфигураций без БСП следует управлять использованием регламентного задания, разместив, например, в модуле менеджера значения константы ИспользоватьПочтовыйКлиент следующий код:
Процедура ПриЗаписи(Отказ)
Задание = РегламентныеЗадания.НайтиПредопределенное(Метаданные.РегламентныеЗадания.ПолучениеИОтправкаЭлектронныхПисем);
Если Задание.Использование <> Значение Тогда
Задание.Использование = Значение;
Задание.Записать();
КонецЕсли;
КонецПроцедуры
3.2. Дополнительно следует обезопасить выполнение регламентного задания, включенного через консоль или другим способом, минуя включение ФО, вставив в начало процедуры обработки регламентного задания следующий код:
ОбщегоНазначения.ПриНачалеВыполненияРегламентногоЗадания();
Если НЕ ПолучитьФункциональнуюОпцию(«ИспользоватьПочтовыйКлиент») Тогда
ВызватьИсключение НСтр(«ru = ‘Регламентное задание недоступно по функциональным опциям.'»);
КонецЕсли;
Если в конфигурации используется подсистема «Регламентные задания» БСП и настроены зависимости регламентных заданий от ФО (как указано в п.3.1), то вместо этого достаточно вставить вызов, как показано в п.6.
4.1. Если выполнение регламентного задания зависит от данных информационной базы, то флажок Предопределенное у регламентного задания следует отключать.
Например:
- обмен данными с другими информационными базами должен проводиться с каждой базой по индивидуальному расписанию;
- запуск каждой дополнительной обработки в базе требуется выполнять по отдельному расписанию.
В этих случаях требуется создавать экземпляры регламентных заданий и параметризовать их объектами ИБ (например, узлами ИБ, элементами справочника Дополнительные обработки и т.п.) из кода на встроенном языке с помощью метода РегламентныеЗадания.СоздатьРегламентноеЗадание. При этом в свойстве Наименование необходимо указывать представление объекта, на основании которого создается регламентное задание. Например, есть рассылка отчетов (элемент справочника), расписание, которое было настроено в карточке рассылки и ее автор, тогда добавление на основании нее регламентного задания будет выглядеть так:
// Снимаем ограничение, что только администратор может создавать регламентные задания.
УстановитьПривилегированныйРежим(Истина);
Задание = РегламентныеЗадания.СоздатьРегламентноеЗадание(Метаданные.РегламентныеЗадания.РассылкаОтчетов);
ПараметрыЗадания = Новый Массив;
ПараметрыЗадания.Добавить(РассылкаОтчетов);
Задание.Параметры = ПараметрыЗадания;
Задание.ИмяПользователя = АвторРассылки;
Задание.Использование = Истина;
Задание.Наименование = СтроковыеФункцииКлиентСервер.ПодставитьПараметрыВСтроку(НСтр(«ru = ‘Рассылка отчетов: %1′»), СокрЛП(РассылкаОтчетов);
Задание.Расписание = РасписаниеРассылки;
Задание.Записать();
4.2. Если в конфигурации используется подсистема «Регламентные задания» БСП, то необходимо также запрещать интерактивное создание и запуск параметризованных регламентных заданий из формы Регламентные и фоновые задания. Для этого необходимо указать такое задание в процедуре ПриОпределенииНастроекРегламентныхЗаданий общего модуля РегламентныеЗаданияПереопределяемый. Например:
Настройка = Настройки.Добавить();
Настройка.РегламентноеЗадание = Метаданные.РегламентныеЗадания.РассылкаОтчетов;
Настройка.Параметризуется = Истина;
Также выполнить п.6.
5. Во избежание различных конфликтных ситуаций рекомендуется в копиях информационной базы автоматически блокировать все регламентные задания, обращающиеся к внешним ресурсам (рассылка почты, синхронизация данных с другими программами и т.п.). Например, если копия информационной базы была развернута для тестирования или передана в службу технической поддержки.
Если в конфигурации используется подсистема «Регламентные задания» БСП, то для этого необходимо перечислить такие задания в процедуре ПриОпределенииНастроекРегламентныхЗаданий общего модуля РегламентныеЗаданияПереопределяемый. Например:
Настройка = Настройки.Добавить();
Настройка.РегламентноеЗадание = Метаданные.РегламентныеЗадания.РассылкаОтчетов;
Настройка.РаботаетСВнешнимиРесурсами = Истина;
И выполнить п.6.
В этом случае при перемещении информационной базы администратору будет задан вопрос об отключении таких заданий.
6. Если регламентное задание попадает под требования, описанные в пунктах 3.1, 4.2, 5 и используется подсистема «Регламентные задания» БСП, то вначале процедур обработчиков таких заданий необходимо помещать вызов:
ОбщегоНазначения.ПриНачалеВыполненияРегламентногоЗадания(Метаданные.РегламентныеЗадания.<ИмяЗадания>);
Первый параметр при этом заполнять обязательно.
Регламентные задания в 1С предназначены для выполнения определенных процедур по расписанию, с некоторой периодичностью.
Регламентные задания хранятся в информационной базе, имеют расписание запуска. Сам запуск производится полностью автоматически, если режим работы информационной базы клиент-серверный. Если же база файловая, то необходимо выполнить следующие действия:
- выделить специального пользователя для выполнения регламентных заданий;
- должна быть открыта база под этим пользователем, в которой периодически должна выполняться функция ВыполнитьОбработкуЗаданий().
Создание регламентного задания
Регламентные задания — объект метаданных конфигурации 1С. Находится в группе Общие. Рассмотрим параметры и свойства регламентных заданий.
Имя метода— путь к экспортной процедуре в общем модуле, которая будет выполняться по заданному расписанию. Процедура должна выполняться на сервере. В этом регламентные задания чем-то похожи на объект Подписка на событие.
Ключ — позволяет создать несколько регламентных заданий одного типа. Например, выполнение синхронизации данных между несколькими информационными базами может быть реализовано с помощью одного объекта метаданных РегламентноеЗадание, при этом самих регламентных заданий будет создано несколько (по количеству баз для обмена). Различаться эти регламентные задания будут с помощью свойства Ключ. Одновременно может выполняться только одно задание с одинаковым ключом.
Использование — флаг, показывающий, включено ли регламентное задание.
Предопределенное — здесь можно провести аналогию с предопределенными элементами справочника. Предопределенные элементы создаются в конфигураторе и применяются пользователями в работе. Обычные элементы пользователь создает сам. С регламентными заданиями точно так же: если оно предопределенное, то оно существует и может выполняться по расписанию сразу после создания в конфигураторе. Если же флаг Предопределенное не установлен, то пользователю нужно самому создать одно или несколько регламентных заданий данного типа (например, через Консоль заданий).
Количество повторов при аварийном завершении задания — определяет, сколько раз будет выполнен перезапуск фонового задания, если оно было завершено с ошибкой.
Интервал повтора при аварийном завершении задания — определяет, с какой периодичностью будет выполнен перезапуск фонового задания, если оно было завершено с ошибкой.
Программная работа с регламентными заданиями
В данных примерах будем рассматривать работу с обычными, не предопределенными, регламентными заданиями.
Программное создание регламентного задания
//Создаем задание
Задание = РегламентныеЗадания.СоздатьРегламентноеЗадание(«ИмяРегдаментногоЗадания»);
//Устанавливаем ключ регламентного задания (не обязательно)
Задание.Ключ = «КлючЗадания»;
//Включаем регламентное задание
Задание.Использование = Истина;
//Записываем регламентное задание
Задание.Записать();
Программное получение регламентного задания для изменения параметров
В этом примере предположим, что существует только одно регламентное задание данного типа. Если заданий несколько, то, зная методы работы с массивами, нетрудно внести в код соответствующие изменения.
//Получаем массив с регламентными заданиями нужного типа
Задания=РегламентныеЗадания.ПолучитьРегламентныеЗадания(новый Структура(«Метаданные», Метаданные.РегламентныеЗадания[«ИмяРегламентногоЗадания»]));
//Если задание существует, то по условию оно одно
Если Задания.Количество()>0 Тогда
Задание=Задания[0];
//Если задания нет, создадим его
Иначе
Задание = РегламентныеЗадания.СоздатьРегламентноеЗадание(«ИмяРегламентногоЗадания»);
КонецЕсли;
//Регламентное задание находится в переменной Задание. Можно изменять его параметры.
Вызов диалога изменения расписания регламентного задания
Для работы с расписанием регламентного задания существует особый тип диалога. Все еще предполагаем, что у нас есть только одно регламентное задание данного типа.
//Получаем массив с регламентными заданиями нужного типа
Задания=РегламентныеЗадания.ПолучитьРегламентныеЗадания(новый Структура(«Метаданные», Метаданные.РегламентныеЗадания[«ИмяРегламентногоЗадания»]));
//Если задание существует, то по условию оно одно
Если Задания.Количество()>0 Тогда
Задание=Задания[0];
//Если задания нет, создадим его
Иначе
Задание = РегламентныеЗадания.СоздатьРегламентноеЗадание(«ИмяРегламентногоЗадания»);
КонецЕсли;
Расписание=Задание.Расписание;
//Создаем диалог изменения расписания регламентного задания
ДиалогРедактирования= Новый ДиалогРасписанияРегламентногоЗадания (Расписание);
//Показываем диалог пользователю и обрабатываем изменения расписания
Если ДиалогРедактирования.ОткрытьМодально() Тогда
Задание.Расписание = ДиалогРедактирования.Расписание;
Задание.Записать();
КонецЕсли;
Регламентные задания 1СНекоторые задачи в документообороте и учете бывает необходимо выполнять периодически. Например, по двадцатым числам. Или ежедневно.
Обычно в компании стараются создать правила о выполнении таких задач – кто, когда и как должен выполнить задачу, кто проконтролировать.
Такие задачи называют – регламентированными, то есть выполняемые согласно регламента.
В ИТ часто регламентированно выполняется мониторинг.
Это хорошо знакомо системным администратором – есть специальные программы, которые периодически проверяют работоспособность серверов и сетевой инфрастуктуры и сообщают смс или электронным письмом администратору.
Аналогичные вещи существуют для вебмастеров – для проверки доступности сайта в течении суток.
В 1С задачи мониторинга и любые другие периодические задачи, которые должны выполняться автоматически по расписанию, выполняются с помощью механизма Регламентые задания 1С.
Поговорим сегодня про них.
Регламентные задания 1С
Регламентные задания 1С – это объект 1С, который позволяет выполнять обработчик не при наступлении события, как это делает подписка на событие, а по расписанию.
Само регламентное задание 1С в конфигураторе – это способ указать настройки и задать расписание. Кстати, расписание можно менять динамически потом в режиме 1С Предприятие.
Если используется файловая база данных, то задания не выполняются автоматически. Для этого нужно запустить один из сеансов 1С в режиме 1С Предприятие и в нем выполнить команду
ВыполнитьОбработкуЗаданий();
Во всех типовых конфигурациях предусмотрена настройка пользователя, которая позволяет указать, что при запуске 1С под этим пользователем автоматически будут выполняться регламентные задания 1С. С точки зрения пользователя Windows – задание будет выполнено под тем пользователем, под которым запущен клиент 1С на данном компьютере.
При использовании клиент-серверного варианта 1С задачи выполняются автоматически, на сервере. Само «регламентное задание» не «выполняется». При наступлении времени срабатывания — запускается фоновое задание, которое и выполняет задачу. Фоновое задание выполняется под пользователем Windows, под которым работает процесс программы сервера 1С.
Фоновые задания можно создавать из текста программы на языке 1С произвольно без регламентного задания 1С – для параллельных вычислений на сервере.
Выполнение регламентных заданий 1С можно отключить временно – в консоли управления сервером 1С.
Добавление регламентного задания 1С
Регламентные задания 1С находятся в конфигурации в ветке Общие/Регламентные задания 1С. Добавим новое регламентное задание 1С, укажем его имя.
В свойстве регламентного задания 1С Имя метода – указывается функция обработчик, также как и в подписках на событие. Функция будет находиться в общем модуле с установленной галочкой Сервер в свойствах, то есть модуль должен быть добавлен заранее.
Свойство регламентного задания 1С — Наименование задания – определяет название, под которым будет фигурировать задание в средствах управления заданиями.
Свойство регламентного задания 1С – Ключ – позволяет сгруппировать несколько разных регламентных заданий 1С. Одновременно может быть запущено только одно задание с одинаковым значением ключа. Само значение может быть произвольным. Пустое значение не учитывается при контроле (то есть считается не заполненным).
Свойство регламентного задания 1С – Предопределенное – определяет, что при запуске 1С Предприятия такое задание будет создано и в единственном экземпляре с указанными в конфигураторе расписанием. Не предопределенные задания появляются в момент наступления расписания программно.
В типовых конфигурациях, например Бухгалтерии редакции 2.0, такие регламентные задания 1С как Обновление конфигурации и Пересчет итогов – предопределенные, а такие как Обмен данными или Отложенные движения – не предопределенные.
Использование – включает задание (то есть оно будет выполняться только если галочка Использование установлена).
Повтор при аварийном завершении – как легко догадаться означает перезапуск задания, если оно не смогло выполниться успешно с первого раза – указывается сколько раз перезапускать и через сколько после аварийного завершения.
Управление регламентным заданием 1С и мониторинг
Для управления регламентными заданиями 1С существует специальная типовая обработка Консоль заданий. Ее можно найти в том числе на дисках ИТС.
Эта обработка относится к так называемым универсальным внешним типовым обработкам 1С, которые часто не включаются в конфигурации, а распространяются отдельно, например, на дисках ИТС.
С помощью обработки консоль заданий можно:
- Включить/выключить выполнение регламентного задания 1С
- Назначить/изменить расписание регламентного задания 1С (да и другие параметры)
- Указать пользователя 1С, от имени которого будет выполнена регламентное задание 1С
- Посмотреть — какие задачи когда были выполнены и с каким результатом, ошибки выполнения заданий 1С
- Выполнить задание.
Копии баз данных и регламентные задания 1С
Если используется серверная 1С, то бывает следующая ситуация:
- В своих целях (например, для программирования) делается копия рабочей базы
- В копии базы работается, тестируется и так далее
- Забывается выключить регламентные задания 1С в такой тестовой базе.
Пока регламентные задания 1С выполняют задачи, связанные только со своей информационной базой, то ничего в этом нет.
Однако частенько регламентные задания 1С могут сохранять какие-либо файлы, данные в другие базы, проводить обмен, высылать электронные письма.
В этом случае может получится интересная смесь между результатом выполнения регламентных заданий 1С в рабочей базе и копиях.
Регламентные задачи 1С для в копиях рабочей базы нужно отключать в консоли управления сервером.
Выполнение и невыполнение регламентных задач 1С
При создании регламентных заданий 1С необходимо помнить:
- Задачи выполняются сами собой – их необходимо мониторить
- Задачи выполняются в модуле на сервере
- Задачи выполняются под другим пользователем Windows, под другими правами.
Во-первых нужно проверить, что задача выполняется и может быть выполнена как регламентное задание 1С.
Во-вторых серверный модуль значит, что недоступны многие вещи, которые доступны на клиенте. Например, иногда, не все документы могут быть проведены только на сервере, так как в их алгоритме может быть предусмотрено, что проведение запускается пользователем вручную и могут быть использованы не серверные функции, например
Предупреждение(«Привет!»)
В-третьих, если задача имеет дело с чем-то вне базы 1С, то важное значение приобретают права пользователя Windows, под которым выполняется задание.
Особенно важен при разработке третий пункт. Если модуль не может быть выполнен на сервере – задание не будет выполняться в принципе. Для проверки нужно хотя бы раз запустить задание и посмотреть результат «Задание выполнено» в обработке Консоль заданий.
Некоторые задачи в документообороте и учете бывает необходимо выполнять периодически. Например, по двадцатым числам. Или ежедневно.
Обычно в компании стараются создать правила о выполнении таких задач – кто, когда и как должен выполнить задачу, кто проконтролировать.
Такие задачи называют – регламентированными, то есть выполняемые согласно регламента.
В ИТ часто регламентированно выполняется мониторинг.
Это хорошо знакомо системным администратором – есть специальные программы, которые периодически проверяют работоспособность серверов и сетевой инфрастуктуры и сообщают смс или электронным письмом администратору.
Аналогичные вещи существуют для вебмастеров – для проверки доступности сайта в течении суток.
В 1С задачи мониторинга и любые другие периодические задачи, которые должны выполняться автоматически по расписанию, выполняются с помощью механизма Регламентые задания 1С.
Поговорим сегодня про них.
Регламентные задания 1С
Регламентные задания 1С – это объект 1С, который позволяет выполнять обработчик не при наступлении события, как это делает подписка на событие, а по расписанию.
Само регламентное задание 1С в конфигураторе – это способ указать настройки и задать расписание. Кстати, расписание можно менять динамически потом в режиме 1С Предприятие.
Если используется файловая база данных, то задания не выполняются автоматически. Для этого нужно запустить один из сеансов 1С в режиме 1С Предприятие и в нем выполнить команду
ВыполнитьОбработкуЗаданий();
Во всех типовых конфигурациях предусмотрена настройка пользователя, которая позволяет указать, что при запуске 1С под этим пользователем автоматически будут выполняться регламентные задания 1С. С точки зрения пользователя Windows – задание будет выполнено под тем пользователем, под которым запущен клиент 1С на данном компьютере.
При использовании клиент-серверного варианта 1С задачи выполняются автоматически, на сервере. Само «регламентное задание» не «выполняется». При наступлении времени срабатывания — запускается фоновое задание, которое и выполняет задачу. Фоновое задание выполняется под пользователем Windows, под которым работает процесс программы сервера 1С.
Фоновые задания можно создавать из текста программы на языке 1С произвольно без регламентного задания 1С – для параллельных вычислений на сервере.
Выполнение регламентных заданий 1С можно отключить временно – в консоли управления сервером 1С.
Добавление регламентного задания 1С
Регламентные задания 1С находятся в конфигурации в ветке Общие/Регламентные задания 1С. Добавим новое регламентное задание 1С, укажем его имя.
В свойстве регламентного задания 1С Имя метода – указывается функция обработчик, также как и в подписках на событие. Функция будет находиться в общем модуле с установленной галочкой Сервер в свойствах, то есть модуль должен быть добавлен заранее.
Свойство регламентного задания 1С — Наименование задания – определяет название, под которым будет фигурировать задание в средствах управления заданиями.
Свойство регламентного задания 1С – Ключ – позволяет сгруппировать несколько разных регламентных заданий 1С. Одновременно может быть запущено только одно задание с одинаковым значением ключа. Само значение может быть произвольным. Пустое значение не учитывается при контроле (то есть считается не заполненным).
Свойство регламентного задания 1С – Предопределенное – определяет, что при запуске 1С Предприятия такое задание будет создано и в единственном экземпляре с указанными в конфигураторе расписанием. Не предопределенные задания появляются в момент наступления расписания программно.
В типовых конфигурациях, например Бухгалтерии редакции 2.0, такие регламентные задания 1С как Обновление конфигурации и Пересчет итогов – предопределенные, а такие как Обмен данными или Отложенные движения – не предопределенные.
Использование – включает задание (то есть оно будет выполняться только если галочка Использование установлена).
Повтор при аварийном завершении – как легко догадаться означает перезапуск задания, если оно не смогло выполниться успешно с первого раза – указывается сколько раз перезапускать и через сколько после аварийного завершения.
Управление регламентным заданием 1С и мониторинг
Для управления регламентными заданиями 1С существует специальная типовая обработка Консоль заданий. Ее можно найти в том числе на дисках ИТС.
Эта обработка относится к так называемым универсальным внешним типовым обработкам 1С, которые часто не включаются в конфигурации, а распространяются отдельно, например, на дисках ИТС.
С помощью обработки консоль заданий можно:
- Включить/выключить выполнение регламентного задания 1С
- Назначить/изменить расписание регламентного задания 1С (да и другие параметры)
- Указать пользователя 1С, от имени которого будет выполнена регламентное задание 1С
- Посмотреть — какие задачи когда были выполнены и с каким результатом, ошибки выполнения заданий 1С
- Выполнить задание.
Копии баз данных и регламентные задания 1С
Если используется серверная 1С, то бывает следующая ситуация:
- В своих целях (например, для программирования) делается копия рабочей базы
- В копии базы работается, тестируется и так далее
- Забывается выключить регламентные задания 1С в такой тестовой базе.
Пока регламентные задания 1С выполняют задачи, связанные только со своей информационной базой, то ничего в этом нет.
Однако частенько регламентные задания 1С могут сохранять какие-либо файлы, данные в другие базы, проводить обмен, высылать электронные письма.
В этом случае может получится интересная смесь между результатом выполнения регламентных заданий 1С в рабочей базе и копиях.
Регламентные задачи 1С для в копиях рабочей базы нужно отключать в консоли управления сервером.
Выполнение и невыполнение регламентных задач 1С
При создании регламентных заданий 1С необходимо помнить:
- Задачи выполняются сами собой – их необходимо мониторить
- Задачи выполняются в модуле на сервере
- Задачи выполняются под другим пользователем Windows, под другими правами.
Во-первых нужно проверить, что задача выполняется и может быть выполнена как регламентное задание 1С.
Во-вторых серверный модуль значит, что недоступны многие вещи, которые доступны на клиенте. Например, иногда, не все документы могут быть проведены только на сервере, так как в их алгоритме может быть предусмотрено, что проведение запускается пользователем вручную и могут быть использованы не серверные функции, например
Предупреждение(«Привет!»)
В-третьих, если задача имеет дело с чем-то вне базы 1С, то важное значение приобретают права пользователя Windows, под которым выполняется задание.
Особенно важен при разработке третий пункт. Если модуль не может быть выполнен на сервере – задание не будет выполняться в принципе. Для проверки нужно хотя бы раз запустить задание и посмотреть результат «Задание выполнено» в обработке Консоль заданий.
Проголосовать за этот пост:
Загрузка…
Posted in Программирование 1С Tagged Объекты 1С