Khi một tài liệu được thêm vào bộ sưu tập, tiện ích sẽ chọn tài liệu đó để xử lý việc gửi email. Tiện ích này sẽ tạo và cập nhật trường delivery
trong tài liệu khi xử lý email.
Xử lý việc gửi email
Bạn có thể điền sẵn trường delivery
bằng các trường sau:
- state: Một trong số
PENDING
,PROCESSING
,SUCCESS
hoặcERROR
. - startTime: Dấu thời gian khi quá trình xử lý email bắt đầu.
- endTime: Dấu thời gian khi quá trình xử lý email hoàn tất (tức là kết thúc ở trạng thái
SUCCESS
hoặcERROR
). - error: Nếu có lỗi khi gửi email, thông báo lỗi sẽ xuất hiện ở đây.
- attempts: Số lần gửi email này.
- leaseExpireTime: Trong trường hợp bị treo hoặc hết thời gian chờ, thời gian mà trạng thái
PROCESSING
sẽ được coi là lỗi. - info: Sau khi gửi email thành công (đến ít nhất một địa chỉ), trường này sẽ được điền sẵn các trường sau:
- messageId: Mã nhận dạng thư của email đã gửi.
- accepted: Mảng địa chỉ email mà email đã được gửi thành công.
- rejected: Mảng địa chỉ email mà email không gửi được.
- pending:Mảng địa chỉ email tạm thời bị SMTP từ chối.
- response: Phản hồi cuối cùng từ máy chủ SMTP.
Thông thường, email sẽ được gửi từ PENDING
đến PROCESSING
, rồi đến SUCCESS
hoặc ERROR
. Khi ở trạng thái SUCCESS
hoặc ERROR
, các thay đổi khác đối với tài liệu sẽ không kích hoạt tiện ích gửi email khác. Để gửi lại email có nội dung cập nhật về tài liệu, bạn có thể thay đổi state
thành PENDING
hoặc RETRY
.
Thử lại theo cách thủ công
Trong một số trường hợp, việc gửi email không thành công theo cách có thể khôi phục hoặc bạn có thể sửa đổi tài liệu theo cách thủ công để gửi đúng cách với một số điểm chỉnh sửa nhỏ. Mặc dù các lần thử lại không tự động, nhưng bạn có thể thay đổi state
trong trường delivery
thành RETRY
theo cách thủ công để tiện ích thử lại việc gửi email (và tăng số lượng attempts
).