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

项目
07/04/2024

重要

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

业务方案 API 允许创建和管理业务方案，以配置和管理数据与 Microsoft Graph 的集成。

业务方案的结构

业务方案由 businessScenario 实体表示。 businessScenario 资源指定有关方案的常规信息、使用该方案的应用，以及应用可以管理以支持该方案的实体的配置。应用可以使用反向域名格式通过 uniqueName 属性来标识 businessScenario 的实例。

业务方案中可用的实体

业务方案 API 旨在允许 Microsoft Graph 服务对其进行扩展，以支持特定于客户的服务方案。

目前， Planner 已扩展 API。 API 支持 businessScenarioTask 实体中 Planner 的自定义方案数据。

注意

是否有需要将自定义数据作为实体引入另一个 Microsoft 365 服务的方案？建议功能或投票支持现有功能请求。

创建业务方案

应用程序可以使用委托的权限 BusinessScenarioConfig.ReadWrite.OwnedBy创建业务方案。创建业务方案需要指定显示名称和唯一名称。唯一名称应采用反向 DNS 格式，以防止独立方案之间的冲突。反向 DNS 格式采用方案创建者拥有的域名并将其反转。例如，如果拥有 apps.contoso.com 方案的开发人员创建方案，则方案的唯一名称应以 com.contoso.apps开头。然后，可以添加更多细分，以区分方案或方案组;例如。 com.contoso.apps.customerSupport.ticketManagement 方案的唯一名称必须与租户中部署的所有其他方案不同。

有关详细信息，请参阅创建 businessScenario。

为实体配置行为

业务方案支持的每个服务都提供方案中的配置。应用程序需要具有 BusinessScenarioConfig.Read.OwnedBy 能够访问这些配置的权限，以及 BusinessScenarioConfig.ReadWrite.OwnedBy 能够更改这些配置的权限。每个配置特定于服务。有关详细信息，请参阅以下特定于服务的主题：

Planner 提供以下配置：
- plannerPlanConfiguration
- plannerTaskConfiguration

为业务方案创建和管理数据

通过业务方案支持的每个服务都提供对方案内数据的访问。应用程序需要作为方案中的所有者列出才能处理方案中的数据。应用程序还需要具有 BusinessScenarioData.Read.OwnedBy 能够读取数据的权限，以及 BusinessScenarioData.ReadWrite.OwnedBy 能够创建新数据或修改以前创建的数据的权限。有关详细信息，请参阅以下特定于服务的主题：

Planner，具有以下受支持的实体：
- businessScenarioTask

删除业务方案

拥有业务方案的应用程序可以删除方案（如果它们具有权限 BusinessScenarioConfig.ReadWrite.OwnedBy ）。删除方案也会删除与方案关联的所有数据。

有关详细信息，请参阅 Delete businessScenario。

常见用例

用例	REST 资源	另请参阅
创建、读取、更新和删除业务方案	businessScenario	业务方法Scenario
为 Planner 配置业务方案	plannerPlanConfiguration plannerTaskConfiguration	plannerPlanConfiguration 方法 plannerTaskConfiguration
在 Planner 中创建、读取、更新和删除业务方案任务	businessScenarioTask	businessScenarioTask

后续步骤

业务方案 API 允许应用通过 Microsoft Graph 将实际工作业务流程与 Microsoft 365 服务进行建模和集成。若要了解详细信息：

深入了解对方案最有帮助的资源的方法和属性。
尝试在 Graph 浏览器中调用 API。

通过