| Completion Notification Plug-In |
This plug-in is used to send notification of the build completion
status via e-mail. The log file can be included as an optional attachment.
Configuration options must be defined before it can be used. The configuration
options are as follows:
Configuration Option | Description |
---|
SMTP Server | Enter the name of the SMTP server used to send the e-mail. |
Port # | Enter the port number to use on the server when sending the e-mail. |
Use default credentials | If this checkbox is checked, the current user's credentials at build
time will be used to send the e-mail. If running this on a build server or
if your e-mail server requires authentication, uncheck this box and supply a
user name and password. |
User Name and Password | Use these to enter specific credentials for sending the
e-mail Security Note |
---|
The password is stored in the project file in plain text. |
|
From E-Mail Address | Enter a From e-mail address. If one is not supplied, the address
noreply@noreply.com will be used as the sender.
Note |
---|
Some e-mail servers require a valid From address on the e-mail or at
least one that comes from the same domain. |
|
Success E-Mail Address | If you want an e-mail sent on a successful build, enter the e-mail
address here. If no address is entered, no e-mail will be sent on successful
builds. |
Failure E-Mail Address | A failure e-mail address is required. This is where the failure
notification will be sent. |
Attach build log on successful build | Check this box if you would like the build log to be attached to the
success e-mail. If unchecked, the log will not be sent. |
Attach build log on failed build | Check this box if you would like the build log to be attached to the
failure e-mail. If unchecked, the log will not be sent. |
Optional XSL Transform | If specified and the log file is to be attached to the e-mail, the
log file is ran through the specified transform and the resulting HTML file is
attached in its place. If not specified, the raw log file is attached. The
default transform can be used by specifying
{@SHFBFolder}Templates\TransformBuildLog.xsl. |
This plug-in runs after the build has completed and the log file has
been closed but before it is deleted if the KeepLogFile
option is set to false. Note that because the log file is closed, any failure
messages reported by this plug-in as it tries to send the e-mail will not
appear in the log file itself.
See Also