Documentation Center

Configuring subscription-related e-mails

The <Mail> section of the configuration file OutboundEmail.xml allows you to configure subscription-related e-mails.

Procedure

  1. Open OutboundEmail.xml. located by default in the %TRIDION_HOME%\config\, for editing.
  2. Locate the <Mail> section. This section contains a number of elements relevant for the behavior of subscription-related e-mails, as well as a number of other options that are relevant only for the deprecated Outbound E-mail feature.
  3. Specify the following setting to get subscription-related e-mails up and running:
    <QueueFolder>
    The folder where e-mails are queued. You need to configure your SMTP Server to fetch e-mails from this folder.
  4. Specify the following configuration settings that influence performance and handle the size of mailings:
    <MaxEmailsInQueueFolder>
    To prevent sending more mails than your SMTP server can handle at any given time, you can set a maximum number of e-mails for the folder where e-mails are queued. If you set a maximum, e-mails get added until the maximum is reached, and new e-mails will only be added to the folder if and when the SMTP server starts emptying the folder.

    Set the <MaxEmailsInQueueFolder alternativeFolder=""> attribute if, for example, your SMTP server moves e-mails to another work folder for processing (note that the default is defined by the <QueueFolder> element).

    <BatchSize>
    <BatchSize> defines the number of e-mails the Mailer Service picks up each round trip. This setting influences the memory used by the Mailer Service; if the <BatchSize> is set too high in relation to the size of the e-mails, you may experience out-of-memory errors.
    <PollingInterval>
    The time in seconds the Mailer Service waits, after a polling action has completed, before polling the Mailing Queue for e-mails to send again.
    For example, if 20,000 e-mails are in the queue, the BatchSize is 1000 and PollingInterval is 30 seconds, the Mailer Service first performs 20 iterations of sending out e-mails and only then start polling every 30 seconds.
  5. You can also specify the following settings:
    <ConfirmationEmailPriority>
    The priority of notification e-mails, such as confirming subscription (these should have the highest priority). The higher the number, the higher the priority.
    <FixedEmailAddress>
    For testing or demo purposes, you can send all outgoing e-mails to a single e-mail address instead of the Contact's e-mail address.
    <FixedEncoding>
    The encoding used in e-mails (optional). You can use Unicode, iso-8859-*, windows-*, utf-7, utf-8, utf-16, utf-32, Shift_JIS, gb2312, ks_c_5601-1987, big5, iso-2022-*, euc-jp, euc-kr, x-mac-*, asmo-708, ibm*, dos-*, koi8-*.

    For the complete list of supported charsets, refer to the Chilkat C# Charset Class Reference documentation.

  6. Save and close OutboundEmail.xml.