Gérer l'état de distribution avec l'extension Trigger Email (Adresse e-mail de déclenchement)

Lorsqu'un document est ajouté à la collection, l'extension le récupère pour le traitement de l'envoi d'e-mails. L'extension crée et met à jour un champ delivery dans le document pendant le traitement de l'e-mail.

Traitement de la distribution des e-mails

Le champ delivery peut être renseigné avec les champs suivants:

  • state:PENDING, PROCESSING, SUCCESS ou ERROR.
  • startTime:code temporel du début du traitement des e-mails.
  • endTime:code temporel indiquant la fin du traitement des e-mails (c'est-à-dire qu'il s'est terminé dans un état SUCCESS ou ERROR).
  • error:si une erreur s'est produite lors de l'envoi de l'e-mail, un message d'erreur s'affiche ici.
  • attempts:nombre de tentatives de distribution de cet e-mail.
  • leaseExpireTime:en cas de blocage ou de délai avant expiration, heure à laquelle un état PROCESSING doit être considéré comme une erreur.
  • info:une fois l'envoi de l'e-mail réussi (à au moins une adresse), les champs suivants sont renseignés dans ce champ :
    • messageId:ID du message de l'e-mail envoyé.
    • accepted:tableau d'adresses e-mail auxquelles l'e-mail a bien été envoyé.
    • rejected:tableau d'adresses e-mail auxquelles l'e-mail n'a pas pu être distribué.
    • pending:tableau d'adresses e-mail temporairement rejetées par le SMTP.
    • response:dernière réponse du serveur SMTP.

Un e-mail passe généralement de PENDING à PROCESSING, puis à SUCCESS ou à ERROR. Une fois dans l'état SUCCESS ou ERROR, les modifications supplémentaires apportées au document ne déclencheront pas l'envoi d'un autre e-mail par l'extension. Pour renvoyer un e-mail contenant des mises à jour de document, vous pouvez remplacer state par PENDING ou RETRY.

Nouvelles tentatives manuelles

Il arrive que la distribution des e-mails échoue de manière récupérable ou que le document puisse être corrigé manuellement pour une distribution appropriée avec des modifications mineures. Bien que les nouvelles tentatives ne soient pas automatiques, vous pouvez remplacer manuellement state dans le champ delivery par RETRY pour que l'extension tente de nouveau d'envoyer l'e-mail (et augmente le nombre de attempts).