Présentation
Ce module décrit comment vous pouvez étendre la fonctionnalité des connecteurs personnalisés avec des définitions de déclencheur.
Dans ce module, vous allez :
découvrir les déclencheurs dans les connecteurs personnalisés ;
découvrir des scénarios courants dans lesquels des déclencheurs peuvent être utilisés ;
Identifier les différents types de déclencheurs.
Découvrez comment étendre une définition de connecteur personnalisé aux déclencheurs définis par une API de service.
Les déclencheurs vous permettent d’étendre la fonctionnalité du connecteur dans Microsoft Power Automate et Microsoft Azure Logic Apps, où un système doit répondre aux changements des données ou services sous-jacents. Le scénario d’utilisation de déclencheur le plus courant consiste à créer un flux de cloud qui démarre lorsque les données sous-jacentes changent, comme « Lorsqu’un enregistrement est créé » ou lorsqu’un certain événement se produit dans le service défini par le connecteur personnalisé, tel que « Lorsque l’alarme se déclenche ».
Déclencheurs dans Power Automate et Logic Apps
Power Automate et Logic Apps définissent un déclencheur en tant qu’événement qui démarre un flux de cloud ou un flux de travail Logic Apps. Ces événements peuvent être déclenchés par un utilisateur, planifiés ou générés par un connecteur, y compris un connecteur personnalisé. Les définitions de déclencheur étendent les connecteurs personnalisés et permettent à ces connecteurs d’être utilisés pour initier des flux de cloud et des flux de travail Logic Apps.
La plupart des connecteurs définissent un récapitulatif des déclencheurs comme « Lorsque <object> est <verb> », et une implémentation de connecteur typique comprend un déclencheur pour une ou plusieurs actions.
Types de déclencheurs
Envisagez un système de gestion de messagerie vocale. Un déclencheur dans un tel système pourrait être un événement « nouveau message vocal reçu ». Vous pouvez définir une méthode pour identifier si un nouveau message vocal a été reçu de deux manières :
Appelez régulièrement la boîte vocale et recherchez de nouveaux messages. Ce comportement décrit un déclencheur interrogation, c’est-à-dire l’implémentation dans laquelle les données sont interrogées depuis le service sous-jacent. Un déclencheur d’interrogation est une activité chronométrée qui lance un appel à l’API de service à un intervalle régulier et configurable pour déterminer si de nouvelles données sont disponibles. Pour prendre en charge les déclencheurs d’interrogation, l’API peut filtrer les résultats en fonction d’un état. L’état est généralement basé sur le temps, par exemple « Renvoyer tous les messages vocaux reçus depuis hier ».
Laissez votre système de messagerie vocale vous envoyer un e-mail lorsqu’un nouveau message vocal est reçu. Cette approche définit un déclencheur ou une implémentation Webhook où le service pousse les données. Le service qui prend en charge les déclencheurs Webhook doit être en mesure de maintenir une liste des parties à rappeler et savoir comment rappeler. Dans l’exemple de messagerie vocale, il s’agit d’une liste d’adresses e-mail et de la possibilité d’envoyer un e-mail de notification.
Fondamentalement, ces deux types de déclencheurs diffèrent en ce qui concerne le côté responsable de la gestion des opérations.
Interrogation | Webhook |
---|---|
Commence par définir un état | Enregistré avec le service |
Vérifie périodiquement les mises à jour | Signale lorsqu’un événement se produit |
Demande toutes les nouvelles données depuis la dernière mise à jour de l’état | Est supprimé automatiquement |
Le service maintient l’état | Power Automate ou Logic Apps gère le processus d’enregistrement et de désinscription des Webhooks |
Important
La disponibilité d’une API REST pour un service n’implique pas qu’il soit possible de définir des déclencheurs de connecteur personnalisés. Le service sous-jacent doit pouvoir renvoyer les données de manière incrémentielle ou fournir une implémentation Webhook. Si des déclencheurs sont requis mais que l’API de service n’a aucune capacité, un développeur doit étendre le service pour permettre aux utilisateurs de définir un déclencheur.
Définir un déclencheur
Tout comme la définition du connecteur, les deux types de déclencheurs sont définis par un document OpenAPI (Swagger) qui spécifie les points de terminaison, les paramètres, les conditions et les réponses. Cependant, la version de spécification OpenAPI utilisée par Microsoft Power Platform ne différencie pas les actions et les déclencheurs. Microsoft Power Platform ajoute des extensions OpenAPI personnalisées afin d’étendre les spécifications pour définir les déclencheurs et leur contenu.
Un assistant pas à pas pour les déclencheurs est disponible, et il suit la même disposition générale que l’assistant d’action.
Tout comme les actions de connecteur personnalisées, il est important de sélectionner un bon résumé des déclencheurs. Le résumé est utilisé lorsqu’un créateur recherche les connecteurs, et lorsqu’un déclencheur est sélectionné, son résumé devient le titre d’étape par défaut dans Power Automate et Logic Apps.
Contrairement aux actions, dont la plupart peuvent être entièrement créées dans le concepteur de connecteurs personnalisés, les déclencheurs peuvent être plus complexes et nécessitent souvent des modifications manuelles. Ce module décrit comment créer des définitions de déclencheur dans des scénarios d’interrogation et de Webhook.