在Planner (预览版中配置任务规则)

  • 项目

Microsoft Graph 中的Planner API 支持规则，这些规则允许对任务执行和不能执行的操作进行自定义。 可以为从各种源创建的任务（例如 业务方案）指定任务规则。

任务属性规则由 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

指定是否可以更改任务 percentComplete 属性。 接受的值为：

  • block：无法更改 task percentComplete 属性。
  • setToComplete：满足完成要求后，可以将 task percentComplete 属性设置为 100 。
  • overrideRequirements：即使未满足完成要求，任务 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：允许所有窗体操作。