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

Свойства элемента проекта вида «ЗапланированноеЗадание»

В проекте запланированное задание имеет свойства, перечисленные ниже. Свойства задаются в среде разработки с помощью панели «Свойства».

ВидЭлемента​

Строка. Вид элемента проекта — ЗапланированноеЗадание.

Идентификатор​

Ууид. Уникальный идентификатор элемента проекта.

Имя​

Строка. Уникальный строковый идентификатор, который используется для формирования имени типа.

ОбластьВидимости​

Область видимости элемента проекта.

Описание​

Строка. Описание элемента.

ПредопределенноеЗадание​

Определяет создание/планирование задания на этапе обновления проекта:

  • НеСоздавать (значение по умолчанию) — задание не создается автоматически, но в коде можно создать задания по шаблону с помощью метода Создать();
  • ЗапланироватьПриОбновленииПроекта — задание создается и планируется при обновлении проекта;
  • СоздаватьПриостановленноеПриОбновленииПроекта — задание создается со значением статуса Приостановлено.

Параметры​

Массив<ПараметрРасписания>. Массив групп свойств, которые определяют параметры, доступные при выполнении запланированного задания. Параметр описывается такими свойствами, как Имя, Ид, Тип и ЗначениеПоУмолчанию. Значения параметров указываются при создании задания. Если у какого-либо параметра события не задано значение по умолчанию, то свойство ПредопределенноеЗадание этого задания может иметь только одно значение — НеСоздавать.

Пример описания параметров запланированного задания
ВидЭлемента: ЗапланированноеЗадание
Ид: 05c5640e-2c47-41c3-ae8e-6a7a38ff6128
Имя: МоеЗапланированноеЗадание
ОбластьВидимости: ВПодсистеме
Описание: Описание запланированного задания
Параметры:
    -
        Имя: Параметр1
        Ид: 184a3d27-dadf-472a-b7a3-e0148e09a1e1
        Тип: Число
    -
        Имя: Параметр2
        Ид: 785cb46c-2cb7-4162-b313-1cbe0ad64fed
        Тип: Строка

Расписание​

Массив<Расписание>. Массив групп свойств, определяющих расписание, по которому выполняется запланированное задание. Если для задания не задано расписание, то его свойство ПредопределенноеЗадание может иметь только одно значение — НеСоздавать.

Вид расписания может быть следующим:

Пример определения расписания
Расписание:
    -
        Вид: Ежемесячно
        ДниВМесяце:
            - 8
        ЗапуститьВ: 10:00
        Месяцы:
            - Март
    -
        Вид: Ежемесячно
        ДниВМесяце:
            - 23
        ЗапуститьВ: 10:00
        Месяцы:
            - Февраль

ПовторыПриУспехе​

СтратегияПовтораЗадания. Группа свойств, определяющих стратегию повторных запусков задания, если оно завершилось успешно.

Вид стратегии повтора может быть следующим:

  • Отсутствует (значение по умолчанию) — задание запускается один раз без повторов;
  • Инкремент — задание повторяется с интервалом, увеличивающимся на значение, указанное в параметре Инкремент, не более числа попыток, указанного в параметре Попытки. Первоначальное значение интервала между попытками указывается в параметре Интервал.
  • Интервал — задание запускается с интервалом, который увеличивается в несколько раз (значение указано в параметре Множитель), но не более числа попыток, указанного в параметре Попытки. Первоначальное значение интервала указывается в параметре Интервал. Максимальный интервал между попытками указывается в параметре МаксимальныйИнтервал.
Пример задания стратегии повтора задания при успехе
ПовторыПриУспехе:
    Вид: Интервал
    Интервал: 3мс
    МаксимальныйИнтервал: 500мс
    Множитель: 3
    Попытки: 3

ПовторыПриОшибке​

СтратегияПовтораЗадания. Группа свойств, определяющих стратегию повторных запусков задания, если оно завершилось с ошибкой. Виды стратегии и свойства аналогичны свойству ПовторыПриУспехе.

СтратегияПубликации​

СтратегияПубликацииЗадания. Определяет стратегию публикации запланированного задания.

ХранениеРезультатов​

СтратегияХраненияРезультатовЗаданий. Группа свойств, определяющих стратегию хранения результатов.

Вид стратегии хранения результатов может быть следующим:

  • Отсутствует (значение по умолчанию) — результат выполнения задания не хранится;
  • Все — хранятся все результаты выполнения задания;
  • Дней — результаты выполнения задания хранятся указанное число дней (число дней указывается в параметре Дней);
  • Последний — хранится только последний результат выполнения задания.

РегистрацияСобытий​

СтратегияРегистрацииСобытийЗаданий. Определяет стратегию регистрации событий в журнале событий.

УсловияЗапускаНаМобильныхУстройствах​

УсловияЗапускаНаМобильныхУстройствах. Группа свойств, определяющих условия, которые должны соблюдаться при запуске запланированного задания на мобильном устройстве.

Условия задаются следующими свойствами:

  • ПитаниеОтСети — флаг, указывающий на то, что задание должно запускаться при наличии подключенного зарядного устройства, потому что оно активно использует процессорное время или сеть передачи данных и может значительно разрядить аккумулятор.
  • ПродолжительноеВремяИсполнения — флаг, указывающий на то, что на выполнение задания требуется длительное время (более 30 секунд). В iOS влияет на параметры запуска приложения в фоне. В Android игнорируется.
  • СетевоеСоединение — флаг, указывающий на то, что для выполнения задания требуется соединение с сетью. Может использоваться как мобильная сеть передачи данных, так и Wi-Fi.
Последнее обновление