This event is triggered whenever an e-mail message is received by the atg/dynamo/service/POP3Service component.

Class name

atg.userprofiling.dms.InboundEmailMessage

JMS name

atg.dps.InboundEmail

Display name

An email is received

Message scope

Global (collective)

Message source

Component: /atg/userprofiling/DPSMessageSource

Class: atg.userprofiling.dms.DPSMessageSource

Component that calls the message source

/atg/userprofiling/email/EmailManager

How this event is triggered

This event is triggered by the /atg/dynamo/service/POP3Service component when an email is received.

How to turn this event off

Set to false the fireInboundEmailEvents property in the /atg/dynamo/service/POP3Service component.

The message that triggers this event contains the following properties:

Property

Type

Scenario editor label

messageSubject

java.lang.String

messageSubject

The subject line of the message.

Example: An e-mail is received where messageSubject is Enroll me!

originalSubject

java.lang.String

originalSubject

The original subject line of the message. The original subject is the subject line without the word “Re:” that may be added if this e-mail message is a response to another.

Example: An e-mail is received where originalSubject is Come back, we miss you!

In this case, an incoming message with the subject line Re: Come back, we miss you! will trigger this event.

messageFrom

java.lang.String

messageFrom

The e-mail address of the person who sent the message (the “From” field in an e-mail).

Example: An e-mail is received where messageFrom includes atg.com

In this case, the system watches for incoming e-mail from the domain atg.com.

messageTo

java.lang.String[]

messageTo

An array containing the e-mail addresses of the recipients of the message (the “To” field in an e-mail).

messageCc

java.lang.String[]

messageCc

An array containing the e-mail addresses of the recipients included in the “CC” field of the message.

messageRecipients

java.lang.String[]

messageRecipients

An array containing all e-mail addresses in both the “To” and “CC” fields.

messageReplyTo

java.lang.String

messageReplyTo

The Reply-To e-mail address of the message.

receivedDate

java.util.Date

receivedDate

The date on which the message was received by the POP3 server.

bounced

boolean

bounced

Indicates whether the e-mail message is one that was returned because it was sent to an invalid address.

message

javax.mail.Message

message

The javax.mail.Message object that represents the entire contents of the e-mail message.

bouncedEmailAddress

java.lang.String

bouncedEmailAddress

If an e-mail message is bounced, this property is set to the e-mail address of the person to whom the message was sent.

This property is set only if the bounced property is set to true.

bouncedReplyCode

java.lang.String

bouncedReplyCode

The RFC 821 reply code of the bounced e-mail. The reply code indicates why the message was bounced.

This property is set only if the bounced property is set to true.

bouncedStatusCode

java.lang.String

bouncedStatusCode

The enhanced RFC 1893 status code of the bounced e-mail. The status code is similar to the reply code and can give more specific information about the nature of the bounced email.

This property is set only if the bounced property is set to true.

bouncedErrorMessage

java.lang.String

bouncedErrorMessage

A String property indicating why the message was bounced. The String is a mail server-specific interpretation of the enhanced RFC 1893 status code.

This property is set only if the bounced property is set to true.

The four bounced* properties described above can be null even if the bounced property is set. The values of these properties are determined by specific EmailExaminer classes that parse the bounced e-mail messages. Sometimes the values cannot be determined, and in these cases the properties do not get set.

For more information on how the Personalization module detects and handles bounced e-mail messages, refer to Bounced E-mail.


Copyright © 1997, 2012 Oracle and/or its affiliates. All rights reserved.

Legal Notices