Skip to content

Attributions en lot

Les attributions en lot vous permettent d'émettre des badges à des centaines ou des milliers de destinataires en une seule fois en uploadant un fichier CSV. Le processus comporte quatre étapes avec suivi de progression intégré, pause/reprise et gestion des erreurs.

Aperçu

Le processus suit quatre étapes :

  1. Configurer — choisissez le badge et les options
  2. Uploader — préparez et envoyez votre fichier CSV
  3. Traiter — suivez la progression pendant la création des attributions
  4. Résultats — examinez les résultats et téléchargez les rapports

Étape 1 : Configurer

Attributions en lot — étape 1, configurer

  1. Ouvrez la page Attributions dans la barre latérale.
  2. Cliquez sur Attribution en lot.
  3. Choisissez le badge à attribuer via le sélecteur.
  4. Configurez au choix :
    • Date d'émission — la date utilisée pour toutes les attributions (par défaut, aujourd'hui)
    • Expire — date d'expiration optionnelle pour toutes les attributions
    • Envoyer l'e-mail — indique s'il faut envoyer automatiquement un e-mail à chaque destinataire dès la création de son attribution
  5. Cliquez sur Suivant.

Étape 2 : Uploader le CSV

Attributions en lot — étape 2, upload

Format du CSV

Le fichier CSV doit avoir deux colonnes : name et email. La première ligne doit être l'en-tête.

csv
name,email
Jane Smith,jane@example.com
John Doe,john@example.com
Maria Garcia,maria@example.com

Télécharger le modèle

Cliquez sur Télécharger le modèle pour obtenir un CSV vide avec les bons en-têtes. Remplissez-le avec vos destinataires et uploadez-le.

Upload

  1. Cliquez sur Uploader CSV ou glissez-déposez votre fichier.
  2. Le fichier est validé avant que le traitement ne commence.

Règles de validation

Chaque ligne est validée :

  • Nom doit comporter au moins 5 caractères
  • E-mail doit être une adresse e-mail valide
  • Les e-mails en doublon dans le fichier sont signalés
  • Les lignes vides sont ignorées

Si des erreurs de validation sont trouvées, elles sont affichées avec les numéros de ligne. Corrigez le CSV et réuploadez-le.

  1. Cliquez sur Suivant pour lancer le traitement.

Étape 3 : Traitement

Dès le début du traitement, une barre de progression et un statut en direct s'affichent :

  • Barre de progression — pourcentage des lignes traitées
  • Ligne en cours — la ligne actuellement traitée
  • Nombre de succès — combien d'attributions ont été créées
  • Nombre d'erreurs — combien de lignes ont échoué

Pause et reprise

  • Cliquez sur Pause pour suspendre temporairement le traitement. Aucune nouvelle attribution n'est créée en pause.
  • Cliquez sur Reprendre pour continuer là où vous en étiez.

Annuler

  • Cliquez sur Annuler pour arrêter complètement le traitement. Les attributions déjà créées sont conservées.

Gestion des erreurs

Quand une ligne échoue (ex. données invalides, quota mensuel atteint) :

  • L'erreur est consignée avec les détails
  • Le traitement continue automatiquement à la ligne suivante
  • Les lignes en échec sont collectées pour l'étape des résultats

Reprise après rechargement de page

Si vous fermez le navigateur par accident ou rechargez la page pendant le traitement, la session d'attribution en lot est restaurée à votre retour. La progression reprend là où elle s'est arrêtée.

Étape 4 : Résultats

Une fois le traitement terminé (ou annulé), l'écran des résultats affiche :

  • Total traité — nombre de lignes tentées
  • Réussies — nombre d'attributions créées
  • Échouées — nombre de lignes en échec

Télécharger les rapports

  • Télécharger CSV de succès — CSV de toutes les attributions créées avec succès, avec noms, e-mails et URLs de vérification
  • Télécharger CSV d'échecs — CSV de toutes les lignes en échec avec les détails des erreurs

Réessayer les échecs

Si des lignes ont échoué, vous pouvez télécharger le CSV d'échecs, corriger les problèmes et l'uploader à nouveau comme nouvelle attribution en lot pour retenter ces destinataires.

badges.ninja Documentation