כשמסמך נוסף לאוסף, התוסף אוסף אותו לאימיילים
לפני המסירה. התוסף יוצר ומעדכן את השדה delivery במסמך בזמן שהוא מעבד את האימייל.
עיבוד שליחת אימיילים
אפשר לאכלס את השדה delivery בשדות הבאים:
- מדינה (State): אחת מהאפשרויות הבאות:
PENDING,PROCESSING,SUCCESSאוERROR. - startTime: חותמת הזמן של תחילת עיבוד האימייל.
- endTime: חותמת הזמן של סיום עיבוד האימייל (כלומר, הסתיים במצב
SUCCESSאוERROR). - שגיאה: אם הייתה שגיאה בשליחת האימייל, תופיע כאן הודעת שגיאה.
- ניסיונות: מספר ניסיונות השליחה של הודעת האימייל הזו.
- leaseExpireTime: במקרה של תקלה או זמן קצוב לתפוגה, השעה שבה מצב
PROCESSINGצריך להיחשב כשגיאה. - info: לאחר שליחת אימייל בהצלחה (לכתובת אחת לפחות), השדה הזה יאוכלס בשדות הבאים:
- messageId: מזהה ההודעה של האימייל שנמסר.
- קביל: מערך של כתובות אימייל שאליהן הודעת האימייל נשלחה בהצלחה.
- rejected: מערך של כתובות אימייל שלא ניתן היה לשלוח אליהן את האימייל.
- pending: מערך של כתובות אימייל שנדחו באופן זמני על ידי SMTP.
- תגובה: התגובה האחרונה משרת ה-SMTP.
אימייל יעבור בדרך כלל מ-PENDING אל PROCESSING אל SUCCESS או
ERROR אחרי המעבר למצב SUCCESS או ERROR, יבוצעו שינויים נוספים
המסמך לא יפעיל את התוסף כך שישלח אימייל נוסף. כדי לשלוח מחדש
אימייל עם עדכוני מסמכים, אפשר לשנות את state לPENDING או לRETRY.
ניסיונות חוזרים ידניים
יש מקרים שבהם מסירת האימייל נכשלה באופן שניתן לשחזר, או
את המסמך ניתן לתקן ידנית כדי למסור אותו בצורה תקינה
שינויים. למרות שניסיונות חוזרים אינם אוטומטיים, ניתן לשנות באופן ידני
state בשדה delivery אל RETRY כדי שהתוסף ינסה לשלוח אימייל
יישלח שוב (וכך יגדל המספר של attempts).