global message rules - actions
Global Message Rules - Actions
Actions in Global Message Rules runs when the Match Expression
is evaluated. There are a number of pre-defined Actions which will help you to
handle messages.
Click Add button next to the Actions pane in Add/Edit Global Rules window which
will bring the main Action dialog.
Following is the summary of the type of
Actions currently supported by the server:
| Action | Description | API | Parameters |
|---|---|---|---|
| Autoresponse | AutoResponse is sent to specified recipient | 1 | Recipient address |
| Delete Message | Deletes message. | 2 | N/A |
| ForwardToEmail | Message is forwarded to specified email | 3 | Forwarding e-mail address |
| ForwardToHost | Message is forwarded to specified host at specified port | 4 | Forwarding Hostname and port |
| StoreToDiskFolder | Message is stored to specified disk folder | 5 | Disk Folder UNC path |
| ExecuteProgram | Execute a script or application with the specified parameters | 6 | Program path and parameters |
| MoveToIMAPFolder | Stores message to specified message folder(for example: Junk). This will take effect only for local recipients and the message will be moved to the destination folder | 7 | IMAP folder name Entering "Trash" would move the message to each user's "Trash" folder. |
| AddHeaderField | Appends specified header field to message headers | 8 | Header name and value |
| RemoveHeaderField | Removes specified header field or fields if there are multiple of them | 9 | N/A |
| SendErrorToClient | Sends error to currently connected client. NOTE: Error text may contain ASCII printable chars only and maximum length is 500. | 10 | Error text in ASCII printable |
| StoreToFTPFolder | Stores message to specified FTP server folder | 11 | FTP server address, port, username, password and folder |
| PostToNNTPNewsGroup | Posts message to specified NNTP newsgroup | 12 | NNTP server address, port, username, password and newsgroup name |
| PostToHTTP | Posts message to specified page via HTTP | 13 | HTTP server address, port, username, password and query string. Please verify the target web server's maximum upload limit size to avoid surprises, the size should be in parallel with maximum attachment size. |
Please keep in mind Delete and MoveTo actions will be executed once all other actions executed. This is to make sure that the original message is still available to other actions even the actions are after Delete or MoveTo type of actions.
In the following example:
Action 1 - Delete Message
Action 2 - Store to Disk Folder
Action 2 will run even though Action 1 deletes the message.
Last Modified on 12/3/2006