Skip to content

Credenziali massive

Le credenziali massive permettono di rilasciare credenziali a centinaia o migliaia di destinatari in una volta sola caricando un file CSV. Il processo è articolato in quattro passi con monitoraggio dell'avanzamento integrato, pausa/ripresa e gestione degli errori.

Panoramica

Il processo massivo segue quattro passi:

  1. Configurare — scegli la credenziale e le opzioni
  2. Caricare — prepara e carica il file CSV
  3. Elaborare — monitora l'avanzamento durante la creazione delle credenziali
  4. Risultati — rivedi l'esito e scarica i report

Passo 1: Configurare

Rilasci massivi — passo 1, configura

  1. Apri la pagina Credenziali dalla barra laterale.
  2. Premi Credenziale massiva.
  3. Scegli la credenziale da rilasciare mediante il selettore.
  4. Configura facoltativamente:
    • Rilasciato il — data da applicare a tutte le credenziali (default: oggi)
    • Scade — data di scadenza facoltativa per tutte le credenziali
    • Invia e-mail — se inviare automaticamente un'e-mail a ciascun destinatario dopo la creazione della credenziale
  5. Premi Avanti.

Passo 2: Caricare il CSV

Rilasci massivi — passo 2, carica

Formato CSV

Il file CSV deve presentare due colonne: name ed email. La prima riga dovrà essere un'intestazione.

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

Scaricare il modello

Premi Scarica modello per ottenere un CSV vuoto con le intestazioni corrette. Compilalo con i destinatari e caricalo.

Caricamento

  1. Premi Carica CSV oppure trascina il file.
  2. Il file viene validato prima dell'avvio dell'elaborazione.

Regole di validazione

Ogni riga viene validata:

  • name deve contenere almeno 5 caratteri
  • email deve essere un indirizzo valido
  • Le e-mail duplicate all'interno del file vengono segnalate
  • Le righe vuote vengono ignorate

Se vengono individuati errori di validazione, vengono mostrati con i numeri di riga. Correggi le anomalie nel CSV e ricaricalo.

  1. Premi Avanti per avviare l'elaborazione.

Passo 3: Elaborazione

Una volta avviata l'elaborazione vedrai una barra di avanzamento e lo stato in tempo reale:

  • Barra di avanzamento — indica la percentuale di righe elaborate
  • Riga corrente — quale riga viene elaborata in questo momento
  • Conteggio successi — quante credenziali sono state create
  • Conteggio errori — quante righe hanno fallito

Sospendere e riprendere

  • Premi Sospendi per fermare temporaneamente l'elaborazione. Mentre è sospesa non vengono create nuove credenziali.
  • Premi Riprendi per proseguire dal punto d'arresto.

Annullare

  • Premi Annulla per interrompere del tutto l'elaborazione. Le credenziali già create vengono conservate.

Gestione degli errori

Quando una riga fallisce (es. dati non validi, quota mensile raggiunta):

  • L'errore viene registrato con dettagli
  • L'elaborazione prosegue automaticamente sulla riga successiva
  • Le righe fallite vengono raccolte per il passo dei risultati

Recupero dopo l'aggiornamento della pagina

Se chiudi per errore il browser oppure aggiorni la pagina durante l'elaborazione, la sessione di credenziali massive viene ripristinata al rientro. L'avanzamento riprende dal punto in cui si era fermato.

Passo 4: Risultati

Al termine dell'elaborazione (o dopo un annullamento), la schermata dei risultati mostra:

  • Totale elaborate — righe tentate
  • Riuscite — credenziali create
  • Fallite — righe che hanno fallito

Scaricare i report

  • Scarica CSV dei successi — un CSV di tutte le credenziali create con nomi, e-mail e URL di verifica
  • Scarica CSV dei fallimenti — un CSV di tutte le righe fallite con i dettagli dell'errore

Riprovare i fallimenti

Se alcune righe hanno fallito, puoi scaricare il CSV dei fallimenti, correggere le anomalie e ricaricarlo come nuove credenziali massive per riprovare con quei destinatari.

badges.ninja Documentation