使用「觸發電子郵件」擴充功能管理傳送狀態

當文件新增至珍藏內容時,擴充功能就會將其選取,以便處理電子郵件傳送作業。擴充功能會在處理電子郵件時,在文件中建立及更新 delivery 欄位。

處理電子郵件傳送作業

delivery 欄位可填入下列欄位:

  • state:PENDINGPROCESSINGSUCCESSERROR 其中之一。
  • startTime:電子郵件處理作業開始的時間戳記。
  • endTime:電子郵件處理作業完成的時間戳記 (也就是在 SUCCESSERROR 狀態下結束)。
  • error:如果發生電子郵件傳送錯誤,系統會在這裡填入錯誤訊息。
  • attempts:這封電子郵件嘗試傳送的次數。
  • leaseExpireTime:如果發生掛起或逾時情形,系統應將 PROCESSING 狀態視為錯誤的時間。
  • info:成功傳送電子郵件 (至少傳送至一個地址) 後,系統會在這個欄位填入下列欄位:
    • messageId:已送達電子郵件的郵件 ID。
    • accepted: 電子郵件成功送達的電子郵件地址陣列。
    • rejected: 無法傳送電子郵件的電子郵件地址陣列。
    • pending:SMTP 暫時拒絕的電子郵件地址陣列。
    • response:SMTP 伺服器的最後回應。

電子郵件通常會從 PENDING 傳送至 PROCESSING,再傳送至 SUCCESSERROR。一旦進入 SUCCESSERROR 狀態,文件的其他變更就不會觸發擴充功能傳送其他電子郵件。如要重新傳送含有文件更新內容的電子郵件,請將 state 變更為 PENDINGRETRY

手動重試

在某些情況下,電子郵件無法正常傳送,但可以透過手動修正方式,讓文件以適當的方式傳送。雖然重試不會自動執行,但您可以手動將 delivery 欄位中的 state 變更為 RETRY,讓擴充功能再次嘗試傳送電子郵件 (並增加 attempts 的數量)。