Flux RSS
Démarrer un workflow lorsqu'une nouvelle entrée apparaît dans un flux RSS ou Atom.
Le bloc de déclenchement RSS démarre un workflow pour chaque nouvelle entrée d'un flux RSS ou Atom. C'est un déclencheur par interrogation (polling) : Scrydon récupère le flux à intervalle régulier, vous n'avez donc aucune boucle à construire et le déclencheur n'expose aucune URL entrante que quiconque pourrait appeler.
Configuration
| Champ | Obligatoire | Remarques |
|---|---|---|
| Feed URL | oui | Une URL http ou https d'un flux RSS 2.0, RSS 1.0 ou Atom. |
| Poll Interval | non | Toutes les 5 minutes, 15 minutes (par défaut), 30 minutes, heure, 6 heures ou jour. |
| Title Filter | non | Seules les entrées dont le titre contient ce texte, sans tenir compte de la casse, démarrent une exécution. |
Le flux est récupéré avec une limite de 30 secondes, et une réponse de plus de 5 Mio est refusée. Les messages d'erreur désignent le flux par son adresse sans la chaîne de requête : une URL de flux qui contient un jeton ne le divulgue donc pas dans le journal d'exécution.
Ce que le déclencheur émet
Référencez les champs depuis les blocs suivants avec <rss1.title>, <rss1.link>,
etc., où rss1 est le nom du bloc de déclenchement.
| Champ | Contenu |
|---|---|
title | Le titre de l'entrée. |
link | La page propre de l'entrée. |
description | Le résumé ou la description. |
content | Le contenu complet, lorsque le flux le fournit. |
author | L'auteur de l'entrée. |
guid | L'identifiant unique de l'entrée. À défaut, son lien. |
published | Un horodatage ISO-8601, vide si le flux ne donne aucune date valide. |
categories | Un tableau des catégories de l'entrée. |
feedTitle | Le titre du flux. |
feedUrl | L'URL du flux. |
Ce qui compte comme nouveau
- La première interrogation ne démarre rien. Elle enregistre les entrées que le flux liste à cet instant : ajouter un flux au long historique ne démarre donc pas une exécution pour chaque ancienne entrée. Seules les entrées qui apparaissent ensuite démarrent une exécution.
- Une entrée est reconnue par son
guid. Une entrée dont le guid a déjà été vu n'est jamais livrée une seconde fois, même si le flux modifie son titre ou la déplace. Une entrée sans guid ni lien ne peut pas être reconnue et est ignorée. - Les nouvelles entrées s'exécutent de la plus ancienne à la plus récente, dans l'ordre de publication, lorsque plusieurs arrivent entre deux interrogations.
- Scrydon mémorise les 1000 entrées les plus récentes. Un flux qui liste plus de 1000 entrées est lu jusqu'à ses 1000 plus récentes ; les plus anciennes ne démarrent jamais d'exécution. Les entrées qui ont quitté le flux restent mémorisées jusqu'à ce que 1000 entrées plus récentes les remplacent : une réponse vide ou tronquée du serveur (page de maintenance, incident de CDN) ne fait donc pas réapparaître les anciennes entrées comme nouvelles.
- Changer la Feed URL repart de zéro. La mémoire appartient à un seul flux. Après la modification de l'URL, la vérification suivante est une première interrogation du nouveau flux : elle enregistre ses entrées et ne démarre aucune exécution, au lieu de les traiter toutes comme nouvelles. Les entrées publiées pendant le changement ne sont pas livrées.
- Le Title Filter décide seulement quelles nouvelles entrées démarrent une exécution. Une entrée écartée par le filtre est tout de même mémorisée : modifier le filtre plus tard ne la rejoue donc pas.
Fréquence
Scrydon recherche les déclencheurs à exécuter toutes les cinq minutes : l'intervalle d'interrogation est donc le délai minimal entre deux récupérations, et une nouvelle entrée peut attendre jusqu'à une vérification de plus que l'intervalle choisi.
Les déclencheurs par interrogation ne s'exécutent que dans un environnement promu. En Développement, le déclencheur s'enregistre et se valide, mais ne s'exécute jamais. Promouvez le workflow vers Staging ou Production pour le voir se déclencher, et utilisez Test sur le déclencheur pour exercer les blocs suivants pendant la construction.
Lorsque le flux échoue
Une interrogation échoue lorsque le flux ne répond pas à temps, répond par une erreur HTTP, dépasse 5 Mio ou n'est pas un document RSS ou Atom. Comme tout déclencheur par interrogation, un déclencheur RSS dont les interrogations échouent 10 fois de suite est désactivé automatiquement ; une interrogation réussie remet le compteur à zéro. Corrigez la cause (l'URL ou le flux lui-même), puis enregistrez ou redéployez le workflow pour que le déclencheur soit à nouveau enregistré.
Dépannage
| Symptôme | Cause |
|---|---|
| Rien ne se déclenche, aucune erreur | Le workflow est en Développement, ou aucune nouvelle entrée n'est apparue depuis la première interrogation. |
| Les premières entrées n'ont démarré aucune exécution | C'est voulu : la première interrogation enregistre seulement ce que le flux liste. |
is not an RSS or Atom feed | L'URL répond par une page web et non par un flux. Ouvrez l'URL dans un navigateur et cherchez le lien propre du flux. |
did not answer within 30 seconds | Le serveur du flux est lent ou injoignable depuis Scrydon. |
is larger than 5242880 bytes | Le flux dépasse 5 Mio. Utilisez un flux plus court du même éditeur, par exemple un flux par catégorie. |
| Le déclencheur s'est arrêté après des échecs répétés | Dix interrogations consécutives ont échoué et le déclencheur a été désactivé. Corrigez le flux, puis enregistrez ou redéployez le workflow. |