Skip to content

Certifications en lot ​

Les certifications en lot vous permettent d'émettre des badges numériques à des centaines ou des milliers de destinataires à la fois en important un fichier CSV. Le processus comporte quatre étapes, avec suivi de la progression, pause/reprise et gestion des erreurs intégrés.

Aperçu ​

Le processus de certification en lot suit quatre étapes :

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

Étape 1 : Configurer ​

Bulk Awards — step 1, configure

  1. Ouvrez la page Bulk Credentials depuis la barre latérale (route à part entière, distincte de la page Credentials).
  2. Sélectionnez le badge à émettre à l'aide du sélecteur de badge.
  3. Configurez éventuellement :
    • Issued On — la date utilisée pour toutes les certifications (aujourd'hui par défaut)
    • Expires — date d'expiration facultative pour toutes les certifications
    • Send Email — envoyer ou non automatiquement un e-mail à chaque destinataire après la création de sa certification
  4. Cliquez sur Next.

Étape 2 : Uploader le CSV ​

Bulk Awards — step 2, upload

Format du CSV ​

Le fichier CSV doit comporter une colonne name et une colonne email, avec une ligne d'en-tête. Les noms d'en-tête ne sont pas sensibles à la casse, et recipient_name / recipient_email sont acceptés comme alias de name / email.

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 Download Template pour obtenir un fichier CSV vierge avec les bons en-têtes. Remplissez-le avec vos destinataires, puis importez-le.

Upload ​

  1. Cliquez sur Upload CSV ou glissez-déposez votre fichier.
  2. Le fichier est validé avant le début du traitement.

Règles de validation ​

Chaque ligne est validée dès que le fichier est analysé :

  • Le nom doit comporter au moins 5 caractères
  • L'e-mail doit être une adresse e-mail valide
  • Les lignes vides sont ignorées

Le tableau d'aperçu liste chaque ligne avec une coche verte ou un motif en rouge. Les lignes invalides ne sont pas bloquantes : elles sont simplement ignorées, et le compteur indique combien de destinataires valides seront traités (p. ex. « 18 valid recipients, 2 invalid (will be skipped) »). Vous pouvez continuer dès qu'au moins une ligne est valide ; inutile de corriger et de réimporter au préalable.

  1. Cliquez sur Next pour lancer le traitement.

Étape 3 : Traitement ​

Une fois le traitement lancé, vous voyez une barre de progression et des compteurs en direct :

  • Barre de progression — le pourcentage de lignes traitées
  • Created — le nombre de certifications créées
  • Failed — le nombre de lignes en échec
  • Remaining — le nombre de lignes encore en file d'attente

Les tableaux en direct Created, Failed et Pending se remplissent sous la barre au fil du lot.

Pause et reprise ​

  • Cliquez sur Pause pour arrêter temporairement le traitement. Aucune nouvelle certification n'est créée pendant la pause.
  • Cliquez sur Resume pour continuer là où vous vous étiez arrêté.

Annuler ​

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

Gestion des erreurs ​

Lorsqu'une ligne échoue pour une raison qui lui est propre (p. ex. une valeur invalide rejetée par le backend) :

  • L'erreur est enregistrée pour cette ligne
  • Le traitement passe automatiquement à la ligne suivante
  • Les lignes en échec sont rassemblées pour l'étape des résultats, avec leur message d'erreur affiché dans le tableau des échecs à l'écran

Les lignes limitées par le taux de requêtes sont automatiquement retentées après un court délai. Une erreur de crédits ou de quota est différente : au lieu de passer à la suite, le lot se met en pause pour que vous ne consommiez pas le reste du fichier. Un avis rouge « Insufficient credits » s'affiche ; rechargez vos crédits ou changez de formule, puis cliquez sur Resume pour continuer là où le traitement s'est arrêté.

Récupération après actualisation de la page ​

Si vous fermez accidentellement le navigateur ou actualisez la page pendant le traitement, la session de certification en lot est récupérée à votre retour. La progression reprend là où elle s'était arrêtée.

Étape 4 : Résultats ​

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

  • Total — nombre de destinataires dans le lot
  • Created — nombre de certifications créées
  • Failed — nombre de lignes en échec
  • Skipped — destinataires non traités (p. ex. les lignes restantes après une annulation)

Sous les cartes, un tableau Created liste chaque nouvelle certification avec un lien pour la consulter, et un tableau Failed liste les échecs avec leur message d'erreur.

Télécharger les rapports ​

  • Download Results CSV — toutes les lignes du lot, avec les colonnes row, name, email, status, award_url (l'URL de la certification est renseignée pour les lignes créées).
  • Download Failures CSV — uniquement les lignes en échec, avec les colonnes name, email, error.

Réessayer les échecs ​

Si certaines lignes ont échoué, cliquez sur Retry Failures. Cela lance un nouveau passage sur les seuls destinataires en échec — inutile de réimporter un CSV. C'est pratique après la résolution d'un problème temporaire, comme le rechargement de crédits à la suite d'un lot mis en pause.

badges.ninja Documentation