Credencials massives

Les credencials massives et permeten emetre insígnies a centenars o milers de destinataris alhora 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 de credencials massives segueix quatre passos:

1. Configurar — selecciona la insígnia i les opcions
2. Pujar — prepara i puja el fitxer CSV
3. Processar — supervisa el progrés mentre es creen les credencials
4. Resultats — revisa els resultats i descarrega els informes

Pas 1: Configurar

1. Obre la pàgina Credencials massives des de la barra lateral (té la seva pròpia ruta, separada de la pàgina Credencials).
2. Selecciona la insígnia que vols emetre amb el selector d'insígnies.
3. Opcionalment, configura:
   • Emesa el — la data que s'utilitzarà per a totes les credencials (per defecte, avui)
   • Caduca — data de caducitat opcional per a totes les credencials
   • Envia un correu — si s'ha d'enviar automàticament un correu a cada destinatari després de crear la seva credencial
4. Fes clic a Següent.

Pas 2: Pujar el CSV

Format del CSV

El fitxer CSV ha de tenir una columna name i una columna email, amb una fila de capçalera. Els noms de les capçaleres no distingeixen majúscules de minúscules, i recipient_name / recipient_email s'accepten com a àlies de name / email.

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

Descarregar la plantilla

Fes clic a Descarrega la plantilla per obtenir un fitxer CSV en blanc amb les capçaleres correctes. Omple'l amb els teus destinataris i puja'l.

Pujada

1. Fes clic a Puja el CSV o arrossega i deixa anar el fitxer.
2. El fitxer es valida abans que comenci el processament.

Regles de validació

Cada fila es valida tan bon punt s'analitza el fitxer:

• El nom ha de tenir almenys 5 caràcters
• El correu electrònic ha de ser una adreça vàlida
• Les files buides s'ometen

La taula de previsualització mostra cada fila amb una marca verda o un motiu en vermell. Les files no vàlides no són un impediment: simplement s'ometen, i el comptador indica quants destinataris vàlids es processaran (p. ex. «18 destinataris vàlids, 2 no vàlids (s'ometran)»). Pots continuar sempre que almenys una fila sigui vàlida; no cal corregir i tornar a pujar el fitxer abans.

3. Fes clic a Següent per començar el processament.

Pas 3: Processament

Quan comença el processament, veuràs una barra de progrés i comptadors en directe:

• Barra de progrés — el percentatge de files processades
• Creades — quantes credencials s'han creat
• Fallides — quantes files han fallat
• Restants — quantes files són encara a la cua

Les taules en directe Creades, Fallides i Pendents s'omplen sota la barra mentre s'executa el lot.

Pausa i represa

• Fes clic a Pausa per aturar temporalment el processament. Mentre està en pausa no es creen noves credencials.
• Fes clic a Reprèn per continuar des d'on ho havies deixat.

Cancel·lació

• Fes clic a Cancel·la per aturar del tot el processament. Les credencials ja creades es conserven.

Gestió d'errors

Quan una fila falla per un motiu específic de la fila (p. ex. un valor no vàlid que el backend rebutja):

• L'error es registra per a aquella fila
• El processament continua automàticament amb la fila següent
• Les files fallides es recullen per al pas de resultats, amb el text de l'error a la taula de fallades en pantalla

Les files limitades per la taxa de peticions es tornen a intentar automàticament amb una breu espera. Un error de crèdits o de quota és diferent: en lloc de saltar endavant, el lot es posa en pausa perquè no gastis la resta del fitxer. Apareix un avís vermell «Crèdits insuficients»; recarrega crèdits o millora el pla i després fes clic a Reprèn per continuar des d'on s'havia aturat.

Recuperació en refrescar la pàgina

Si tanques el navegador o refresques la pàgina per accident durant el processament, la sessió de credencials massives es recupera quan hi tornis. El progrés continua des d'on s'havia aturat.

Pas 4: Resultats

Quan el processament acaba (o es cancel·la), la pantalla de resultats mostra quatre targetes de resum:

• Total — nombre de destinataris del lot
• Creades — nombre de credencials creades
• Fallides — nombre de files que han fallat
• Omeses — destinataris no processats (p. ex. les files restants després d'una cancel·lació)

Sota les targetes, una taula Creades llista cada credencial nova amb un enllaç per veure-la, i una taula Fallides llista les errades amb el text de l'error.

Descarregar informes

• Descarrega el CSV de resultats — totes les files del lot, amb les columnes row, name, email, status, award_url (l'URL de la credencial s'omple per a les files creades).
• Descarrega el CSV de fallades — només les files fallides, amb les columnes name, email, error.

Reintentar les fallades

Si algunes files han fallat, fes clic a Reintenta les fallades. Això inicia una nova passada només amb els destinataris fallits; no cal tornar a pujar cap CSV. Va bé després de resoldre un problema temporal, com ara recarregar crèdits després d'un lot en pausa.