SetSchedulerResult SetScheduler(SchedulerId tScheduler, SetSchedulerArg tArg)
tScheduler. Моникёр экземпляра контейнера запланированных задач.
tArg. Параметры изменения метаданных контейнера.
Операция SetScheduler изменяет метаданные контейнера запланированных задач.
Данная операция позволяет выполнить следующее:
Изменить параметры задач;
Изменить список задач (удалить существующие, создать новые);
Запустить выбранные задачи и получить результат их выполнения;
Запустить на сервере планировщик задач, который будет выполнять задачи в соответствии с их параметрами периода выполнения.
Для выполнения задачи необходимо в параметре tScheduler указать моникёр экземпляра контейнера запланированных задач, а в параметре tArg указать параметры изменения. Моникёр может быть получен при выполнении операции OpenScheduler. В поле tArg.pattern указывается шаблон, в соответствии с которым будут производиться изменения, а в поле tArg.meta обновленные метаданные задач. Все изменения будут сохранены автоматически.
Для запуска задач укажите в поле tArg.pattern.execTasks значение true. Для запуска планировщика задач укажите поля appState.running в шаблоне и в обновленных метаданных. Если определить поле tArg.refresh, то при выполнении операции будут обновлены настройки планировщика задач.
Результатом работы операции будут обновленные метаданные задач, если было определено поле tArg.metaGet. Также в поле execResults будут доступны результаты выполнения задач, если осуществлялся их запуск. Если осуществляется обновление планировщика задач, то результаты этого обновления будут доступны в поле refreshState.
Различные варианты использования операции приведены в следующих примерах:
Наименование примера |
См. также: