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

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: формы не могут быть изменены.
• addResponse: в форму можно добавить ответы.
• add: можно добавить новые формы.
• update: существующие формы можно обновить.
• remove: существующие формы можно удалить.
• allow: разрешены все действия форм.