watchDirectory Help > Plugins > Automatically Email
Automatically Email
Send email for old files
Use the Email plugin together with the File Age monitoring method to receive email notifications for old files - Great for workflow!Warn John if he didn't process the file, and CC yourself and his colleague.
WatchDirectory uses this plugin to create email notifications for file activity. You can optionally attach the new or changed file to the message. The actual email is sent using the wdPostMan program that you configure using the "View -> Email settings" menu option. See Email Settings for more information.
Settings for this plugin
Send email To (enter addresses directly)
Here you enter the email adresses of people that have to receive the notification. You enter an address in the format
TO:display name<name@host.com>
The "display name" is optional, so you can also enter
TO:<name@host.com>
Besides prefixing email addresses with TO: (like above), you can also use CC: and BCC:
for "carbon copy" and "blind carbon copy" messages.
Look at Advanced Addressing for more possibilities.
Use this subject
Enter the subject you want to use for the email message. You can use special variables (surrounded by dollar-signs)
that will be replaced at the time the message is sent. These variables are discussed below.
Send html formatted email
See Sending HTML email for some tips if you want to send rich formatted email.
Enter the message body
Enter the body you want to use for the email message. If you want to use the contents of the detected file
as the body of your email message, use this syntax:
@@@%WD_FILE%@@@
If you want to include other files, just name them directly like this:
@@@C:\Email Texts\footer.txt@@@
You can use other variables (surrounded by dollar-signs)
that will be replaced at the time the message is sent. These variables are discussed below.
Variables
Variables you can use in the subject and body
The table below lists some common predefined variables you can use.
| $FN$ | (File Name) This will be replaced by the name of the file that caused this message. |
| $FP$ | This will be replaced by the directory where the above file is found |
| $RS$ | This will be replaced by the "reason" of the message (see additional variables below) |
| $COMP$ | This will be replaced by the name of the computer |
| $DT$ | This will be replaced by the current date |
| $TM$ | This will be replaced by the current time |
Additional variables
Pressing the "additional variables" button will bring up a text editor in which you can enter
more variables and their values.
The $RS$ variable will get its value from the variable inside this file that matches the
current file system event. For example, when a new file is detected, the $RS$ variable will
have the value that you assign to "FILENEW".
More Additional Variables you can use
All the variables that are available to the .bat file plugin can be used as well.
Note that these variables are surrounded by %PERCENTAGE-SIGNS%, not dollar-signs.
Attaching Files
Attach the file
Select this option if you want to attach the new or changed file to the message.
Remove the file after sending the message
This option will delete the attached file after sending the message.
Only attach files smaller than...
With this option you can prevent attaching large files. If you enabled the option to remove the file after sending the message,
and the file is not attached due to its size, the file will not be removed.
Message Encoding
Select the message encoding for your email messages. If your language uses special characters, and they display as garbage in your email client, try one of
these Encoding options. QUOTED/Plain should work for most european languages.
Combining Emails
If you are combining HTML Emails, make sure you also read the Combine HTML Email Messages remarks.
Combine emails
If this task could potentially send a large number of emails you may want to combine email messages.
The email plugin will only combine messages when messages have the same recipients (TO, CC and BCC) and sender.
Combining emails reset the delay period
If this option is selected it can take a long time before the email is actually sent, depending on the "activity" inside the monitored directory.
Each file event will reset the delay period.
If this option is not selected, emails are always sent when the "combine delay" expires.
Combine emails separately for each directory
If this option is selected, the emails will be combined separately for each sub directory. Without this selection
all emails for all sub-directories of the monitored directory will be combined.
Use the following text as Intro for a combined email
The text you enter here will be added before all individual email texts (as entered on the main window).
Append the following text after the combined email
The text you enter here will be added after all individual email texts (as entered on the main window).
