Gestione coda
Monitorare lo stato di invio, risolvere errori e gestire la coda email.
Queue Management (Gestione coda) consente di monitorare l'avanzamento delle attività di generazione PDF e invio email. Fornisce una vista dettagliata di ogni processo, dallo stato complessivo del profilo fino ai singoli elementi email.
Panoramica
Il sistema di gestione coda è organizzato in quattro livelli per approfondire i problemi:
- Profile List (elenco profili): Panoramica di tutti i profili e della loro attività recente.
- Batch List (elenco batch): Cronologia delle importazioni (file) per un profilo specifico.
- Queue List (elenco coda): Singoli elementi (destinatari) all'interno di un batch.
- Item Details (dettagli elemento): Dati e stato dettagliati per un singolo elemento.
1. Elenco profili (panoramica)
La vista principale mostra una scheda per ogni profilo configurato.
- Statistiche: Ogni scheda visualizza lo stato degli elementi degli ultimi 30 giorni.
- Error: Elementi falliti (generazione PDF, invio o importazione).
- Pend: Elementi in attesa di elaborazione (generazione PDF).
- PDF Generated: Elementi con PDF generati, in attesa di invio.
Azione: Clicchi sulla scheda del profilo (o sull'icona Edit) per visualizzare il Batch List.
2. Elenco batch (cronologia)
Questo elenco mostra tutti i file importati per il profilo selezionato.
- Batch Name: Corrisponde al nome del file del CSV importato.
- Import Date: Da utilizzare per distinguere tra importazioni multiple dello stesso file.
- Colonne di stato:
- Total: Numero totale di elementi nel batch.
- Error: Totale dei fallimenti.
- Pending: In attesa di generazione PDF.
- PDF Generated: PDF generati, in attesa di invio email.
- Sent: Inviati con successo.
Azione: Clicchi l'icona Edit su una riga di batch specifica per visualizzare il Queue List.
3. Elenco coda (elementi)
Questa vista elenca ogni singolo destinatario all'interno del batch selezionato.
Funzionalità
- Search (ricerca): È possibile cercare per destinatario (To), stato, messaggio di errore o contenuto dati (JSON).
- Filter (filtro): Utilizzi il menu a tendina per mostrare solo stati specifici (es. solo "Error").
- Delete Batch: Il pulsante Delete Batch consente di rimuovere l'intera cronologia del batch.
Definizioni degli stati
| Stato | Valore interno | Descrizione |
|---|---|---|
| Pending | pending | In attesa che il sistema generi il PDF. |
| PDF Generated | pdf_generated | Il PDF è stato creato con successo. In attesa di invio. |
| Sent | sent | L'email è stata consegnata con successo al server SMTP. |
| Error (Import) | error_import | L'importazione dati è fallita per questo elemento. |
| Error (PDF) | error_pdf | La generazione PDF è fallita. |
| Error (Email) | error_email | L'invio email è fallito (ritentabile). |
| Error (Email Fatal) | error_email_fatal | L'invio email è fallito permanentemente (es. indirizzo non valido). |
Messaggi di errore comuni
I seguenti errori possono apparire nella colonna Error Message o nell'Error List del batch:
Errori di invio email
MISSING_TO_RECIPIENT: L'indirizzo "To" è vuoto. Verifichi la configurazione della mappatura.INVALID_EMAIL_FORMAT: Il formato dell'indirizzo email non è valido.BACKEND_CONNECTION_FAILED: Impossibile connettersi al server SMTP. Verifichi la connessione internet o la VPN.SMTP_AUTH_ERROR: Autenticazione SMTP fallita. Verifichi nome utente e password.RETRY_LIMIT_REACHED_SKIP: Il sistema ha rinunciato dopo il numero massimo di tentativi e ha saltato questo elemento.RETRY_LIMIT_REACHED_ABORT: Il sistema ha rinunciato dopo il numero massimo di tentativi e ha interrotto il batch.
Errori di importazione ed elaborazione
TEMPLATE_FILE_NOT_FOUND: Il file modello PDF configurato non è presente nel workspace.MISSING_MASTER_LOOKUP_VALUE: L'elemento non ha un valore per la chiave di ricerca (es. ID Cliente vuoto), quindi i dati master non possono essere recuperati.CSV_DATA_EMPTY_OR_UNREADABLE: Il file CSV importato era vuoto o corrotto.
4. Dettagli elemento (modifica e nuovo tentativo)
Cliccando l'icona Edit su un elemento è possibile modificare i dati o ritentare un processo fallito.
Modifica dei dati
È possibile correggere gli indirizzi email (To, CC, BCC) se sono stati importati in modo errato.
Avviso di coerenza dei dati
Campi di input vs JSON dati master
I campi di input To/CC/BCC a sinistra sono separati dal JSON Customer Master Data a destra.
- I campi di input controllano dove viene inviata l'email per questo specifico tentativo.
- I dati JSON vengono utilizzati per la generazione PDF e il rendering del modello.
- La modifica di uno non aggiorna automaticamente l'altro. Se è necessario correggere un indirizzo email per l'invio, aggiornare il campo di input.
Modifica dello stato (nuovo tentativo)
Lo stato non cambia automaticamente al salvataggio. È necessario selezionare manualmente lo stato appropriato per attivare un nuovo tentativo:
- Pending: Selezioni questo stato per scartare il PDF corrente e tentare di rigenerarlo (es. dopo aver corretto i dati JSON).
- PDF Generated: Selezioni questo stato per ritentare l'invio del PDF esistente (es. dopo aver corretto un indirizzo email).
Modifica del JSON
È possibile modificare direttamente i Document Content Data e i Customer Master Data.
Sintassi JSON
Presti estrema attenzione quando modifica il JSON. È necessario mantenere una sintassi valida, inclusi virgolette doppie (""), virgole (,) e parentesi ([], {}). Un JSON non valido causerà un nuovo fallimento del processo.