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

Содержание

1. Разработка расширения

1.1. Задание команд расширения

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

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

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

1.2. Добавление в каталог расширений

Если в расширении конфигурации задана хотя бы одна команда расширения (см. выше), то при добавлении версии расширения в каталог расширений будет показано окно Мастер добавления - Команды. В нем нужно:

1. Нажать кнопку Добавить.
2. Выбрать команду расширения.
3. В добавленной строке таблицы установить флажок и задать расписание для регламентного задания. Это расписание будет использоваться по умолчанию

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

1.3. Форма свойств версии расширения

Если в расширении конфигурации задана хотя бы одна команда расширения, то в форме свойств версии расширения будет показана вкладка Команды, содержащая список команд расширения и расписания их выполнения:

2. Установка расширения в приложение абонента

2.1. Установка в личном кабинете

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

2.2. Установка в приложении абонента

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

3. Задание расписания для команд расширения

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

А если пользователь имеет административные права в приложении, то он может:

• щелкнуть мышью гиперссылку с описанием расписания выполнения команды и изменить это расписание;
• отменить выполнение команды расширения, сняв флажок в строке с названием команды.

4. Пример расширения, запускающего регламентное задание

В качестве примера приведено расширение конфигурации Демо: Регламентное задание, его можно скачать по ссылке, имя файла расширения com_1cfresh_scheduled_job.cfe.

Это расширение конфигурации запускает регламентное задание, периодически добавляющее в журнал регистрации запись типа Примечание c наименованием события Демо Регламентное задание и комментарием Задание выполнено.

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

См. также: