Partager via

Utiliser l’API des scénarios métier dans Microsoft Graph (préversion)

  • Article

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 :

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 :

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.