Déclencheurs
Un déclencheur est le point d'entrée d'un flux : il définit quand le flux démarre, comment les données sont reçues et quelles données sont transmises au flux. Chaque flux est associé à un déclencheur unique.
Qu'est-ce qu'un déclencheur ?
Un déclencheur relie un événement externe à un flux. Lorsque l'événement se produit (requête HTTP, fichier déposé, heure planifiée, message dans une file…), Ecosystem exécute le flux en lui fournissant les données reçues via data ; le context, lui, démarre vide et est enrichi par les nœuds suivants :
{
"data": { "orderId": "CMD-4821", "total": 149.9 },
"context": {}
}
L'objet réellement reçu dépend du type de déclencheur — voir Nœud Déclencheur pour le détail par type.
Cycle de vie d'un déclencheur
Le cycle de vie d'un déclencheur suit un ordre fixe : création au statut Inactif, configuration des options propres au type, association d'un flux, activation (passage en Actif), déploiement dans un ou plusieurs environnements, puis exécution — le déclencheur reçoit les événements ou les données et lance le flux.
Deux statuts s'appliquent au déclencheur lui-même :
| Statut | Signification |
|---|---|
| Inactif | Créé mais ne déclenche rien. |
| Actif | Peut être déployé et déclencher des flux selon sa configuration. |
Types de déclencheurs
Ecosystem prend en charge six familles de déclencheurs :
| Type | Quand l'utiliser | Documentation |
|---|---|---|
| Route d'une API | Exposer une API REST ou recevoir des webhooks (notifications HTTP). | Route d'une API |
| Fichier | Lancer un flux quand un fichier arrive (téléversement, FTP/SFTP, e-mail). | Fichier |
| Planificateur | Exécuter selon une planification (expression CRON). | Planificateur |
| Interrogation | Interroger périodiquement une API externe et traiter les résultats. | Interrogation |
| Événement Google Pub/Sub | Réagir à chaque message d'une souscription Google Pub/Sub. | Événement Google Pub/Sub |
| AWS SQS | Réagir à chaque message d'une file Amazon SQS. | AWS SQS |
Slug et URL publique
Chaque déclencheur possède un slug unique, utilisé dans l'URL publique, qui doit rester unique au sein de l'organisation.
Le slug est la partie de l'URL qui identifie le déclencheur : il est généré depuis le nom (lettres minuscules, chiffres, points et tirets) et apparaît après le domaine de l'environnement. Les nouveaux déclencheurs utilisent des points comme séparateurs, les déclencheurs déjà créés conservent leur slug existant.
L'URL se construit au format https://<environnement>-<entreprise>.ecosystem.apizr.io/<slug>. Par exemple, pour un déclencheur « API de réception de commandes » déployé sur l'environnement de développement studio de l'entreprise testdev :
| Élément | Exemple |
|---|---|
| Slug | api.reception.commandes |
| URL complète | https://studio-testdev.ecosystem.apizr.io/api.reception.commandes |
L'URL complète est affichée après le déploiement — voir Route d'une API et Déployer un déclencheur.
Apps, tags et déploiements
- Apps : rattachent déclencheurs et flux à une application métier et alimentent la cartographie — Apps.
- Tags : catégorisent et filtrent les déclencheurs dans les listes.
- Déploiement : un déclencheur doit être déployé dans un environnement pour y être opérationnel ; il peut l'être sur plusieurs environnements — Déployer un déclencheur.
Étapes suivantes
Voir aussi : N œud Déclencheur · Droits — Flux et déclencheurs