Intégration Azure

Les applications Microsoft Dataverse prennent en charge l’intégration avec Azure. Les développeurs peuvent inscrire les plug-ins avec Dataverse qui peut passer les données de message du runtime, intitulées contexte d’exécution, à une ou plusieurs solutions Azure du cloud. Cette capacité est particulièrement importante car Azure est l’une des rares solutions prises en charge pour communiquer le contexte d’exécution aux applications métier externes (LOB).

Azure Service Bus fournit un canal sécurisé et fiable pour la communication entre les données d’exécution de Dataverse et les applications métier externes basées sur le cloud. Cette fonction est particulièrement utile, car elle maintient les systèmes Dataverse ou autres serveurs Dataverse séparés synchronisés avec les modifications de données métier .

Éléments clés de la connexion

Les éléments clés qui implémentent la connexion entre Dataverse et Azure Service Bus sont décrits ultérieurement. Un schéma dans la section suivante illustre ces éléments en opération.

Contexte de données

Le contexte des données contient les données commerciales traitées dans le cadre de l’opération actuelle de Dataverse. Ce traitement a été initié lorsqu’une demande d’exécution d’une certaine opération a été effectuée par un utilisateur, un flux de travail ou une application. Dataverse Le contexte de données est transmis à toutes les activités plug-ins ou de workflow personnalisé enregistrées avec le pipeline d’événements à exécuter sur la combinaison de demande et de table spécifique en cours de traitement. Le contexte de données est de type IPluginExecutionContext lorsqu’il est transmis le long du pipeline d’exécution de l’événement et RemoteExecutionContext lorsqu’il est publié sur le bus de service.

Le contexte des données propre au message qui est publié sur Azure Service Bus peut être mis au format XML ou JSON, en plus du format binaire .NET par défaut. La prise en charge de ces formats de données permet une interopérabilité multiplateforme où les clients non-.NET hébergés par Azure peuvent lire les données à partir du bus de service. Dataverse

Important

Lorsque la taille de la charge HTTP entière dépasse 192 Ko, les propriétés suivantes sont supprimées :

ParentContext, InputParameters, PreEntityImages, PostEntityImages

Certaines opérations ne comprennent pas ces propriétés.

• Si la taille de la charge est inférieure à 192 Ko une fois les informations supplémentaires supprimées, une propriété MessageMaxSizeExceeded supplémentaire est ajouté au BrokeredMessage adressé par le système. Cela indique que certaines données ont été tronquées.
• Si la taille de la charge dépasse 192 Ko une fois les informations supplémentaires supprimées, une erreur se produit et le message n’est pas envoyé.

Pour obtenir des informations complémentaires sur les technologies décrites précédemment, consultez :

• Pipeline d’exécution des événements
• Écrire une application d’écoute pour une solution Microsoft Azure.

Plug-ins

Les plug-ins sont l’une des deux méthodes utilisées pour initier la publication du message contenant le contexte des données vers Azure Service Bus ; l’autre méthode étant une activité de workflow personnalisée. Il existe deux types de plug-ins inscrits asynchrones pris en charge par la fonctionnalité de connexion Dataverse-Azure : prêt à l’emploi et personnalisé. Dans les deux cas, il est recommandé d’enregistrer le plug-in pour qu’il s’exécute de manière asynchrone afin d’obtenir de meilleures performances système.

Un plug-in par défaut compatible Azure (OOB) est disponible et peut être enregistré avec Dataverse en enregistrant un service point de terminaison à l’aide de l’outil d’enregistrement de plug-in. Vous devez enregistrer une étape plug-in dans le pipeline d’exécution d’événement qui identifie la combinaison de message et de table qui déclenche le plug-in pour exécuter et effectuer une notification de publication. Une fois exécuté, le plug-in avertit le service asynchrone, via un service de notification de point de terminaison de service (IServiceEndpointNotificationService), pour publier le contexte actuel des données de requête sur Azure Service Bus.

Vous pouvez également écrire votre propre plug-in personnalisé, compatible Azure. Le plug-in personnalisé s’exécute dans le sandbox. Un plug-in personnalisé peut lancer la publication du contexte de données sur le bus de services via le service de notification de point de terminaison de service. Ajouter du code pour invoquer ce service rend le plug-in « compatible Azure ».

Pour plus d’informations sur les plug-ins en général, voir Écriture d’un plug-in. Pour plus d’informations sur les plug-ins compatibles Azure, consultez Écrire un plug-in compatible Azure personnalisé.

Activités de workflow personnalisées

À l’instar des plug-ins, des activités de workflow personnalisées peuvent être écrites pour initier la publication du contexte actuel des données de message de demande sur Azure Service Bus à l’aide du service de notification de point de terminaison de service. Pour plus d’informations : Extensions de workflow

Service asynchrone

Une fois averti par le service de notification du point de terminaison de service, le service asynchrone gère la publication du contexte de données du message de demande actuellement traité par le pipeline d’exécution d’événements sur Azure Service Bus. Chaque publication est effectuée par une tâche système du service asynchrone. Un utilisateur peut afficher le statut de chaque tâche système à l’aide de la vue Tâches système de l’application web Power Apps. Dans l’application Web, choisissez Paramètres avancés pour afficher l’interface Dynamics 365 héritée. Ensuite, Sélectionner Paramètres > Tâches système.

Pour plus d’informations sur le service asynchrone, voir Service asynchrone.

Bus de services Microsoft Azure

Le bus de services transmet par relais le contexte de données de message de demande entre les applications d’écoute de solution Dataverse et Azure Service Bus. Le bus de service assure également la sécurité des données afin que seules les applications autorisées puissent accéder aux données publiées. Dataverse L’autorisation de publier le contexte de données sur le bus de service et de permettre aux applications d’écoute de le lire est gérée par Azure Shared Access Signatures (SAS). Dataverse

Pour plus d’informations sur le bus de services, consultez Service Bus. Pour plus d’informations sur l’autorisation du bus de services, consultez Authentification et autorisation du bus de services.

Solution Microsoft Azure

Pour que la connexion de Dataverse et d’Azure fonctionne, au moins une solution est nécessaire dans un compte de solution Azure Service Bus, où la solution contient un ou plusieurs points de terminaison de service. Pour un contrat du point de terminaison de relais, une application d’écouteur compatible Dataverse doit écouter activement sur le point de terminaison la demande Dataverse sur le Service Bus. Pour un contrat de point de terminaison de file d’attente, il n’est pas nécessaire qu’un écouteur écoute activement. Un écouteur est rendu compatible Dataverse en l’associant à l’assembly Microsoft.Xrm.Sdk de sorte que le type RemoteExecutionContext soit défini. Pour plus d’informations : Écrire un écouteur pour une solution Microsoft Azure

Dataverse prend en charge l’envoi des données d’événement à une solution Azure Event Hubs. Pour plus d’informations sur Event Hubs, consultez Utiliser les données d’événement dans votre solution Azure Event Hubs.

Scénario Dataverse vers Service Bus

Identifions maintenant un scénario qui implémente les composants de connexion mentionnés précédemment. Comme conditions préalables, l’SAS a été configuré pour identifier Dataverse comme l’émetteur pris en charge et la solution du bus des services Azure a été configurée avec des règles visant à permettre à Dataverse de publier sur le point de terminaison sur lequel l’écouteur écoute.

Le diagramme suivant illustre les éléments physiques qui composent le scénario.

La séquence des événements identifiés dans ce diagramme est la suivante :

1. Une application d’écoute est enregistrée sur une solution Azure Service Bus point de terminaison et commence à écouter activement le contexte d’exécution à distance sur le bus de service. Dataverse

2. Un utilisateur effectue une opération dans Dataverse qui déclenche l’exécution du plug-in prêt à l’emploi inscrit ou d’un plug-in compatible Azure personnalisé. Le plug-in lance une publication, via une tâche système de service asynchrone, du contexte de données de demande actuel sur le Service Bus.

3. Les revendications publiées par Dataverse sont authentifiées. Le Service Bus transmet par relais le contexte d’exécution distant à l’écouteur. L’écouteur traite les informations de contexte et effectue une tâche professionnelle avec ces informations. Le Service Bus notifie le bus des services asynchrone d’une publication réussie et attribue à la tâche système le statut Terminé.

Création d’un contrat entre Dataverse et une solution Azure

Pour chaque point de terminaison de solution, vous configurez un contrat qui définit la gestion de ces messages de contexte d’exécution distant sur le Service Bus et la sécurité qui doit être utilisée sur ce point de terminaison. Les messages du Service Bus sont reçus sur un point de terminaison via l’un des contrats pris en charge répertoriés ici.

File d’attente

Un contrat de file d’attente fournit une file d’attente de messages du cloud. Avec un contrat de file d’attente, l’écouteur n’est pas obligé d’écouter activement les messages sur le point de terminaison. Pour les files d’attente, il existe une lecture destructive et une lecture non destructive. Une lecture destructive lit un message disponible dans la file d’attente et le message est supprimé. Une lecture non destructive ne supprime pas un message de la file d’attente.

Le type de file d’attente pris en charge par Dataverse est appelé une file d’attente persistante. Les files d’attente persistantes ont une disponibilité des messages longue mais limitée, qui peut être spécifiée dans le code.

Contrat unidirectionnel

Un contrat unidirectionnel nécessite un écouteur actif. S’il n’y a pas d’auditeur actif sur un point de terminaison, la publication sur le Service Bus échoue. Dataverse réessaient d’effectuer la publication à des intervalles de temps augmentant exponentiellement jusqu’à ce que la tâche système asynchrone qui publie la demande soit abandonnée et que son statut passe à « Échec ».

Contrat bidirectionnel

Un contrat bidirectionnel est similaire à un contrat unidirectionnel à ceci près qu’une valeur de chaîne peut être retournée de l’écouteur à l’activité de workflow ou de plug-in Dataverse personnalisée à l’origine de la publication.

REST

Le contrat REST est similaire au contrat bidirectionnel sur un point de terminaison REST.

Sujet

Similaire à une file d’attente sauf qu’un ou plusieurs écouteurs peuvent s’abonner pour recevoir des messages du sujet.

Hubs d’événements

Ce type de contrat s’applique aux solutions Azure Event Hubs.

L’identification du type de sécurité utilisé par un contrat fait partie de la configuration du contrat. Un contrat peut utiliser la sécurité de transport, qui utilise Transport Layer Security (TLS) ou Secure Sockets Layer (SSL) (https).

L’authentification basée sur les revendications est utilisée pour l’accès sécurisé au Service Bus. La revendication utilisée pour l’authentification auprès de Service Bus est générée dans Dataverse et signée par le certificat AppFabricIssuer spécifié dans la base de données de configuration Dataverse.

Gérer les erreurs d’exécution

Si une erreur s’est produite après une tentative d’accès d’une publication au Service Bus, vérifiez le statut de la tâche système associée dans l’application Web pour obtenir plus d’informations sur l’erreur. Si le Service Bus est arrêté ou qu’un écouteur/point de terminaison est indisponible, le message actuel en cours de traitement dans Dataverse n’est pas publié sur le bus. Le service asynchrone continuera de tenter de publier le message de manière exponentielle en essayant de publier d’abord fréquemment puis à intervalles de plus en plus longs. En cas d’erreur Dataverse interne, aucune publication de message n’est tentée. En cas d’erreur de bus des services externe ou d’erreur réseau, la tâche système associée sera mise en attente.

Notes

Pouvez-vous nous indiquer vos préférences de langue pour la documentation ? Répondez à un court questionnaire. (veuillez noter que ce questionnaire est en anglais)

Le questionnaire vous prendra environ sept minutes. Aucune donnée personnelle n’est collectée (déclaration de confidentialité).