Uso de la API de escenarios empresariales en Microsoft Graph (versión preliminar)
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:
- Planner proporciona las siguientes configuraciones:
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:
- Planner, con las siguientes entidades admitidas:
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 | Vea 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 |
| Creación, lectura, actualización y eliminación de 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.