Open Office Hours saison 1 : session 7 – Continue on Error & Data Errors
La gestion des erreurs est l’un des aspects les plus importants pour maintenir une intégration de données en bonne santé. Savoir quand laisser un transfert se poursuivre malgré des erreurs, et comment interpréter et résoudre efficacement les erreurs de données, permet à vos intégrations de fonctionner de manière fluide tout en évitant que des problèmes passent inaperçus.
Ce guide présente les bonnes pratiques pour utiliser Continue on Error, lire et comprendre les journaux d’erreurs de données, et retraiter les enregistrements en toute sécurité après avoir corrigé les causes profondes dans MyRapidi.
Dans la 7e session de notre série Open Office Hours, nous abordons Continue on Error et les Data Errors dans Rapidi.
Continue on Error & Data Errors
Dans cette session Open Office Hours, nous vous montrons comment utiliser Continue on Error et comment traiter les erreurs de données dans MyRapidi pour que vos intégrations fonctionnent de manière fiable.
Thèmes abordés :
- La fonctionnalité Continue on Error – Quand et pourquoi activer cette fonctionnalité pour que les transferts se poursuivent même lorsque certains enregistrements échouent
- Interpréter les erreurs de données – Comment parcourir et comprendre les journaux d’erreurs dans MyRapidi pour identifier rapidement ce qui n’a pas fonctionné
- Scénarios d’erreur courants – Échecs de validation, champs obligatoires manquants, clés en double et autres problèmes fréquents
- Retraitement sécurisé – Comment corriger les causes profondes et resynchroniser les enregistrements concernés sans créer de doublons ni de conflits de données
Nous partageons aussi des conseils pratiques sur les stratégies de surveillance, pour éviter que les erreurs ne s’accumulent sans que personne ne les remarque et préserver la bonne santé globale de vos intégrations.
Regardez le replay de notre septième session : Continue on Error & Data Errors
Continue on Error & Data Errors dans RAPIDI : surveillance, dépannage et reprise
Lorsque vous transférez des données entre systèmes, les erreurs sont inévitables. Des enregistrements peuvent échouer à la validation, des champs obligatoires peuvent manquer ou des clés en double peuvent apparaître. L’essentiel est de gérer ces erreurs proprement, afin qu’un seul enregistrement problématique ne bloque pas tout le transfert. La fonctionnalité Continue on Error de Rapidi et ses outils de gestion des erreurs de données vous permettent de maîtriser la façon dont les erreurs sont traitées et résolues.
Qu’est-ce que Continue on Error ?
Continue on Error est un paramètre de transfert de Rapidi qui détermine ce qui se passe lorsqu’un enregistrement rencontre une erreur pendant le traitement.
Comment ça fonctionne
- Lorsqu’il est activé, le transfert ignore l’enregistrement en échec et poursuit le traitement des enregistrements restants. L’enregistrement en échec est consigné comme erreur de données pour être examiné plus tard.
- Lorsqu’il est désactivé, le transfert s’arrête complètement à la première erreur. Aucun autre enregistrement n’est traité tant que le problème n’est pas résolu.
Quand activer Continue on Error
- Transferts à fort volume, où un seul enregistrement défectueux ne doit pas bloquer des centaines d’enregistrements valides
- Transferts planifiés qui s’exécutent la nuit ou sans supervision
- Chargements initiaux de données, où certaines données sources peuvent être incomplètes
- Intégrations dont les opérations métier dépendent d’un flux de données dans les temps
Quand le laisser désactivé
- Transferts où l’intégrité des données exige un traitement tout ou rien
- Données financières ou soumises à des exigences de conformité, pour lesquelles des transferts partiels pourraient poser problème
- Pendant le développement et les tests, lorsque vous voulez détecter chaque erreur immédiatement
Comprendre les erreurs de données dans MyRapidi
Lorsque Continue on Error est activé et qu’un enregistrement échoue, celui-ci apparaît comme erreur de données dans MyRapidi. Les erreurs de données fournissent des informations détaillées sur ce qui n’a pas fonctionné et sur l’enregistrement concerné.
Contenu d’une erreur de données
- Identifiant de l’enregistrement – L’enregistrement précis qui a échoué (par ex. numéro client, ID de commande)
- Message d’erreur – L’erreur renvoyée par le système source ou le système cible
- Horodatage – Le moment où l’erreur s’est produite
- Contexte du transfert – Le transfert et l’exécution qui ont produit l’erreur
Parcourir le journal des erreurs de données
MyRapidi propose une vue dédiée aux erreurs de données qui vous permet de :
- filtrer les erreurs par transfert, période ou type d’erreur
- trier les erreurs pour traiter en priorité les problèmes les plus récents ou les plus fréquents
- consulter le détail complet de l’erreur pour chaque enregistrement en échec
- suivre si les erreurs ont été traitées ou sont toujours en attente
Scénarios d’erreur courants
Connaître les types d’erreur les plus fréquents vous aide à les résoudre plus vite et à éviter qu’ils ne se reproduisent.
1) Échecs de validation
Le système cible rejette un enregistrement parce qu’une valeur de champ ne respecte pas ses règles de validation. Causes fréquentes :
- Champs e-mail au format invalide
- Numéros de téléphone qui ne correspondent pas au format attendu
- Champs numériques qui reçoivent des valeurs texte
2) Champs obligatoires manquants
Un enregistrement est envoyé sans une valeur exigée par le système cible. Cela arrive souvent lorsque :
- les enregistrements sources ont des champs facultatifs qui sont obligatoires dans le système cible
- des formules de recherche (lookup) renvoient des valeurs vides sans valeur de repli appropriée
- de nouveaux champs obligatoires sont ajoutés au système cible après la mise en place de l’intégration
3) Violations de clé en double
Le système cible contient déjà un enregistrement avec le même identifiant unique. Cela peut se produire lorsque :
- des enregistrements sont créés manuellement dans le système cible avant que l’intégration ne les synchronise
- un transfert précédent n’a été que partiellement effectué, puis est relancé
- le Link Storage n’est plus synchronisé avec les enregistrements réels du système cible
4) Erreurs d’autorisation et d’accès
L’utilisateur d’intégration ne dispose pas des autorisations suffisantes pour créer ou mettre à jour des enregistrements dans un objet ou une table donnés. Vérifiez le rôle et les autorisations de l’utilisateur d’intégration dans le système cible.
Retraiter en toute sécurité les enregistrements en échec
Une fois la cause profonde d’une erreur de données identifiée et corrigée, vous devez retraiter les enregistrements concernés. Rapidi fournit des mécanismes pour le faire en toute sécurité.
Étapes pour un retraitement sécurisé
- Identifier la cause profonde – Examinez le message d’erreur et comprenez pourquoi l’enregistrement a échoué
- Corriger le problème – Corrigez les données dans le système source, mettez à jour le mappage de champs ou ajustez les paramètres du système cible
- Retraiter l’enregistrement – Utilisez la fonction de retraitement de MyRapidi pour resynchroniser uniquement les enregistrements concernés
- Vérifier le résultat – Contrôlez que l’enregistrement apparaît désormais correctement dans le système cible et que l’erreur de données a disparu
Éviter les erreurs de retraitement courantes
- Ne retraitez pas avant d’avoir corrigé la cause profonde – la même erreur se reproduira
- Vérifiez le Link Storage avant de retraiter pour éviter de créer des doublons
- Pour un retraitement en masse, commencez par un petit lot afin de vérifier que la correction fonctionne
Stratégies de surveillance
Une surveillance proactive évite que les erreurs de données s’accumulent et entraînent des problèmes en aval.
Bonnes pratiques de surveillance des erreurs
- Consultez régulièrement le journal des erreurs de données, idéalement dans le cadre d’une routine quotidienne
- Configurez des notifications ou planifiez des revues régulières de l’état de vos transferts
- Suivez l’évolution des erreurs dans le temps – une hausse soudaine peut signaler une modification du système
- Traitez les erreurs rapidement plutôt que de les laisser s’accumuler
- Utilisez la formule MESSAGE dans les mappages de champs pour consigner les identifiants d’enregistrement et accélérer le dépannage
Résumé
Continue on Error et la gestion des erreurs de données sont des outils essentiels pour des intégrations de données fiables. Activez Continue on Error pour les transferts à fort volume et les transferts planifiés, afin que l’échec d’un seul enregistrement ne bloque pas votre flux de données. Utilisez les journaux d’erreurs de données de MyRapidi pour identifier, comprendre et résoudre efficacement les problèmes. Corrigez toujours les causes profondes avant de retraiter, et mettez en place des routines de surveillance pour détecter les problèmes tôt.
Et ensuite ?
Restez à l’écoute pour la prochaine session de notre série Open Office Hours. Chaque semaine, nous abordons un nouveau thème pour vous aider à tirer le meilleur parti de votre intégration Rapidi.
Vous ne pouvez pas assister en direct ? Inscrivez-vous quand même, et nous vous enverrons ensuite l’enregistrement et les supports.
Open Office Hours
Chaque semaine, nos spécialistes de l’intégration animent une session de formation gratuite de 30 minutes sur un thème précis de MyRapidi.
Questions fréquentes
À quoi sert Continue on Error dans Rapidi ?
Continue on Error est un paramètre de transfert qui indique à Rapidi de poursuivre le traitement des enregistrements restants lorsqu’un enregistrement échoue. Au lieu d’arrêter tout le transfert, l’enregistrement en échec est consigné comme erreur de données et le reste du lot continue. C’est particulièrement utile pour les transferts à fort volume ou planifiés, où vous ne voulez pas qu’un seul enregistrement défectueux bloque tout.
Faut-il toujours activer Continue on Error ?
Pas forcément. Pour la plupart des transferts en production, surtout planifiés, l’activer est judicieux pour que votre intégration continue de tourner. En revanche, pendant le développement et les tests, le laisser désactivé vous aide à détecter les erreurs immédiatement. Pour les transferts soumis à des exigences de conformité, où des données partielles pourraient poser problème, vous préférerez peut-être le laisser désactivé afin que les problèmes soient réglés avant que la moindre donnée ne soit transférée.
Comment trouver et consulter les erreurs de données dans MyRapidi ?
MyRapidi dispose d’une vue dédiée aux erreurs de données, qui liste tous les enregistrements en échec. Vous pouvez filtrer par transfert, période ou type d’erreur. Chaque entrée indique l’enregistrement qui a échoué, le message d’erreur du système source ou cible et l’exécution du transfert qui l’a produite. Vous disposez ainsi du contexte nécessaire pour diagnostiquer et corriger le problème.
Quelles sont les causes les plus fréquentes des erreurs de données ?
Les causes les plus fréquentes sont les échecs de validation (mauvais format de données), les champs obligatoires manquants (la source contient des champs facultatifs qui sont obligatoires dans le système cible), les violations de clé en double (l’enregistrement existe déjà) et les erreurs d’autorisation (l’utilisateur d’intégration n’a pas les accès nécessaires). Connaître ces schémas vous aide à mettre en place des mesures préventives dans vos mappages de champs.
Comment retraiter en toute sécurité les enregistrements en échec ?
Commencez par identifier et corriger la cause profonde de l’erreur. Utilisez ensuite la fonction de retraitement de MyRapidi pour resynchroniser uniquement les enregistrements concernés. Vérifiez toujours que la correction fonctionne sur un petit lot avant de retraiter en masse. Contrôlez le Link Storage pour éviter de créer des doublons, et vérifiez après le retraitement que les enregistrements apparaissent correctement dans le système cible.