cfimap
9
3

Overview ColdFusion Open BlueDragon Lucee

Queries an IMAP server to retrieve and manage mails within multiple folders.

Attributes

Name Required Type Default Description
9
3
action No String getheaderonly * GetHeaderOnly - Returns the message header information for all retrieved mail.* GetAll - Returns mail. The information includes the message header information, message text, and any attachments. Set the AttachmentPath attribute to retrieve attachments.* Delete - Deletes messages from a folder.* Open - Initiates an open session or connection with the IMAP server.* Close - Terminates the open session or connection with the IMAP server.* MarkRead - Marks all messages read from a folder.* DeleteFolder - Deletes the identified folder.* CreateFolder - Creates a folder in Inbox.* RenameFolder - Renames an existing user-defined folder.* ListAllFolders - Displays a list of all existing folders in the mailbox or under the folder name defined by the Folder attribute.* MoveMail - Moves mail from one folder to another
9
3
attachmentpath No String Required for GetAll action - Specifies the name of the folder where ColdFusion retrieves attachments. If this folder does not exist, ColdFusion creates it.
9
connection No String Required for the following actions: Open and Close - Specifies the variable name for the connection/session. For example, the e-mail login to an IMAP server can be used as the value for the connection. If the server attribute has an invalid IP address or invalid domain name, then the connection fails and ColdFusion returns an error message.
4
debug No this attribute is deprecated and ignored, log control happens via the logging framwork directly.
9
folder No String For mail actions: Specifies the folder name where messages are searched, retrieved, moved, or deleted. If folder name is invalid, ColdFusion defaults to INBOX.For folder actions: Specifies the folder name that is deleted (DeleteFolder) or created (CreateFolder) or renamed (RenameFolder).
9
3
generateUniqueFileNames No Boolean Ensures that unique file names are generated for each attachment file. The goal is to avoid name conflicts for attachments that have the same filename.
9
3
maxrows No Numeric Specifies the number of rows to be marked as read, deleted, or moved across folders. When the value is 1, it signals the row determined by StartRow. Any incremental value marks rows starting from the StartRow.If you have specified the UID or MessageNumber attribute, then MaxRows is ignored.
9
3
messageNumber No String Specifies the message number or a comma delimited list of message numbers for retrieval, deletion, marking mail as read, or moving mails.If you set an invalid message number or range, then it is ignored. If you have specified the UID attribute, then MessageNumber attribute is ignored.
11
messagenumeric No String No Help Available
9
3
name No String Specifies the name for the query object that contains the retrieved message information.
9
newFolder No String Specifies the name of the destination folder where all mail move.
9
3
password No String Specifies the password for assessing the users’ e-mail account.
9
3
port No Numeric Specifies the IMAP port number. Use 993 for secured connections.
9
recurse No Boolean Specifies whether ColdFusion runs the CFIMAP command in subfolders.
9
secure No Boolean Specifies whether the IMAP server uses a Secure Sockets Layer.
9
3
server No String Specifies the IMAP server identifier. You can assign a host name or an IP address as the IMAP server identifier. For example, imap.gmail.com.
9
3
startRow No Numeric Defines the first row number for reading or deleting. If you have specified the UID or MessageNumber attribute, then StartRow is ignored. You can also specify StartRow for moving mails.
9
stoponerror No Boolean Specifies whether or not to ignore the exceptions for this operation. When the value is true, it stops processing, displays an appropriate error.
9
3
timeout No Numeric Specifies the number of seconds to wait before timing out connection to IMAP server. An error message is displayed when timeout occurs.
9
3
uid No String Specifies the unique ID or a comma-delimited list of Uids to retrieve or delete. If you set invalid Uids, then they are ignored.
9
3
username No String Specifies the user name. Typically, the user name is same the e-mail login.