Skip to content

Atorgaments massius

Els atorgaments massius et permeten lliurar credencials a centenars o milers de destinataris d'un sol cop pujant un fitxer CSV. El procés té quatre passos amb seguiment del progrés integrat, pausa/represa i gestió d'errors.

Visió general

El procés massiu segueix quatre passos:

  1. Configurar — tria la credencial i les opcions
  2. Pujar — prepara i puja el fitxer CSV
  3. Processar — controla el progrés mentre es creen els atorgaments
  4. Resultats — revisa el desenllaç i descarrega els informes

Pas 1: Configurar

Atorgaments massius — pas 1, configurar

  1. Obre la pàgina Atorgaments des de la barra lateral.
  2. Prem Atorgament massiu.
  3. Tria la credencial a lliurar amb el selector.
  4. Configura opcionalment:
    • Atorgat el — data que s'aplicarà a tots els atorgaments (per defecte, avui)
    • Caduca — data de caducitat opcional per a tots els atorgaments
    • Envia correu — si s'envia automàticament un correu a cada destinatari després de crear-ne l'atorgament
  5. Prem Següent.

Pas 2: Pujar CSV

Atorgaments massius — pas 2, pujada

Format CSV

El fitxer CSV ha de disposar de dues columnes: name i email. La primera fila ha de ser una capçalera.

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

Baixar plantilla

Prem Baixa plantilla per obtenir un CSV buit amb les capçaleres correctes. Emplena'l amb els destinataris i puja'l.

Pujada

  1. Prem Puja CSV o arrossega i deixa anar el fitxer.
  2. El fitxer es valida abans d'iniciar el processament.

Regles de validació

Cada fila es valida:

  • name ha de tenir almenys 5 caràcters
  • email ha de ser una adreça vàlida
  • Els correus duplicats dins del fitxer queden assenyalats
  • Les files buides s'ometen

Si es detecten errors de validació, es mostren indicant els números de fila. Corregeix les incidències al CSV i torna a pujar-lo.

  1. Prem Següent per iniciar el processament.

Pas 3: Processament

Un cop iniciat el processament, veuràs una barra de progrés i l'estat en viu:

  • Barra de progrés — indica el percentatge de files processades
  • Fila actual — quina fila es processa ara
  • Recompte d'èxits — quants atorgaments s'han creat
  • Recompte d'errors — quantes files han fallat

Pausar i reprendre

  • Prem Pausa per aturar temporalment el processament. Mentre està en pausa, no es creen nous atorgaments.
  • Prem Reprèn per continuar des del punt en què s'havia aturat.

Cancel·lar

  • Prem Cancel·la per aturar del tot el processament. Els atorgaments ja creats es conserven.

Gestió d'errors

Quan una fila falla (p. ex. dades invàlides, quota mensual assolida):

  • L'error queda registrat amb detalls
  • El processament continua amb la fila següent automàticament
  • Les files fallides s'arrepleguen per al pas de resultats

Recuperació després de recarregar

Si tanques el navegador per accident o recarregues la pàgina durant el processament, la sessió massiva es recupera en tornar. El progrés continua des del punt en què s'havia aturat.

Pas 4: Resultats

Un cop completat (o cancel·lat) el processament, la pantalla de resultats mostra:

  • Total processat — nombre de files intentades
  • Reeixits — nombre d'atorgaments creats
  • Fallits — nombre de files que han fracassat

Baixar informes

  • Baixa CSV d'èxits — un CSV amb tots els atorgaments creats, els destinataris, els correus i les URL de verificació
  • Baixa CSV de fallades — un CSV amb totes les files fallides i els detalls de l'error

Reintent de fallades

Si algunes files han fallat, pots baixar el CSV de fallades, corregir les incidències i tornar a pujar-lo com a nou atorgament massiu per reintentar amb aquells destinataris.

badges.ninja Documentation