Credenziali in blocco

Le credenziali in blocco ti permettono di rilasciare badge a centinaia o migliaia di destinatari in una volta sola caricando un file CSV. Il processo si articola in quattro passaggi, con monitoraggio dell'avanzamento, pausa/ripresa e gestione degli errori integrati.

Panoramica

Il processo di credenziali in blocco segue quattro passaggi:

1. Configura — seleziona il badge e le opzioni
2. Carica — prepara e carica il file CSV
3. Elabora — monitora l'avanzamento mentre le credenziali vengono create
4. Risultati — controlla gli esiti e scarica i report

Passaggio 1: Configura

1. Apri la pagina Credenziali in blocco dalla barra laterale (ha una propria route, separata dalla pagina Credenziali).
2. Seleziona il badge che vuoi rilasciare con il selettore di badge.
3. Facoltativamente, configura:
   • Rilasciata il — la data da usare per tutte le credenziali (predefinita: oggi)
   • Scadenza — data di scadenza facoltativa per tutte le credenziali
   • Invia email — se inviare automaticamente un'email a ciascun destinatario dopo la creazione della sua credenziale
4. Fai clic su Avanti.

Passaggio 2: Carica il CSV

Formato CSV

Il file CSV deve avere una colonna name e una colonna email, con una riga di intestazione. I nomi delle intestazioni non distinguono tra maiuscole e minuscole, e recipient_name / recipient_email sono accettati come alias di name / email.

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

Scarica il modello

Fai clic su Scarica modello per ottenere un file CSV vuoto con le intestazioni corrette. Compilalo con i tuoi destinatari e caricalo.

Caricamento

1. Fai clic su Carica CSV oppure trascina il file.
2. Il file viene convalidato prima dell'inizio dell'elaborazione.

Regole di convalida

Ogni riga viene convalidata non appena il file è stato analizzato:

• Il nome deve contenere almeno 5 caratteri
• L'email deve essere un indirizzo email valido
• Le righe vuote vengono ignorate

La tabella di anteprima elenca ogni riga con un segno di spunta verde o un motivo in rosso. Le righe non valide non sono un blocco: vengono semplicemente ignorate, e il contatore mostra quanti destinatari validi verranno elaborati (es. "18 valid recipients, 2 invalid (will be skipped)"). Puoi procedere finché almeno una riga è valida; non serve correggere e ricaricare prima.

3. Fai clic su Avanti per avviare l'elaborazione.

Passaggio 3: Elaborazione

Una volta avviata l'elaborazione, vedi una barra di avanzamento e contatori in tempo reale:

• Barra di avanzamento — la percentuale di righe elaborate
• Create — quante credenziali sono state create
• Non riuscite — quante righe non sono andate a buon fine
• Rimanenti — quante righe sono ancora in coda

Le tabelle in tempo reale Create, Non riuscite e In sospeso si riempiono sotto la barra mentre il batch è in esecuzione.

Pausa e ripresa

• Fai clic su Pausa per fermare temporaneamente l'elaborazione. Durante la pausa non vengono create nuove credenziali.
• Fai clic su Riprendi per continuare da dove ti eri fermato.

Annulla

• Fai clic su Annulla per interrompere del tutto l'elaborazione. Le credenziali già create vengono mantenute.

Gestione degli errori

Quando una riga non riesce per un motivo specifico della riga (es. un valore non valido rifiutato dal backend):

• L'errore viene registrato per quella riga
• L'elaborazione prosegue automaticamente con la riga successiva
• Le righe non riuscite vengono raccolte per il passaggio dei risultati, con il testo dell'errore mostrato nella tabella degli errori a schermo

Le righe soggette a limitazione di frequenza vengono ritentate automaticamente con una breve attesa. Un errore di crediti o di quota è diverso: invece di andare avanti, il batch va in pausa per evitare di consumare il resto del file. Compare un avviso rosso "Insufficient credits"; ricarica i crediti o passa a un piano superiore, poi fai clic su Riprendi per continuare da dove si era fermato.

Ripristino dopo l'aggiornamento della pagina

Se chiudi per errore il browser o aggiorni la pagina durante l'elaborazione, la sessione di credenziali in blocco viene ripristinata al tuo ritorno. L'avanzamento riprende da dove si era interrotto.

Passaggio 4: Risultati

Al termine dell'elaborazione (o dopo l'annullamento), la schermata dei risultati mostra quattro schede di riepilogo:

• Totale — numero di destinatari nel batch
• Create — numero di credenziali create
• Non riuscite — numero di righe non riuscite
• Ignorate — destinatari non elaborati (es. le righe rimanenti dopo un annullamento)

Sotto le schede, una tabella Create elenca ogni nuova credenziale con un link per visualizzarla, e una tabella Non riuscite elenca gli errori con il relativo testo.

Scarica i report

• Scarica CSV dei risultati — ogni riga del batch, con le colonne row, name, email, status, award_url (l'URL della credenziale è compilato per le righe create).
• Scarica CSV degli errori — solo le righe non riuscite, con le colonne name, email, error.

Riprova gli errori

Se alcune righe non sono riuscite, fai clic su Riprova gli errori. Si avvia un nuovo passaggio solo sui destinatari non riusciti, senza dover ricaricare un CSV. È utile dopo aver risolto un problema temporaneo, ad esempio la ricarica dei crediti dopo un batch in pausa.