Patterns d'utilisation
Les besoins d'intégration se ramènent à un petit nombre de patterns : un déclencheur, un flux, et le système cible. Reconnaître le pattern correspondant à son besoin évite de réinventer la structure du flux. Pour les détails de configuration, voir Déclencheurs et Flux.
Quand utiliser quoi
| Pattern | Déclencheur | Cas d'usage typique |
|---|---|---|
| Planificateur | Planificateur | Synchronisations périodiques, batches |
| Import de fichier | Fichier | Imports de données depuis fichiers |
| Événements | Route d'une API / Événements | Réactions en temps réel |
| Exposition d'API | Route d'une API | Création d'APIs de calcul |
Choisir selon son besoin
| Besoin | Pattern recommandé |
|---|---|
| Synchronisation périodique | Planificateur |
| Import de fichiers partenaires | Import de fichier |
| Réaction temps réel | Événements |
| API de calcul simple | Exposition d'API |
| Gros volumes en batch | Planificateur ou Import fichier |
| Routage vers différents systèmes | Événements avec Switch |
Pattern 1 : Planificateur (CRON)
Déclenche un flux à intervalles réguliers définis par une expression CRON.
Schéma
Variante avec paramètres
Cas d'usage
| Cas d'usage | CRON | Description |
|---|---|---|
| Sync quotidienne stocks | 0 6 * * * | Synchroniser ERP → E-commerce tous les matins |
| Export hebdomadaire | 0 2 * * 1 | Exporter vers un partenaire chaque lundi |
| Polling API | */5 * * * * | Vérifier les nouvelles commandes toutes les 5 min |
Avantages du pattern :
- Paramétrage flexible (expressions CRON)
- Exécutions prévisibles et traçables
- Indépendant des systèmes source/cible
Pattern 2 : Import de Fichier
Déclenche un flux lorsqu'un fichier est déposé (upload, SFTP ou email).
Schéma — Mode Fichier Entier
Schéma — Mode Ligne par Ligne
Si le système cible ne peut pas absorber les lignes à vitesse maximale, définissez un intervalle de traitement entre les lignes.
Cas d'usage
| Cas d'usage | Mode | Description |
|---|---|---|
| Import catalogue | Fichier entier | Import quotidien d'un CSV de 50 000 produits |
| Mise à jour prix | Ligne par ligne | Chaque ligne déclenche une mise à jour API |
| Import EDI | Fichier entier | Réception de fichiers XML partenaire |
Pattern 3 : Réception d'Événements
Réagit en temps réel à des événements (webhooks, API endpoints, Pub/Sub).
Schéma — Avec routage Switch
Un seul point d'entrée, plusieurs traitements : le découpage par cas limite la complexité d'un flux qui doit réagir à plusieurs types d'événements — voir le nœud Switch.
Schéma — Temps réel simple
Latence de l'ordre de quelques secondes entre l'événement et le traitement.
Cas d'usage
| Cas d'usage | Déclencheur | Description |
|---|---|---|
| Commande → ERP | Webhook | Création automatique à chaque commande |
| Stock → E-commerce | Event | Synchronisation temps réel |
| Paiement → Notification | Webhook | Email de confirmation |
Pattern 4 : Exposition d'API
Crée des endpoints HTTP pour des calculs ou agrégations sans stockage.
Schéma — Calcul simple
Schéma — Agrégation multi-sources
Pas de stockage, calcul à la volée : l'API est appelable par n'importe quel système.
Cas d'usage
| Cas d'usage | Méthode | Description |
|---|---|---|
| Calcul frais de port | GET | Calcul selon poids et destination |
| Vue client 360° | GET | Agrégation CRM + ERP + Support |
| Validation données | POST | Vérification de validité |
Aller plus loin
Voir aussi : Bonnes pratiques