MACROMEDIA COLDFUSION MX 61-CFML Reference page 268

Attribute Req/Opt
action Optional
name Required if
"getAll"
"getHeaderOnly"
message
Number
uid
attachment Optional
Path
timeout Optional
maxRows Optional
startRow Optional
generate Optional
Unique
Filenames
Usage
The tag retrieves one or more mail messages from a POP server and populates a
cfpop
ColdFusion query object with the resulting messages, one message per row. Alternatively, it
deletes one or more messages from the POP server.
To optimize performance, two retrieve options are available. Message header information is
typically short, and therefore quick to transfer. Message text and attachments can be very long,
and therefore take longer to process.
268 Chapter 2: ColdFusion Tags
Default
getHeaderOnly • getHeaderOnly: returns message header
action =
or
60
retrieves all
available rows
1
No
Description
information only
• getAll: returns message header information,
message text, and attachments if
attachmentPath is specified
• delete: deletes messages on POP server
Name for query object that contains the
retrieved message information.
Message number or comma-delimited list of
message numbers to get or delete. Invalid
message numbers are ignored.
Ignored if is specified.
uid
UID or a comma-delimited list of UIDs to get
or delete. Invalid UIDs are ignored..
If , specifies a directory in
action="getAll"
which to save any attachments. If the
directory does not exist, ColdFusion creates
it.
If you omit this attribute, ColdFusion does not
save any attachments. If you specify a relative
path, the path root is the ColdFusion
temporary directory, which is returned by the
function..
GetTempDirectory
Maximum time, in seconds, to wait for mail
processing.
Number of messages to return or delete,
starting with the number in
if or
messageNumber uid
First row number to get or delete. Ignored if
or is specified,
messageNumber uid
• Yes: Generate unique filenames for files
attached to an e-mail message, to avoid
naming conflicts when files are saved
• No
. Ignored
startRow
is specified,