Настройка правил задач в Планировщик (предварительная версия)

  • Статья

API Планировщик в Microsoft Graph поддерживает правила, которые позволяют настраивать то, что можно и нельзя делать в задачах. Правила задач можно указать для задач, созданных из различных источников, таких как бизнес-сценарии.

Правила свойств задач представлены сущностью plannerTaskPropertyRule и описывают допустимые действия на уровне задачи и правила для каждого настраиваемого свойства.

В зависимости от конкретной записи правила указывают коллекцию значений или объект fieldRules . Правила полей указывают коллекцию значений по умолчанию и предоставляют отдельную коллекцию значений для условий переопределения. Для любой коллекции значений указанные значения являются допустимыми; Пропущенные значения не допускаются.

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

Настраиваемые действия

delete

Указывает, можно ли удалить задачу. Допустимые значения:

  • block: задача не может быть удалена.
  • allow: задача может быть удалена.

Коллекция должна содержать только одно из этих значений.

move

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

  • block: задача не может быть перемещена.
  • moveBetweenBuckets: задача может перемещаться только между сегментами плана, в который она входит.
  • moveBetweenPlans: задача может перемещаться между контейнерами и между планами, принадлежащими одному контейнеру.
  • allow: задача может перемещаться между контейнерами и между планами.

Коллекция должна содержать только одно из этих значений.

Заказ

Указывает, можно ли изменить порядок задачи в общих представлениях. Допустимые значения:

  • block: задача не может быть переупорядочена.
  • allow: задача может быть переупорядочена.

Коллекция должна содержать только одно из этих значений.

Настраиваемые свойства

appliedCategories

Свойство appliedCategories настраивается с помощью fieldRules, предоставляя значения по умолчанию и переопределения для определенных условий. Допустимые значения:

  • block: примененные категории нельзя изменить.
  • allow: категории можно добавлять или удалять.

Коллекция должна содержать только одно из этих значений.

Это свойство не поддерживает условия переопределения. Правила должны быть указаны в свойстве defaultRules .

assignments

Свойство assignments настраивается с помощью fieldRules, предоставляя значения по умолчанию и переопределения для определенных условий. Допустимые значения:

  • block: назначения задачи нельзя изменить.
  • addSelf: пользователи могут назначать задачу себе.
  • removeSelf: пользователи могут удалять себя в качестве назначенного.
  • addOther: пользователи могут назначать задачу другим пользователям.
  • removeOther: пользователи могут удалять назначенных пользователей, отличных от самих себя.
  • add: можно добавить назначаемых.
  • remove: назначаемого можно удалить.
  • allow: назначаемые могут быть добавлены или удалены.

Коллекция может указать одно allow значение или block любое сочетание других значений.

Это свойство поддерживает следующие условия переопределения. Если в переопределении не указаны правила, применяются значения, указанные для свойства defaultRules . Необходимо указать значение defaultRules .

  • userCreated: правила применяются, если назначение было создано пользователем.
  • applicationCreated: правила применяются, если назначение было создано с помощью разрешений приложения.

Контрольные списки

Свойство checkLists настраивается с помощью fieldRules, предоставляя значения по умолчанию и переопределения для определенных условий. Допустимые значения:

  • block: контрольный список не может быть изменен.
  • check: элементы контрольного списка можно проверять.
  • reorder: элементы контрольного списка можно изменить.
  • add: можно добавить новые элементы контрольного списка.
  • update: существующие элементы контрольного списка можно обновить.
  • remove: существующие элементы контрольного списка можно удалить.
  • allow: разрешены все действия контрольного списка.

Коллекция может указать одно allow значение или block любое сочетание других значений.

Это свойство поддерживает следующие условия переопределения. Если в переопределении не указаны правила, применяются значения, указанные для свойства defaultRules . Необходимо указать значение defaultRules .

  • userCreated: правила применяются, если элемент контрольного списка был создан пользователем.
  • applicationCreated: правила применяются, если элемент контрольного списка был создан с помощью разрешений приложения.

completionRequirements

Указывает, можно ли изменить свойство task completionRequirements . Допустимые значения:

  • block: свойство task completionRequirements не может быть изменено.
  • add: можно добавить новые требования к завершению.
  • edit: существующие требования к завершению можно изменить.
  • remove: существующие требования к завершению можно удалить.
  • allow: свойство task completionRequirements можно изменить.

Коллекция может указать одно allow значение или block любое сочетание других значений.

dueDate

Указывает, можно ли изменить дату выполнения задачи. Допустимые значения:

  • block: невозможно изменить дату выполнения задачи.
  • allow: дата выполнения задачи может быть изменена, добавлена или удалена.

Коллекция должна содержать только одно из этих значений.

notes

Указывает, можно ли изменять заметки о задачах. Допустимые значения:

  • block: заметки о задачах не могут быть изменены.
  • allow: заметки о задачах можно изменить.

Коллекция должна содержать только одно из этих значений.

percentComplete

Указывает, можно ли изменить свойство task percentComplete . Допустимые значения:

  • block: свойство task percentComplete не может быть изменено.
  • setToComplete: свойству task percentComplete можно присвоить значение 100 после выполнения требований к завершению.
  • overrideRequirements: свойству task percentComplete можно присвоить значение 100 , даже если требования к завершению не выполнены.
  • setToInProgress: свойству task percentComplete можно задать значения со 1 значением 99.
  • setToNotStarted: свойству task percentComplete можно присвоить значение 0.
  • allow: свойство task percentComplete можно изменить.

Коллекция может указать одно allow значение или block любое сочетание других значений.

previewType

Указывает, можно ли изменить тип предварительного просмотра задачи. Допустимые значения:

  • block: тип предварительного просмотра задачи нельзя изменить.
  • allow: тип предварительного просмотра задачи можно изменить.

Коллекция должна содержать только одно из этих значений.

priority

Указывает, можно ли изменить приоритет задачи. Допустимые значения:

  • block: приоритет задачи не может быть изменен.
  • allow: приоритет задачи можно изменить.

Коллекция должна содержать только одно из этих значений.

references

Свойствоreferences настраивается с помощью fieldRules, предоставляя значения по умолчанию и переопределения для определенных условий. Допустимые значения:

  • block: невозможно изменить ссылки на задачи.
  • add: можно добавить новые ссылки.
  • remove: существующие ссылки можно удалить.
  • allow: разрешены все действия ссылки на задачи.

Коллекция может указать одно allow значение или block любое сочетание других значений.

Это свойство поддерживает следующие условия переопределения. Если в переопределении не указаны правила, применяются значения, указанные для свойства defaultRules . Необходимо указать значение defaultRules .

  • userCreated: правила применяются, если ссылка на задачу была создана пользователем.
  • applicationCreated: правила применяются, если ссылка на задачу была создана с помощью разрешений приложения.

startDate

Указывает, можно ли изменить дату начала задачи. Допустимые значения:

  • block: невозможно изменить дату начала задачи.
  • allow: можно изменить дату начала задачи.

Коллекция должна содержать только одно из этих значений.

title

Указывает, можно ли изменить заголовок задачи. Допустимые значения:

  • block: заголовок задачи не может быть изменен.
  • allow: заголовок задачи можно изменить.

Коллекция должна содержать только одно из этих значений.

ApprovalAttachment

Свойство approvalAttachment настраивается с помощью fieldRules, предоставляя значения по умолчанию и переопределения для определенных условий. Допустимые значения:

  • block: утверждение не может быть изменено.
  • add: можно добавить новое утверждение.
  • remove: существующее утверждение можно удалить.
  • allow: разрешены все действия утверждения.

Формы

Свойство forms настраивается с помощью fieldRules, предоставляя значения по умолчанию и переопределения для определенных условий. Возможные значения:

  • block: Forms нельзя изменить.
  • addResponse: в форму можно добавить ответы.
  • add: можно добавить новые формы.
  • update: существующие формы можно обновить.
  • remove: существующие формы можно удалить.
  • allow: разрешены все действия форм.