Documentation Center

Configuring email notifications

The <SmtpServer> element in the TranslationManager.xml file specifies the location and connection details of the SMTP server which is used to send email notifications.

About this task

When you configure Target Publications for translation, you can specify a comma-separated list of email addresses in the Send notification email to field. When a Translation Job is sent for translation, an email is sent to the addressees listed in the Target Publication configured to receive the translated content notifying them of the items sent for translation.

Attributes
The <SmtpServer> element has the following attributes:
AttributeDescription
portPort number
usernameSMTP server username
passwordSMTP password
authenticationAuthentication method (if set to none, the username and password attributes are not used):
  • none
  • Basic
  • NTLM
connectionTimeoutThe number of seconds to wait for a connection to open before canceling the attempt and generating an error
replyAddressEmail address where a reply to a notification mail is sent
sendAddressEmail address from where a notification mail is sent
templateFolderThe location and name of a template used for email notification. When you run the Translation Manager installer, default templates EmailTemplate.html.xml and EmailTemplate.txt.xml are installed in your SDL Tridion Sites installation \config\TranslationManagerEmailTemplates directory.

Procedure

  1. Open the TranslationManager.xml file in a text editor.
    By default, the file is located in your %TRIDION_HOME%\config directory.
  2. Go to your SDL Tridion Sites installation \config\TranslationManagerEmailTemplates directory.
  3. Rename EmailTemplate.html.xml or EmailTemplate.txt.xml to EmailTemplate.xml depending on whether you want to send email notifications in HTML or plain text format.
  4. In the <SmtpServer> section, enter for example:
    <SmtpServer port="24" 
    	username="SMTPUserName" 
    	password="SMTPPassword" 
    	authentication="none" 
    	connectionTimeout="30" 
    	replyAddress="reply@address.com"
    	sendAddress="sendFrom@address.com" 
    	templateFolder="TRIDION_HOME\config\TranslationManagerEmailTemplates">smtp.server.com</SmtpServer>

    where TRIDION_HOME is the value of the %TRIDION_HOME% environment variable.

  5. Save and close the file.

What to do next

The ErrorEmailNotificationsPlugin.cs sample plugin, available on the SDL Tridion Sites installation media in the Translation Manager\Samples\Plugins directory, demonstrates how to send e-mail notifications if errors occur during the translation process.