Lorsqu'un document est ajouté à la collection, l'extension le récupère pour le traitement de l'envoi par e-mail. L'extension crée et met à jour un champ delivery
dans le document lorsqu'elle traite l'e-mail.
Traitement de la distribution des e-mails
Le champ delivery
peut être renseigné avec les champs suivants :
- state : l'une des valeurs
PENDING
,PROCESSING
,SUCCESS
ouERROR
. - startTime : code temporel indiquant le début du traitement de l'e-mail.
- endTime : code temporel indiquant la fin du traitement de l'e-mail (c'est-à-dire l'état
SUCCESS
ouERROR
). - error : si une erreur de distribution d'e-mail s'est produite, un message d'erreur s'affiche ici.
- attempts : nombre de tentatives de distribution pour 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'e-mail envoyé (à au moins une adresse), ce champ est renseigné avec les champs suivants :
- messageId : ID du message de l'e-mail remis.
- accepted : tableau des adresses e-mail auxquelles l'e-mail a bien été envoyé.
- rejected : tableau des adresses e-mail auxquelles l'e-mail n'a pas pu être envoyé.
- pending : tableau des adresses e-mail qui ont été temporairement refusées par SMTP.
- response : dernière réponse du serveur SMTP.
Un e-mail est généralement envoyé de PENDING
à PROCESSING
, puis à SUCCESS
ou ERROR
. Une fois l'état SUCCESS
ou ERROR
atteint, les modifications supplémentaires apportées au document ne déclenchent pas l'envoi d'un autre e-mail par l'extension. Pour renvoyer un e-mail contenant des mises à jour de documents, vous pouvez remplacer state
par PENDING
ou RETRY
.
Nouvelles tentatives manuelles
Dans certains cas, l'envoi d'e-mails échoue de manière récupérable ou le document peut être corrigé manuellement pour être envoyé correctement avec des modifications mineures. Les nouvelles tentatives ne sont pas automatiques, mais vous pouvez modifier manuellement la valeur state
dans le champ delivery
pour la remplacer par RETRY
. L'extension tentera alors d'envoyer l'e-mail à nouveau (et incrémentera le nombre de attempts
).