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

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

graph TD;
ЗапланированныеЗадания["ЗапланированныеЗадания"]-->Объект["Объект"];

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

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

Методы

Возобновить

Возобновить(Ключ: Строка): ОписаниеЗадания?

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

Примеры

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

Изменить

Изменить(Ключ: Строка): ИзменяемоеЗапланированноеЗадание?

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

Примеры

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

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

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


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

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

Отменить

Отменить(Ключ: Строка)

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

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

ПолучитьЗадания(): ЧитаемоеСоответствие<Строка, ОписаниеЗадания>

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

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

ПолучитьПоКлючу(Ключ: Строка): ОписаниеЗадания?

Возвращает дескриптор задания с ключом Ключ. Если нет задания с таким ключом, возвращается Неопределено.

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

ПолучитьПоследнийРезультатПоКлючу(Ключ: Строка): РезультатЗадания?

Возвращает последний результат задания с ключом Ключ. Если нет результата для задания с указанным ключом, возвращается Неопределено.

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

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

Возвращает результаты заданий по интервалу времени от От до До.

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

ПолучитьРезультатыПоКлючу(Ключ: Строка): ЧитаемыйМассив<РезультатЗадания>

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

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

Приостановить(Ключ: Строка): ОписаниеЗадания?

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

Примеры

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

Создать

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

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

Создать

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

• Тип - Тип параметра

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

Создать

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

• Тип1 - Тип параметра 1
• Тип2 - Тип параметра 2

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

Создать

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

• Тип1 - Тип параметра 1
• Тип2 - Тип параметра 2
• Тип3 - Тип параметра 3

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

Создать

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

• Тип1 - Тип параметра 1
• Тип2 - Тип параметра 2
• Тип3 - Тип параметра 3
• Тип4 - Тип параметра 4

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

Создать

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

• Тип1 - Тип параметра 1
• Тип2 - Тип параметра 2
• Тип3 - Тип параметра 3
• Тип4 - Тип параметра 4
• Тип5 - Тип параметра 5

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

Примеры

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

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

Удалить

Удалить(Ключ: Строка)

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

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

Объект