Open Message

This Email tool extracts all of the data from an indexed message.

Inputs

Folder ID

The unique identifier for the folder containing the message. This ID is retrieved with an Incoming Mail initiator, or the Open Folder tool.

Index

The zero-based index of a message within the given folder. The index denotes the location of the message within the specified folder. The value for this parameter is generated by the Incoming Mail initiator or the Find Message tool.

Timeout 

The number of seconds the tool should wait for a return value. If no value is returned in the specified time, this tool will take the Failure exit path.

Outputs

Status

The status of the message, can be "read" or "unread."

Sender

The sender of the message.

Subject 

The subject of the message.

Importance 

The importance (low, high, or normal) of the message.

Sensitivity

The sensitivity (private, confidential, or none) of the message.

Date/Time Received 

The date and time (in UTC) the message was received.

To Recipients

The display addresses of the message's primary recipients.

CC Recipients

The display addresses of the message's secondary recipients. 

Reply To

The recipients to whom replies should be sent.

Body

A List of Email Body type. The body text of the message. This contains the entire body, not just the body of the last reply.

Attachment Files

The full path names of the extracted attachment files. Attachments that are not files (i.e., Links or OLE objects) are represented by empty strings in this list.

Notes: Once an attachment has been copied into a file, the file is owned by the handler. The Open Message tool will not delete the file or clean it up in any way.

Note: OLE attachments (e.g. bitmaps rendered inline) are not visible, as attachments or otherwise, to handlers. As far as the handler tools are concerned, and email message consists of a text body and zero or more *file* attachments. Other sorts of attachments, such as embedded OLE objects and "nested" messages, are not accessible through the handler tools, since they are not supported or easily simulated on messaging systems other than Exchange (i.e. IBM Notes or IMAP).

Attached Messages 

The messages attached to the message.

Message Class 

The class (text, voice, fax, or ndr) of the message.

Cookie 

The cookie of the message.

Result

The results of the operation.

See Email Tool Result Codes for more information.

Exit Paths

Success

If this step executes successfully, this step takes the Success exit path.

Failure

If this step does not execute successfully, this step takes the Failure exit path.