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

  • 项目

重要

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 能够更改这些配置的权限。 每个配置特定于服务。 有关详细信息，请参阅以下特定于服务的主题：

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

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

删除业务方案

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

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

常见用例

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

后续步骤

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

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