Records one attempt at sending a single email, successful or not. A new row is written per attempt, so an email which was retried has several, and the status together with the logs captured during the send is how a failure is diagnosed. These rows are not second level cached, so they are always read from the database.
Group: Database Entities
Implements: Serializable
Properties
| Property | Returns | Description |
|---|---|---|
| emailItem | EmailItem | The email this attempt was made for. Never null, and one email may have several attempts against it. |
| id | long | Database identifier for this send attempt, assigned when the row is first saved. |
| logs | String | Log output captured while the email was being sent, limited to 2000 characters. This is the main clue to why an attempt failed, and is null when nothing was captured. |
| status | String | Outcome of the attempt as a short code, where c means completed, p means pending and f means failed. The column allows up to 1000 characters, so a failure may carry a longer explanation. |
| statusDate | Date | When the status was last set, which is the time the attempt reached its current outcome. Always populated. |
Methods
getId()
Returns: long
Database identifier for this send attempt, assigned when the row is first saved.
getEmailItem()
Returns: EmailItem
The email this attempt was made for. Never null, and one email may have several attempts against it.
getStatus()
Returns: String
Outcome of the attempt as a short code, where c means completed, p means pending and f means failed. The column allows up to 1000 characters, so a failure may carry a longer explanation.
getStatusDate()
Returns: Date
When the status was last set, which is the time the attempt reached its current outcome. Always populated.
getLogs()
Returns: String
Log output captured while the email was being sent, limited to 2000 characters. This is the main clue to why an attempt failed, and is null when nothing was captured.