Historique des importations

Les importations en masse (membres, dons, présences depuis CSV) s'exécutent comme des travaux d'arrière-plan pour que le navigateur n'ait pas à maintenir une connexion ouverte pendant 30 000 lignes. L'onglet Historique des importations sur Données et Journaux affiche les 50 derniers travaux exécutés par votre organisation, avec les nombres de lignes pour que vous voyiez en un coup d'œil si l'importation s'est terminée proprement.

Ouvrez-le depuis Données et Journaux → Historique des importations dans la barre latérale.

Lire le tableau

Chaque ligne est un travail d'importation. Les colonnes sont :

Colonne	Signification
Statut	queued, processing, complete ou failed. Un badge vert signifie terminé ; gris signifie encore en cours ou en file.
Total	Nombre de lignes de données dans le CSV téléversé (en-tête exclu).
Traitées	Lignes que le worker a terminées. Pendant que le travail tourne, ce nombre monte en temps réel au rafraîchissement.
Échouées	Lignes en erreur — e-mails invalides, champs obligatoires manquants, violations de clé étrangère, doublons ayant déclenché la règle d'ignorance des doublons.
Créé	Quand le téléversement a été lancé, dans le fuseau horaire de votre organisation.

Un travail en bonne santé se termine avec statut = complete, traitées = total, échouées = 0. Tout le reste mérite attention.

Cycle de vie du travail

Quand vous téléversez un CSV depuis le module Actions en masse :

1. Le fichier est analysé et une ligne est insérée dans import_jobs avec status = queued.
2. Un worker le prend, met status = processing et commence à insérer les lignes par lots de 100.
3. Chaque ligne réussie incrémente processed_rows ; chaque échec incrémente failed_rows et ajoute une erreur à une liste d'échecs par ligne.
4. Quand toutes les lignes ont été tentées, le worker met status = complete (même si certaines lignes ont échoué — un succès partiel reste un succès).
5. Si le worker lui-même plante (coupure réseau, expiration de l'edge function pour un travail de 50 000 lignes), le travail reste à status = processing jusqu'à ce que le worker suivant le reprenne ; les travaux dans cet état depuis plus de 30 minutes sont marqués failed.

TIP

Vous pouvez quitter Actions en masse pendant qu'une importation tourne. Le travail continue côté serveur et vous pouvez revenir sur cette page pour vérifier la progression.

Ce que "lignes en échec" signifie réellement

Le compteur failed_rows représente les lignes rejetées par le worker, pas les lignes qu'il n'a pas pu traiter du tout. Raisons courantes :

• Échec de validation — email n'est pas un e-mail valide ; phone ne correspond pas au format pays ; un champ obligatoire est vide.
• Clé étrangère introuvable — le CSV référence un groupe, un ministère ou un fonds qui n'existe pas encore. Créez d'abord les lignes parentes, puis ré-importez.
• Doublon ignoré — si vous avez activé "ignorer les doublons" dans l'interface de téléversement, les lignes correspondant à un membre existant par e-mail ou téléphone comptent comme échouées (techniquement ignorées, mais la colonne ne fait pas la différence).
• Permission refusée — votre rôle n'a pas le droit d'écriture sur la table cible pour certaines lignes. Rare ; n'arrive généralement qu'avec des configurations RBAC personnalisées.

Les 100 premières erreurs au niveau ligne sont stockées dans le journal d'erreurs du travail. L'interface d'actions en masse affiche les 10 premières en ligne avec un bouton "télécharger toutes les erreurs" en CSV.

Trier une importation à échec partiel

1. Ouvrez le travail en échec depuis Historique des importations.
2. Cliquez sur Télécharger le CSV d'erreurs — c'est le fichier original avec deux colonnes supplémentaires : __row et __error.
3. Corrigez les erreurs dans le CSV (ou isolez les lignes problématiques).
4. Re-téléversez uniquement les lignes corrigées. La règle d'ignorance des doublons empêchera de réimporter les lignes déjà réussies.

WARNING

Ne re-téléversez pas le CSV original sans ignorer-les-doublons activé après un échec partiel. Vous créerez des doublons de chaque ligne qui avait réussi la première fois.

Différences par rapport au journal d'audit

Le journal d'audit capture ce que l'importation a fait (une ligne par membre inséré, avec actor_email = system). L'Historique des importations capture si le travail lui-même s'est terminé. Utilisez :

• Historique des importations quand vous voulez savoir "mon importation a-t-elle fonctionné, et combien de lignes n'ont pas fonctionné ?"
• Journal d'audit quand vous voulez savoir "qu'a touché précisément cette importation ?" — filtrez le journal d'audit sur la fenêtre temporelle du travail.

Une importation typique de 1 000 membres écrit 1 000 lignes dans le journal d'audit et 1 ligne dans l'historique des importations.

Rétention

Les travaux d'importation et leurs journaux d'erreurs sont conservés 1 an sur tous les plans payants (90 jours sur Starter). Le CSV original téléversé est supprimé du stockage après 30 jours quel que soit le plan — assez longtemps pour les réimportations et l'investigation, assez court pour garder les coûts de stockage raisonnables.

Si vous avez besoin du CSV original pour la conformité, téléchargez-le depuis Actions en masse → Historique (une vue distincte qui expose le fichier brut) avant la fin de la fenêtre de 30 jours.

Voir aussi

• Actions en masse pour exécuter les importations elles-mêmes
• Journal d'audit de l'organisation pour voir les insertions au niveau ligne
• Exporter les journaux pour l'archivage hors plateforme