Find Messages

This Email tool is identical to the Find Message tool except that it will return all matching messages instead of just the first match.

Inputs

Folder ID

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

Status 

Only messages with this status will be searched, can be "read" or "unread".

Importance 

Only messages with this importance will be searched, can be "low", "high", or "normal".

Sensitivity 

Only messages with this sensitivity will be searched, can be "personal", "private", "confidential", or "none".

Message Class

Only messages with this class will be searched, can be "text", "voice", "fax", or "ndr".

Subject

Only messages with this subject will be searched. Uses a regular expression.

Sender 

Only messages from this sender will be searched (friendly name or email address). Uses a regular expression.

Start Date/Time 

Only message received after this date and time will be searched.

End Date/Time 

Only messages received before this date and time will be searched.

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

Indices 

The list of indices of the matching messages.

Result 

The results of the operation.

See Email Tool Result Codes for more information.

Exit Paths

Found

The Found exit path is taken if at least one message matching the search criteria was found.

Not Found

The Not Found path is taken if no matching message was found (so none of the output values are valid).

Failure

This path is taken if the operation fails.