Uso de la API de escenarios empresariales en Microsoft Graph (versión preliminar)

  • Artículo

Importante

Las API de la versión /beta de Microsoft Graph están sujetas a cambios. No se admite el uso de estas API en aplicaciones de producción. Para determinar si una API está disponible en la versión 1.0, use el selector de Versión.

La API de escenarios empresariales permite la creación y administración de escenarios empresariales que configuran y administran la integración de datos en Microsoft Graph.

Estructura de un escenario empresarial

La entidad businessScenario representa un escenario empresarial. Un recurso businessScenario especifica información general sobre el escenario, las aplicaciones que usan ese escenario y configuraciones para las entidades que las aplicaciones pueden administrar para admitir el escenario. Las aplicaciones pueden identificar la instancia de businessScenario mediante la propiedad uniqueName mediante un formato de nombre de dominio inverso.

Entidades disponibles en escenarios empresariales

La API de escenarios empresariales está diseñada para permitir que los servicios de Microsoft Graph la amplíen para admitir escenarios específicos del servicio específicos de los clientes.

Actualmente, Planner ha ampliado la API. La API admite datos de escenarios personalizados para Planner en la entidad businessScenarioTask.

Nota:

¿Tiene un escenario que requiera incorporar datos personalizados como entidades a otro servicio de Microsoft 365? Sugiera la característica o vote por las solicitudes de características existentes.

Creación de un escenario empresarial

Las aplicaciones pueden crear escenarios empresariales mediante el permiso BusinessScenarioConfig.ReadWrite.OwnedBydelegado . La creación de un escenario empresarial requiere especificar un nombre para mostrar y un nombre único. El nombre único debe estar en el formato DNS inverso para evitar conflictos entre escenarios independientes. El formato DNS inverso toma el nombre de dominio que posee el creador del escenario y lo invierte. Por ejemplo, si un desarrollador propietario apps.contoso.com crea un escenario, el nombre único del escenario debe empezar por com.contoso.apps. A continuación, se pueden agregar más segmentos para diferenciar escenarios o grupos de escenarios; por ejemplo, com.contoso.apps.customerSupport.ticketManagement. El nombre único del escenario debe ser distinto de todos los demás escenarios implementados en un inquilino.

Para obtener más información, vea Crear negocioScenario.

Configuración de comportamientos para entidades

Cada servicio compatible con escenarios empresariales proporciona configuraciones en el escenario. Las aplicaciones deben tener el BusinessScenarioConfig.Read.OwnedBy permiso para poder acceder a estas configuraciones y el BusinessScenarioConfig.ReadWrite.OwnedBy permiso para poder cambiarlas. Cada configuración es específica del servicio. Para obtener más información, consulte los siguientes temas específicos del servicio:

Creación y administración de datos para un escenario empresarial

Cada servicio admitido a través de escenarios empresariales proporciona acceso a los datos dentro de un escenario. Las aplicaciones deben aparecer como propietarios en un escenario para trabajar con los datos del escenario. Las aplicaciones también necesitan tener el BusinessScenarioData.Read.OwnedBy permiso para poder leer los datos y el BusinessScenarioData.ReadWrite.OwnedBy permiso para poder crear nuevos datos o modificar los datos creados anteriormente. Para obtener más información, consulte los siguientes temas específicos del servicio:

Eliminación de un escenario empresarial

Las aplicaciones que poseen un escenario empresarial pueden eliminar el escenario si tienen el BusinessScenarioConfig.ReadWrite.OwnedBy permiso . Al eliminar el escenario, también se quitan todos los datos asociados al escenario.

Para obtener más información, consulte Eliminación de businessScenario.

Casos de uso comunes

Casos de uso Recursos de REST Consulte también
Creación, lectura, actualización y eliminación de escenarios empresariales businessScenario Métodos de negocioScenario
Configuración de escenarios empresariales para Planner plannerPlanConfigurationplannerTaskConfiguration Métodos de plannerPlanConfigurationMétodos de plannerTaskConfiguration
Crear, leer, actualizar y eliminar tareas de escenarios empresariales en Planner businessScenarioTask businessScenarioTask

Pasos siguientes

La API de escenarios empresariales permite a las aplicaciones modelar e integrar procesos profesionales reales con un servicio de Microsoft 365 a través de Microsoft Graph. Para obtener más información:

  • Explore en profundidad los métodos y las propiedades de los recursos más útiles para su escenario.
  • Pruebe la API en el Probador de Graph.