Erreurs, relances et reprise
Erreurs, relances et reprise
Procédures pratiques pour gérer les erreurs réseau, timeouts et interruptions pendant un export CSV paginé
Gérer les interruptions, relancer proprement un export volumineux, informer l’utilisateur et conserver des traces fiables.
Fonctionnalités couvertes
Relancer l'export si nécessaire
Relance manuelle ou planifiée d’un export interrompu, depuis la liste des exports ou le détail d’une période.
Feedback visuel et asynchrone
Indicateurs de progression, messages d’état et notifications. L’export peut se poursuivre en tâche asynchrone même si vous quittez la page.
Conservation des logs d'export
Historique des exportations, messages d’erreur et journaux accessibles pour diagnostiquer et transmettre à l’assistance.
Introduction Ce guide détaille les procédures utilisateur à suivre lorsqu’un export CSV paginé rencontre des problèmes réseau, des timeouts ou des interruptions. Vous apprendrez comment relancer manuellement, laisser le système reprendre automatiquement, consulter le statut et récupérer les logs. Les workflows ci‑dessous sont pensés pour des utilisateurs non techniques.
Avant de commencer
Vérifiez d’abord la page “Exports” ou la vue correspondant à la période que vous souhaitez exporter : les exports sont listés avec un statut (en cours, terminé, erreur). Les actions de relance et de téléchargement s’effectuent depuis cette interface.
Workflow 1 — Détecter et gérer immédiatement une erreur réseau pendant un export
1. Repérer l'erreur (interface)
Sur la page d’export, repérez les éléments marqués “erreur”, “timeout” ou “connexion perdue”. Ces éléments affichent généralement un message synthétique et la dernière tentative d’exécution.
2. Lire le message détaillé
Ouvrez le détail de l’export pour consulter le message d’erreur complet et la liste des pages traitées. Notez la page (ou le lot) où l’export s’est interrompu.
3. Tenter une relance courte
Si l’interface propose un bouton “Réessayer” ou “Relancer”, cliquez‑y. Le système relancera l’opération à partir du dernier point connu (si disponible) ou relancera la page courante.
4. Contrôler le feedback visuel
Pendant la relance, surveillez la barre de progression, le spinner ou le badge “en cours”. Un message “En file d’attente” ou “Traitement en arrière‑plan” signifie que vous pouvez quitter la page et laisser l’export se poursuivre.
5. En cas d'échec persistant
Si plusieurs tentatives échouent, passez au workflow “Relance manuelle avancée” ou consultez les logs pour transmettre l’erreur à l’assistance.
Astuce : noter l'heure et l'étape
Lorsque vous signalez un incident, indiquez l’heure de l’échec et le numéro de page ou d’enregistrement où l’export s’est arrêté. Cela accélère le diagnostic.
Workflow 2 — Relancer manuellement un export interrompu (procédure complète)
1. Ouvrir la liste des exports
Allez dans la section Exports / Historique et filtrez sur la période concernée. Repérez les exports avec statut “erreur” ou “processing” bloqué.
2. Vérifier le détail de l'export
Cliquez sur l’export pour voir : période couverte, pages exportées, messages intermédiaires et éventuels fichiers partiels disponibles.
3. Choisir l'action de relance
Selon l’interface, choisissez “Relancer”, “Reprendre” (resume) ou “Relancer depuis la page X”. Si l’option de reprise paginée est proposée, préférez‑la pour éviter de retraiter des pages déjà exportées.
4. Confirmer et décrire l'action
Confirmez la relance. Si possible, ajoutez un commentaire (ex. : “Relance après timeout réseau 14:03”) pour qu’un administrateur puisse retrouver le contexte.
5. Suivre le transfert asynchrone
Si l’opération se déroule en tâche asynchrone, un indicateur doit rester visible et vous recevrez une notification à la fin (succès ou échec). Vous pouvez fermer la page en toute sécurité.
6. Télécharger le fichier ou vérifier l'état final
Lorsque le statut devient “terminé”, téléchargez le CSV ou consultez le message final. S’il subsiste des erreurs partielles, répétez la relance uniquement pour les pages concernées.
Choisir 'Reprendre' plutôt que 'Tout relancer'
Lorsque l’option existe, lancez une reprise paginée. Cela réduit le volume de travail et diminue le risque d’échecs supplémentaires.
Attention aux doublons lors d'une relance complète
Si vous relancez un export complet sans reprise paginée, vous risquez de produire des fichiers qui dupliquent des lignes déjà exportées. Vérifiez les règles métier (ex. dédoublonnage) avant d’importer le fichier dans un autre système.
Workflow 3 — Comportement attendu en cas de timeouts & interruptions côté client
1. Lancer l'export en mode asynchrone
Préférez l’option “Exécuter en arrière‑plan” si disponible. Le traitement continue sur le serveur même si vous perdez la connexion ou fermez l’onglet.
2. Recevoir un feedback visuel immédiat
Dès la soumission, la page doit afficher : statut initial, identifiant de l’export et estimation (si fournie). Notez ces éléments avant de quitter.
3. Notifications et suivi
Configurez ou attendez la notification (email/in‑app) indiquant la fin de l’export. Si l’interface propose un “watcher” pour l’export, il enverra des mises à jour en temps réel.
4. Reprendre après une interruption réseau
Si la connexion est rétablie, l’interface affichera automatiquement l’état à jour. Si l’export est bloqué, lancez la relance depuis la liste (voir Workflow 2).
5. Abandonner ou annuler
Si vous devez annuler (ex. mauvaise période sélectionnée), utilisez l’action “Annuler” et créez ensuite un nouvel export avec les bons paramètres.
Workflow 4 — Reprise automatique et stratégies de retry (ce que vous devez savoir)
1. Comprendre la stratégie de reprise
Les systèmes robustes appliquent des tentatives automatiques avec des délais croissants (backoff) et gardent trace de la dernière page traitée pour reprendre sans répéter tout le travail.
2. Quand intervenir manuellement
Intervenez si : plusieurs tentatives automatiques échouent, le message indique une erreur applicative (donnée invalide) ou si le temps total dépasse vos attentes.
3. Forcer une relance paginée
Préférez forcer une relance paginée (reprise) ou relancer uniquement les pages en erreur plutôt que relancer l’ensemble.
4. Surveiller les limites et quotas
Si votre plan impose des limites (taille, nombre d’exports simultanés), adaptez la cadence : exportez par tranches plus petites ou planifiez hors‑pointe pour réduire les collisions.
5. Documenter les échecs récurrents
Si la même page échoue systématiquement, consignez l’ID de la page, l’heure et le message d’erreur ; cela indique souvent un problème de données à corriger avant nouvelle relance.
Préférez les exports planifiés la nuit pour gros volumes
Si possible, lancez les exports volumineux en dehors des heures de forte activité réseau afin de réduire les risques de timeouts et de congestion.
Workflow 5 — Consulter et conserver les logs d'export (journalisation et partage avec le support)
1. Accéder à l'historique d'exports
Ouvrez la page Historique / Logs d’exports. Chaque ligne doit contenir : date, période, statut, taille du fichier, durée et message(s) associés.
2. Lire les messages d'erreur et le détail des pages
Dans le détail, recherchez : numéro(s) de page échouée(s), messages d’exception lisibles, et éventuelles étapes déjà réussies.
3. Télécharger ou exporter le log
Téléchargez le log pour archivage ou partage. Conservez une copie si vous prévoyez de relancer plusieurs fois (utile pour corrélation).
4. Rétention et purge
Consultez la politique de conservation : par défaut, conservez les logs au moins 30 jours. Archivez à plus long terme si vous devez justifier des travaux comptables.
5. Partager avec le support
Fournissez : identifiant de l’export, horodatage, message d’erreur complet, et le log téléchargé. Évitez de partager des informations sensibles non masquées.
6. Supprimer les logs si nécessaire
Si votre organisation exige la suppression (ex. données personnelles), suivez la procédure interne pour anonymiser ou purger les logs après archivage sécurisé.
Ne pas relancer aveuglément plusieurs fois
Relancer l’export en boucle sans analyser l’erreur peut générer une charge inutile et créer des fichiers partiels ou duplications. Vérifiez toujours le message d’erreur et la page concernée avant d’insister.
Ce scénario s’applique quand l’échec est ponctuel (panne réseau locale, timeout court).
- Ouvrez le détail de l’export → cliquez “Relancer” → suivez la progression.
- Si l’interface propose une reprise paginée, utilisez‑la.
- Téléchargez le fichier quand le statut est “terminé”.
Avant (relance complète)
- Relance de tout l’export.
- Risque de doublons.
- Longues durées et forte charge.
Après (reprise paginée)
- Relance ciblée des pages échouées.
- Moins de charge et moins de risques de doublons.
- Plus rapide et plus sûr pour gros volumes.
Comparaison pratique
Si vous avez le choix, utilisez systématiquement la reprise paginée pour les exports > 50 000 lignes ou lorsque le système indique un point de reprise.
Frequently Asked Questions
En résumé
- Préférez les exports asynchrones et la reprise paginée pour les gros volumes.
- Consultez le log avant de relancer pour éviter les doublons.
- Utilisez la relance manuelle seulement après analyse ; faites appel au support avec l’ID d’export et le log complet si nécessaire.
Besoin d'aide pour un export bloqué ?
Accédez à la liste des exports, vérifiez l’état et téléchargez les logs avant de contacter le support.