Utiliser l’API des scénarios métier dans Microsoft Graph (préversion)
Importante
Les API sous la version /beta dans Microsoft Graph sont susceptibles d’être modifiées. L’utilisation de ces API dans des applications de production n’est pas prise en charge. Pour déterminer si une API est disponible dans v1.0, utilisez le sélecteur Version .
L’API de scénarios métier permet de créer et de gérer des scénarios métier qui configurent et gèrent l’intégration des données dans Microsoft Graph.
Structure d’un scénario métier
Un scénario métier est représenté par l’entité businessScenario . Une ressource businessScenario spécifie des informations générales sur le scénario, les applications qui utilisent ce scénario et les configurations des entités que les applications peuvent gérer pour prendre en charge le scénario. Les applications peuvent identifier l’instance de businessScenario par la propriété uniqueName à l’aide d’un format de nom de domaine inverse.
Entités disponibles dans les scénarios métier
L’API de scénarios métier est conçue pour permettre aux services Microsoft Graph de l’étendre afin de prendre en charge des scénarios spécifiques aux services spécifiques aux clients.
Actuellement, le Planificateur a étendu l’API. L’API prend en charge les données de scénario personnalisées pour le Planificateur dans l’entité businessScenarioTask .
Remarque
Avez-vous un scénario qui nécessite l’apport de données personnalisées en tant qu’entités à un autre service Microsoft 365 ? Suggérer la fonctionnalité ou voter pour les demandes de fonctionnalités existantes.
Création d’un scénario métier
Les scénarios métier peuvent être créés par des applications à l’aide de l’autorisation BusinessScenarioConfig.ReadWrite.OwnedBydéléguée . La création d’un scénario métier nécessite la spécification d’un nom d’affichage et d’un nom unique. Le nom unique doit être au format DNS inversé pour éviter les conflits entre les scénarios indépendants. Le format DNS inversé prend le nom de domaine que le créateur du scénario possède et l’inverse. Par exemple, si un développeur propriétaire apps.contoso.com crée un scénario, le nom unique du scénario doit commencer par com.contoso.apps. Ensuite, d’autres segments peuvent être ajoutés pour différencier des scénarios ou des groupes de scénarios ; par exemple, com.contoso.apps.customerSupport.ticketManagement. Le nom unique du scénario doit être distinct de tous les autres scénarios déployés dans un locataire.
Pour plus d’informations, consultez Créer businessScenario.
Configuration des comportements pour les entités
Chaque service pris en charge par le biais de scénarios d’entreprise fournit des configurations dans le scénario. Les applications doivent avoir l’autorisation BusinessScenarioConfig.Read.OwnedBy d’accéder à ces configurations et l’autorisation BusinessScenarioConfig.ReadWrite.OwnedBy de pouvoir les modifier. Chaque configuration est spécifique pour le service. Pour plus d’informations, consultez les rubriques spécifiques au service suivantes :
- Le Planificateur fournit les configurations suivantes :
Création et gestion de données pour un scénario métier
Chaque service pris en charge par le biais de scénarios métier fournit l’accès aux données dans un scénario. Les applications doivent être répertoriées en tant que propriétaire dans un scénario pour utiliser les données du scénario. Les applications doivent également avoir l’autorisation BusinessScenarioData.Read.OwnedBy de lire les données et l’autorisation BusinessScenarioData.ReadWrite.OwnedBy de pouvoir créer des données ou de modifier des données créées précédemment. Pour plus d’informations, consultez les rubriques spécifiques au service suivantes :
- Planificateur, avec les entités prises en charge suivantes :
Suppression d’un scénario métier
Les applications qui possèdent un scénario métier peuvent supprimer le scénario si elles disposent de l’autorisation BusinessScenarioConfig.ReadWrite.OwnedBy . La suppression du scénario supprime également toutes les données associées au scénario.
Pour plus d’informations, consultez Supprimer businessScenario.
Cas d’utilisation courants
| Cas d'utilisation | Ressources REST | Voir aussi |
|---|---|---|
| Créer, lire, mettre à jour et supprimer des scénarios métier | businessScenario | Méthodes de businessScenario |
| Configurer des scénarios métier pour le Planificateur | plannerPlanConfigurationplannerTaskConfiguration | Méthodes de plannerPlanConfigurationMéthodes de plannerTaskConfiguration |
| Créer, lire, mettre à jour et supprimer des tâches de scénario métier dans le Planificateur | businessScenarioTask | businessScenarioTask |
Étapes suivantes
L’API de scénarios métier permet aux applications de modéliser et d’intégrer des processus métier réels avec un service Microsoft 365 sur Microsoft Graph. Pour en savoir plus :
- En accédant aux données détaillées des méthodes et des propriétés des ressources les plus utiles pour votre cas.
- Essayez l’API dans l’Afficheur Graph.