Перейти к основному содержимому

ЗапланированныеЗадания

Стд::Задания::ЗапланированныеЗадания Тип-одиночка Доступность: Сервер

Позволяет создавать запланированные задания и управлять ими. Общее описание запланированных заданий - см. Стд::Задания.

Сравнение ссылочное

Иерархия типа​

Базовые типы: Объект, Одиночка

Методы​

Возобновить​

Доступность: Сервер

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

Примеры​

ЗапланированныеЗадания.Возобновить("МоеЗадание")

Изменить​

Доступность: Сервер

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

Примеры​

Запуск задания расписанием и изменением расписания.

знч Ключ = "ЗаданиеРассылкиСпама"

пер НовоеЗадание = ЗапланированныеЗадания.Создать(&МойМодуль.МойМетод)
НовоеЗадание.Настроить(Расписание = Расписание.Ежемесячно(Время{18:00}, {Месяц.Февраль}, {23}),
    Ключ = Ключ,
    Описание = "Рассылка праздничного спама")
НовоеЗадание.Запланировать()


знч ИзмЗадание = ЗапланированныеЗадания.Изменить(Ключ)
если ИзмЗадание == Неопределено
    выбросить новый ИсключениеВыполнения("Нет задания с ключом %{Ключ}")
;

ИзмЗадание.Настроить(Расписание = Расписание.Ежемесячно(Время{8:00}, {Месяц.Март}, {8}))
ИзмЗадание.Запланировать()

Отменить​

Доступность: Сервер

Отменить(Ключ: Строка)
Отменяет выполнение запланированного задания с ключом Ключ, если возможно. Для заданий с расписанием отменяется только текущее исполнение. Если задание уже исполняется в момент вызова, то исполнение прерывается. Метод выполняется синхронно, после его завершения задание отменено.

Исключения​

ИсключениеТаймаутаЗадания - в случае долгого прерывания исполнения задания. При возникновении исключения рекомендуется повторить операцию.

Примеры​

// Отмена задания с ключом "JobKey1", с повторными попытками в случае долгого прерывания существующего задания 
пер Попытка = 0
пока Попытка < 3
    попытка
        ЗапланированныеЗадания.Отменить("JobKey1")
        возврат
    поймать Искл: ИсключениеТаймаутаЗадания
        знч СобытиеЖурнала =
            новый ExecutionEvent(Details = "Таймаут попытки %{Попытка} изменения задания %{Искл.Presentation()}.")
        СобытиеЖурнала.Записать()
    ;

    Попытка = Попытка + 1
    Пауза(10s)
;

ПолучитьЗадания​

Доступность: Сервер

ПолучитьЗадания(): ЧитаемоеСоответствие<Строка, ОписаниеЗадания>
Возвращает соответствие, в котором в качестве ключа используется ключ задания, а в качестве значения - описание задания. В соответствии перечислены все задания, которые есть в приложении на момент вызова метода.

ПолучитьПоКлючу​

Доступность: Сервер

ПолучитьПоКлючу(Ключ: Строка): ОписаниеЗадания?
Возвращает описание задания с ключом Ключ. Если нет задания с таким ключом, возвращается Неопределено.

ПолучитьПоследнийРезультатПоКлючу​

Доступность: Сервер

ПолучитьПоследнийРезультатПоКлючу(Ключ: Строка): РезультатЗадания?
Возвращает последний результат задания с ключом Ключ. Если нет результата для задания с указанным ключом, возвращается Неопределено.

ПолучитьРезультатыПоИнтервалу​

Доступность: Сервер

ПолучитьРезультатыПоИнтервалу(
От: Момент? = Неопределено,
До: Момент? = Неопределено
): ЧитаемыйМассив<РезультатЗадания>
Возвращает результаты заданий по интервалу времени от От до До.

ПолучитьРезультатыПоКлючу​

Доступность: Сервер

ПолучитьРезультатыПоКлючу(Ключ: Строка): ЧитаемыйМассив<РезультатЗадания>
Возвращает результаты задания с ключом Ключ. Результаты задания возвращаются в обратном хронологическом порядке, т.е. последний по времени результат в первом элементе массива и т.д. Если нет результатов для задания с указанным ключом, возвращается пустой массив.

Приостановить​

Доступность: Сервер

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

Примеры​

ЗапланированныеЗадания.Приостановить("МоеЗадание")

Создать​

Доступность: Сервер

Создать(Обработчик: ()->ничто): СоздаваемоеЗапланированноеЗадание
Перегрузка:
Создать<Тип>(Обработчик: (Тип)->ничто, Параметр: Тип): СоздаваемоеЗапланированноеЗадание
Создать<Тип1, Тип2>(Обработчик: (Тип1, Тип2)->ничто, Параметр1: Тип1, Параметр2: Тип2): СоздаваемоеЗапланированноеЗадание
Создать<Тип1, Тип2, Тип3>(Обработчик: (Тип1, Тип2, Тип3)->ничто, Параметр1: Тип1, Параметр2: Тип2, Параметр3: Тип3): СоздаваемоеЗапланированноеЗадание
Создать<Тип1, Тип2, Тип3, Тип4>(Обработчик: (Тип1, Тип2, Тип3, Тип4)->ничто, Параметр1: Тип1, Параметр2: Тип2, Параметр3: Тип3, Параметр4: Тип4): СоздаваемоеЗапланированноеЗадание
Создать<Тип1, Тип2, Тип3, Тип4, Тип5>(Обработчик: (Тип1, Тип2, Тип3, Тип4, Тип5)->ничто, Параметр1: Тип1, Параметр2: Тип2, Параметр3: Тип3, Параметр4: Тип4, Параметр5: Тип5): СоздаваемоеЗапланированноеЗадание

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

Создать​

Доступность: Сервер

Создать<Тип>(
Обработчик: (Тип)->ничто,
Параметр: Тип
): СоздаваемоеЗапланированноеЗадание
Тип: Тип параметра

Перегрузка:
Создать(Обработчик: ()->ничто): СоздаваемоеЗапланированноеЗадание
Создать<Тип1, Тип2>(Обработчик: (Тип1, Тип2)->ничто, Параметр1: Тип1, Параметр2: Тип2): СоздаваемоеЗапланированноеЗадание
Создать<Тип1, Тип2, Тип3>(Обработчик: (Тип1, Тип2, Тип3)->ничто, Параметр1: Тип1, Параметр2: Тип2, Параметр3: Тип3): СоздаваемоеЗапланированноеЗадание
Создать<Тип1, Тип2, Тип3, Тип4>(Обработчик: (Тип1, Тип2, Тип3, Тип4)->ничто, Параметр1: Тип1, Параметр2: Тип2, Параметр3: Тип3, Параметр4: Тип4): СоздаваемоеЗапланированноеЗадание
Создать<Тип1, Тип2, Тип3, Тип4, Тип5>(Обработчик: (Тип1, Тип2, Тип3, Тип4, Тип5)->ничто, Параметр1: Тип1, Параметр2: Тип2, Параметр3: Тип3, Параметр4: Тип4, Параметр5: Тип5): СоздаваемоеЗапланированноеЗадание

Возвращает построитель задания, при помощи которого можно настроить опции выполнения задания и запланировать исполнение. Обработчик - Обработчик, который будет вызван для выполнения. Параметр - Параметр, передаваемый в обработчик.

Создать​

Доступность: Сервер

Создать<Тип1, Тип2>(
Обработчик: (Тип1, Тип2)->ничто,
Параметр1: Тип1,
Параметр2: Тип2
): СоздаваемоеЗапланированноеЗадание
Тип1: Тип параметра 1
Тип2: Тип параметра 2

Перегрузка:
Создать(Обработчик: ()->ничто): СоздаваемоеЗапланированноеЗадание
Создать<Тип>(Обработчик: (Тип)->ничто, Параметр: Тип): СоздаваемоеЗапланированноеЗадание
Создать<Тип1, Тип2, Тип3>(Обработчик: (Тип1, Тип2, Тип3)->ничто, Параметр1: Тип1, Параметр2: Тип2, Параметр3: Тип3): СоздаваемоеЗапланированноеЗадание
Создать<Тип1, Тип2, Тип3, Тип4>(Обработчик: (Тип1, Тип2, Тип3, Тип4)->ничто, Параметр1: Тип1, Параметр2: Тип2, Параметр3: Тип3, Параметр4: Тип4): СоздаваемоеЗапланированноеЗадание
Создать<Тип1, Тип2, Тип3, Тип4, Тип5>(Обработчик: (Тип1, Тип2, Тип3, Тип4, Тип5)->ничто, Параметр1: Тип1, Параметр2: Тип2, Параметр3: Тип3, Параметр4: Тип4, Параметр5: Тип5): СоздаваемоеЗапланированноеЗадание

Возвращает построитель задания, при помощи которого можно настроить опции выполнения задания и запланировать исполнение. Обработчик - Обработчик, который будет вызван для выполнения. Параметр1, Параметр2 - Параметры, передаваемые в обработчик.

Создать​

Доступность: Сервер

Создать<Тип1, Тип2, Тип3>(
Обработчик: (Тип1, Тип2, Тип3)->ничто,
Параметр1: Тип1,
Параметр2: Тип2,
Параметр3: Тип3
): СоздаваемоеЗапланированноеЗадание
Тип1: Тип параметра 1
Тип2: Тип параметра 2
Тип3: Тип параметра 3

Перегрузка:
Создать(Обработчик: ()->ничто): СоздаваемоеЗапланированноеЗадание
Создать<Тип>(Обработчик: (Тип)->ничто, Параметр: Тип): СоздаваемоеЗапланированноеЗадание
Создать<Тип1, Тип2>(Обработчик: (Тип1, Тип2)->ничто, Параметр1: Тип1, Параметр2: Тип2): СоздаваемоеЗапланированноеЗадание
Создать<Тип1, Тип2, Тип3, Тип4>(Обработчик: (Тип1, Тип2, Тип3, Тип4)->ничто, Параметр1: Тип1, Параметр2: Тип2, Параметр3: Тип3, Параметр4: Тип4): СоздаваемоеЗапланированноеЗадание
Создать<Тип1, Тип2, Тип3, Тип4, Тип5>(Обработчик: (Тип1, Тип2, Тип3, Тип4, Тип5)->ничто, Параметр1: Тип1, Параметр2: Тип2, Параметр3: Тип3, Параметр4: Тип4, Параметр5: Тип5): СоздаваемоеЗапланированноеЗадание

Возвращает построитель задания, при помощи которого можно настроить опции выполнения задания и запланировать исполнение. Обработчик - Обработчик, который будет вызван для выполнения. Параметр1, Параметр2, Параметр3 - Параметры, передаваемые в обработчик.

Создать​

Доступность: Сервер

Создать<Тип1, Тип2, Тип3, Тип4>(
Обработчик: (Тип1, Тип2, Тип3, Тип4)->ничто,
Параметр1: Тип1,
Параметр2: Тип2,
Параметр3: Тип3,
Параметр4: Тип4
): СоздаваемоеЗапланированноеЗадание
Тип1: Тип параметра 1
Тип2: Тип параметра 2
Тип3: Тип параметра 3
Тип4: Тип параметра 4

Перегрузка:
Создать(Обработчик: ()->ничто): СоздаваемоеЗапланированноеЗадание
Создать<Тип>(Обработчик: (Тип)->ничто, Параметр: Тип): СоздаваемоеЗапланированноеЗадание
Создать<Тип1, Тип2>(Обработчик: (Тип1, Тип2)->ничто, Параметр1: Тип1, Параметр2: Тип2): СоздаваемоеЗапланированноеЗадание
Создать<Тип1, Тип2, Тип3>(Обработчик: (Тип1, Тип2, Тип3)->ничто, Параметр1: Тип1, Параметр2: Тип2, Параметр3: Тип3): СоздаваемоеЗапланированноеЗадание
Создать<Тип1, Тип2, Тип3, Тип4, Тип5>(Обработчик: (Тип1, Тип2, Тип3, Тип4, Тип5)->ничто, Параметр1: Тип1, Параметр2: Тип2, Параметр3: Тип3, Параметр4: Тип4, Параметр5: Тип5): СоздаваемоеЗапланированноеЗадание

Возвращает построитель задания, при помощи которого можно настроить опции выполнения задания и запланировать исполнение. Обработчик - Обработчик, который будет вызван для выполнения. Параметр1, Параметр2, Параметр3, Параметр4 - Параметры, передаваемые в обработчик.

Создать​

Доступность: Сервер

Создать<Тип1, Тип2, Тип3, Тип4, Тип5>(
Обработчик: (Тип1, Тип2, Тип3, Тип4, Тип5)->ничто,
Параметр1: Тип1,
Параметр2: Тип2,
Параметр3: Тип3,
Параметр4: Тип4,
Параметр5: Тип5
): СоздаваемоеЗапланированноеЗадание
Тип1: Тип параметра 1
Тип2: Тип параметра 2
Тип3: Тип параметра 3
Тип4: Тип параметра 4
Тип5: Тип параметра 5

Перегрузка:
Создать(Обработчик: ()->ничто): СоздаваемоеЗапланированноеЗадание
Создать<Тип>(Обработчик: (Тип)->ничто, Параметр: Тип): СоздаваемоеЗапланированноеЗадание
Создать<Тип1, Тип2>(Обработчик: (Тип1, Тип2)->ничто, Параметр1: Тип1, Параметр2: Тип2): СоздаваемоеЗапланированноеЗадание
Создать<Тип1, Тип2, Тип3>(Обработчик: (Тип1, Тип2, Тип3)->ничто, Параметр1: Тип1, Параметр2: Тип2, Параметр3: Тип3): СоздаваемоеЗапланированноеЗадание
Создать<Тип1, Тип2, Тип3, Тип4>(Обработчик: (Тип1, Тип2, Тип3, Тип4)->ничто, Параметр1: Тип1, Параметр2: Тип2, Параметр3: Тип3, Параметр4: Тип4): СоздаваемоеЗапланированноеЗадание

Возвращает построитель задания, при помощи которого можно настроить опции выполнения задания и запланировать исполнение. Обработчик - Обработчик, который будет вызван для выполнения. Parameters1, Parameters2, Параметр3, Параметр4,Параметр5 - Параметры, передаваемые в обработчик. Ограничения на передаваемые типы параметров см. в Стд::Задания.

Примеры​

// Планирование задания, запускающего метод МойМетод модуля МойМодуль из подсистемы МояПодсистема

ЗапланированныеЗадания.Создать(&МояПодсистема::МойМодуль.МойМетод, "строка", 500)
    .Запланировать()

Удалить​

Доступность: Сервер

Удалить(Ключ: Строка)
Удаляет задание с ключом Ключ независимо от текущего состояния задания. Если задание выполняется в момент вызова метода, то выполнение прерывается. При попытке удалить системное запланированное задание выбрасывается исключение ИсключениеНедопустимыйАргумент. Метод выполняется синхронно, после его завершения задание удалено.

Исключения​

ИсключениеТаймаутаЗадания - в случае долгого прерывания исполнения задания. При возникновении исключения рекомендуется повторить операцию.

Список унаследованных методов​

Объект​

ВСтроку, ПолучитьТип, Представление

Последнее обновление