Poller

Le déclencheur Poller vérifie périodiquement si des mises à jour existent sur la source de données. Après que vous l\'ayez configuré, le Poller vérifie périodiquement la présence de nouvelles données en utilisant l\'URL de sondage d\'une source de données. Le Poller est idéal pour les cas d\'utilisation où les mises à jour en temps réel ne sont pas disponibles ou lorsque la fréquence des mises à jour est faible.

Présentation

Le Poller fonctionne selon le concept de sondage, où le déclencheur envoie périodiquement des requêtes à l\'URL de sondage pour vérifier si de nouvelles données existent. Vous pouvez configurer le Poller pour recevoir les notifications d\'événements entrants et démarrer l\'automatisation suivante en fonction de la notification. L\'URL du sondeur de l\'application sert de point de terminaison que le déclencheur interroge pour de nouveaux événements.

Vous pouvez configurer le Poller pour un appel GET ou un appel POST. Vous devez ajouter le paramètre d\'en-tête, le paramètre de requête, les détails de gestion du contexte et le filtre JSON lors de la configuration du Poller. L\'option POST comprend une disposition permettant d\'ajouter un corps de requête. Vous pouvez utiliser cette option pour envoyer des données à l\'URL du sondeur, qui nécessite des données supplémentaires pour les événements.

Paramètres

Les paramètres suivants sont disponibles dans le déclencheur Listener :

Panneau de configuration du sondeur

Nom
Indiquez un nom pour le Poller
URL de sondage
Indiquez l\'URL de sondage de l\'application.
Type de requête
Sélectionnez le type de requête API. Poller prend en charge les méthodes GET et POST.
  • GET - Vous pouvez utiliser la méthode GET pour extraire les détails de l\'événement.
  • POST - Vous pouvez utiliser la méthode POST pour limiter les données de réponse. La méthode POST permet d\'ajouter un corps de requête. Cette option agit comme un filtre pour limiter les données de réponse.
Corps de la requête
Saisir le corps de requête pour la méthode POST. Vous pouvez ajouter le corps de requête dans des formats tels que TXT, JSON, XML et HTML.
Intervalle de sondage
Définir la fréquence du sondage de l\'URL pour obtenir de nouvelles informations. Vous pouvez définir l\'intervalle en Minutes, Heure ou Jour. La limite minimale pour l\'intervalle est de 5 minutes.
Mode d\'authentification
Spécifier le mode d\'authentification pour le déclencheur. Vous pouvez choisir Aucune authentification ou OAuth2 - Managée par la Control Room.
Connexion
Utilisez le bouton Choisir pour sélectionner une connexion OAuth existante comme mode d\'authentification. Assurez-vous que la connexion est configurée et active.
Ajouter un en-tête
Indiquez les paramètres d\'en-tête applicables à la requête de sondage. Vous pouvez ajouter des en-têtes d\'authentification et d\'autres paramètres uniques qui doivent être inclus dans l\'en-tête de la requête.
Activez la case à cocher Ajouter un en-tête et cliquez sur Ajouter un en-tête pour ouvrir la fenêtre modale Élément. Indiquez le nom du paramètre d\'en-tête et les valeurs dans la fenêtre modale Élément.
Ajouter un paramètre de requête
Spécifiez les paramètres de requête applicables à la requête de sondage. Activez la case à cocher et cliquez sur Ajouter un en-tête pour ouvrir la fenêtre modale Élément.
Activez la case à cocher Ajouter un paramètre de requête et cliquez sur Ajouter une requête pour ouvrir la fenêtre modale Élément. Indiquez le nom et les valeurs du paramètre de requête dans la fenêtre modale Élément.
Gestion du contexte
Définissez la gestion du contexte pour tous les paramètres dynamiques. Le déclencheur utilise le contexte comme point de contrôle de sondage pour s\'assurer qu\'il extrait les informations mises à jour après le dernier point de contrôle. Vous pouvez définir la gestion du contexte pour les URL de sondage, les paramètres d\'en-tête et de requête. Définissez le paramètre comme une chaîne et utilisez cette chaîne pour définir le contexte.
Par exemple, l\'API Gmail pour le sondage utilise l\'ID d\'historique d\'un e-mail pour déterminer les modifications dans la boîte de réception. Lorsque vous configurez un déclencheur Sondeur pour la boîte de réception Gmail, vous pouvez définir l\'ID d\'historique soit dans l\'URL de sondage comme https://gmail.googleapis.com/gmail/v1/users/me/history?startHistoryId={{historyID}} , soit en ajoutant un paramètre de requête avec la clé startHistoryId et la valeur historyID. Vous pouvez ensuite configurer le contexte pour l\'ID d\'historique avec l\'ID d\'historique du dernier e-mail que la boîte de réception a reçu comme point de contrôle pour le sondage. Vous devez également ajouter le nœud JSON où l\'ID de l\'historique est capturé dans la charge utile de la réponse dans le champ Mettre à jour le contexte. Cela garantit que le déclencheur sélectionne l\'ID du dernier e-mail reçu comme ID d\'historique de départ à chaque exécution du déclencheur.
Activez la case à cocher Gestion du contexte et cliquez sur Ajouter un contexte pour ouvrir la fenêtre modale Élément. Indiquez la clé de contexte et les valeurs dans la fenêtre modale Élément. Vous pouvez sélectionner l\'une des options suivantes comme condition pour mettre à jour le contexte :
  • Expression JSON : sélectionnez cette option pour définir un nœud JSON du contenu de la réponse comme contexte.
  • Horodatage actuel (Unix) : sélectionnez cette option pour définir l\'horodatage Unix epoch du paramètre de requête comme contexte.
  • Horodatage actuel (ISO 8601) : sélectionnez cette option pour définir l\'horodatage ISO 8601 du paramètre de requête comme contexte.
Filtre JSON
Spécifier un filtre pour les données de réponse. Ce paramètre vous permet de filtrer les données selon vos besoins. Par exemple, si les données JSON contiennent des enregistrements avec plusieurs longueurs telles que 1, 5, 10, 25 et 30, vous pouvez définir le filtre JSON comme record.length>10 , ce filtre écarte les enregistrements dont la longueur est inférieure à 10.
Réponse
Sélectionnez une variable d\'enregistrement pour enregistrer les données de réponse du déclencheur. L\'automatisation enregistre les données de réponse du déclencheur au format paire clé-valeur. Après avoir exécuté le robot, accédez à la page journal d\'audit et sélectionnez l\'événement Exécution du robot par déclencheur pour consulter les données de réponse.