使用 Microsoft Graph 中的业务方案 API 与Planner (预览版) 集成

重要

Microsoft Graph /beta 版本下的 API 可能会发生更改。 不支持在生产应用程序中使用这些 API。 若要确定 API 是否在 v1.0 中可用，请使用 版本 选择器。

业务方案 API 允许在指定的目标中使用方案控制策略创建Planner任务。

Planner配置

应用在使用业务方案 API 时，可以通过两种方式配置Planner实体。 下面列出了支持的方法：

• 定义为托管方案任务而创建的计划的元素的计划配置
• 用于控制用户和应用程序所创建任务的行为方式的任务配置

计划配置

计划配置由 plannerPlanConfiguration 实体表示。 在计划配置中，应用程序可以配置计划中出现的存储桶、这些存储桶的顺序以及计划的标题和存储桶的名称。 每个存储桶由外部 ID 标识，可在创建或更新任务时使用该 ID 将它们放入正确的存储桶中。 在计划配置中配置的存储桶未指定任何要使用的名称，而此信息是本地化名称的一部分。 计划配置还指定计划和存储桶的本地化名称以及默认语言代码。 目前，创建的项使用默认语言。

任务配置

任务配置由 plannerTaskConfiguration 实体表示。 在任务配置中，应用程序可以配置策略，以限制对使用方案托管任务的应用程序和用户的访问。 策略按 角色分组。 每个角色标识一组调用方，每个组可以为其指定不同的规则。 将按以下顺序选取适用于特定调用的规则。 当请求修改任务时，仅应用第一个指定的规则。

• taskAssignees：如果目标任务分配给进行调用的用户，则适用。
• groupOwners：如果进行调用的用户是目标任务计划所属的容器的所有者，则适用。
• groupMembers：如果进行调用的用户是任务计划所属的容器的成员，则适用。
• applications：如果调用方是应用程序权限，则适用，因此调用不与用户关联。
• defaultRules：当其他条件都不匹配时适用。

注意： 这些规则限制调用方可以执行的操作，但它们不能允许调用方执行他们本来不允许执行的操作。

每个角色指定默认规则，以及针对任务的特定操作和字段的规则。 默认规则必须是 allow 或 block。 如果操作或字段没有为其定义规则，则默认规则用于使其不受 限制 allow或阻止用于 block。 请记住，当新属性和操作可供配置，但方案配置尚未更新以指定这些属性和操作的规则时，这适用。

有关如何使用规则的详细信息，请参阅在 Planner 中配置任务规则。

如何确定任务的目标

创建的任务在创建时根据指定的目标放置在计划中。 在当前版本中，可将 组 作为目标。 任务放置在与该组中的方案关联的 计划中 。 如果组没有方案计划，则会根据计划配置创建新计划。

任务元数据和行为

作为任务的一部分， 方案属性 是必需的。 这些属性包括任务的外部 ID，需要为每个任务指定该 ID。 此值在租户中必须是唯一的。 如果创建具有相同外部 ID 的第二个任务，则会在不进行任何修改的情况下返回第一个任务。 使用任务时，还可以将外部 ID 用作备用键。 此外，还可以为每个任务指定上下文 ID。 此值可用于查询具有相同上下文 ID 的任务，使应用程序能够跨计划对任务进行分组。