Gestion de la file d'attente
Surveillez le statut d'envoi, diagnostiquez les erreurs et gérez votre file d'attente d'e-mails.
La Gestion de la file d'attente vous permet de suivre la progression de vos tâches de génération PDF et d'envoi d'e-mails. Elle offre une vue détaillée de chaque tâche, du statut global du profil jusqu'aux éléments individuels.
Présentation
Le système de gestion de la file d'attente est organisé en quatre niveaux pour vous aider à identifier les problèmes :
- Liste des profils : Vue d'ensemble de tous les profils et de leur activité récente.
- Liste des lots : Historique des imports (fichiers) pour un profil spécifique.
- Liste de la file : Éléments individuels (destinataires) au sein d'un lot.
- Détails de l'élément : Données détaillées et statut d'un élément unique.
1. Liste des profils (Vue d'ensemble)
La vue principale affiche une carte pour chaque Profil configuré.
- Statistiques : Chaque carte visualise le statut des éléments des 30 derniers jours.
- Erreur : Éléments en échec (génération PDF, envoi ou import).
- En attente : Éléments en attente de traitement (génération PDF).
- PDF Généré : Éléments avec PDF générés, en attente d'envoi.
Action : Cliquez sur une carte de profil (ou l'icône Éditer) pour afficher sa Liste des lots.
2. Liste des lots (Historique)
Cette liste affiche chaque fichier importé pour le profil sélectionné.
- Nom du lot : Correspond au nom de fichier du CSV importé.
- Date d'import : Permet de distinguer plusieurs imports du même fichier.
- Colonnes de statut :
- Total : Nombre total d'éléments dans le lot.
- Erreur : Total des échecs.
- En attente : En attente de génération PDF.
- PDF Généré : PDF générés, en attente d'envoi.
- Envoyé : Envoyé avec succès.
Action : Cliquez sur l'icône Éditer d'une ligne de lot pour afficher sa Liste de la file.
3. Liste de la file (Éléments)
Cette vue liste chaque destinataire individuel du lot sélectionné.
Fonctionnalités
- Recherche : Vous pouvez rechercher par destinataire (À), statut, message d'erreur ou contenu de données (JSON).
- Filtre : Utilisez le menu déroulant pour afficher uniquement certains statuts (ex : « Erreur » uniquement).
- Supprimer le lot : Le bouton Supprimer le Lot permet de supprimer l'intégralité de l'historique du lot.
Définitions des statuts
| Statut | Valeur interne | Description |
|---|---|---|
| En attente | pending | En attente de génération PDF par le système. |
| PDF Généré | pdf_generated | Le PDF a été créé avec succès. En attente d'envoi. |
| Envoyé | sent | L'e-mail a été transmis avec succès au serveur SMTP. |
| Erreur (Import) | error_import | L'import des données a échoué pour cet élément. |
| Erreur (PDF) | error_pdf | La génération PDF a échoué. |
| Erreur (E-mail) | error_email | L'envoi de l'e-mail a échoué (nouvelle tentative possible). |
| Erreur (E-mail Fatal) | error_email_fatal | L'envoi de l'e-mail a échoué de manière permanente (ex : adresse invalide). |
Messages d'erreur courants
Les erreurs suivantes peuvent apparaître dans la colonne Message d'Erreur ou dans la Liste d'Erreurs du lot :
Erreurs d'envoi d'e-mails
MISSING_TO_RECIPIENT: L'adresse « À » est vide. Vérifiez votre configuration de mappage.INVALID_EMAIL_FORMAT: Le format de l'adresse e-mail est invalide.BACKEND_CONNECTION_FAILED: Impossible de se connecter au serveur SMTP. Vérifiez votre connexion Internet ou votre VPN.SMTP_AUTH_ERROR: L'authentification SMTP a échoué. Vérifiez votre nom d'utilisateur et votre mot de passe.RETRY_LIMIT_REACHED_SKIP: Le système a abandonné après le nombre maximum de tentatives et a ignoré cet élément.RETRY_LIMIT_REACHED_ABORT: Le système a abandonné après le nombre maximum de tentatives et a interrompu le lot.
Erreurs d'import et de traitement
TEMPLATE_FILE_NOT_FOUND: Le fichier modèle PDF configuré est absent de l'espace de travail.MISSING_MASTER_LOOKUP_VALUE: L'élément n'a pas de valeur pour la clé de recherche (ex : l'ID client est vide), les données maîtres n'ont donc pas pu être récupérées.CSV_DATA_EMPTY_OR_UNREADABLE: Le fichier CSV importé était vide ou corrompu.
4. Détails de l'élément (Modifier et réessayer)
Cliquer sur l'icône Éditer d'un élément vous permet de modifier ses données ou de relancer un processus en échec.
Modifier les données
Vous pouvez corriger les adresses e-mail (À, CC, CCI) si elles ont été importées incorrectement.
Avertissement de cohérence des données
Champs de saisie vs JSON des données maîtres
Les champs À/CC/CCI à gauche sont séparés du JSON des Données Maîtres Client à droite.
- Les champs de saisie contrôlent où l'e-mail est envoyé pour cette tentative spécifique.
- Les données JSON sont utilisées pour la génération PDF et le rendu du modèle.
- Modifier l'un ne met pas automatiquement à jour l'autre. Si vous devez corriger une adresse e-mail pour l'envoi, mettez à jour le champ de saisie.
Modifier le statut (réessayer)
Le statut ne change pas automatiquement lors de l'enregistrement. Vous devez sélectionner manuellement le statut approprié pour déclencher une nouvelle tentative :
- En attente : Sélectionnez ce statut pour supprimer le PDF actuel et tenter de le régénérer (ex : après correction des données JSON).
- PDF Généré : Sélectionnez ce statut pour réessayer l'envoi du PDF existant (ex : après correction d'une adresse e-mail).
Modifier le JSON
Vous pouvez éditer directement les Données du Contenu du Document et les Données Maîtres Client.
Syntaxe JSON
Soyez extrêmement prudent lors de l'édition du JSON. Vous devez maintenir une syntaxe valide, incluant les guillemets doubles (""), les virgules (,) et les crochets/accolades ([], {}). Un JSON invalide provoquera un nouvel échec du processus.