Recipients section

The <recipients> section is where you:

• Instruct XMLDelivery to retry a delivery if the user database is locked

• Choose to either:

  • Add new recipients or test recipients directly
    or:
  • Enter the identifier of an existing user database filter

See Adding recipients dynamically for more about managing recipients.

The <recipients> section:

• Belongs to the Common sections and elements and is mandatory
• Is positioned within the generic campaign type (for example, <email>) section, after the Newsletter element, in the XML instructions file

See the Campaign section for more details.

The <recipients> section includes the following children:

Child	Type	Description	Use
retry	element	Instructs XMLDelivery to retry the delivery if the user database is locked. The default is no retry.	Use to change default
new_recipients	element	Container to add recipients directly or by using an external CSV file.	Choose <new_recipients> or the <filter> > <normal> option
test_recipients	element	Container to add test recipients directly or by using an external CSV file.	Choose <test_recipients> or the <filter> > <test> option
filter	element	Container to specify the test and/or normal delivery user database filter identifiers. The user database is filtered accordingly, when the delivery is processed.	Choose <new_recipients> and/or <test_recipients>, or <filter>

Use

Note:

If you use the <new_recipients> section, you can define a filter identifier for a test delivery in the <filter> section, if required. Any <normal> delivery filter identifier is ignored. You cannot use both the <new_recipients> section and a <normal> delivery filter for the same delivery.

In the same way, if you use the <test_recipients> section, you can define a filter identifier for a normal delivery in the <filter> section, if required. Any <test> delivery filter identifier is ignored. You cannot use both the <test_recipients> section and a <test> delivery filter for the same delivery.

Retry can be used with the <new_recipients>, <test_recipients> or the <filter> sections.

Test deliveries

If <test_recipients> or the <filter> > <test> option is used, XMLDelivery creates two deliveries:

• A test delivery
  • Sent immediately
    Provides a preview of the normal delivery.
• A normal delivery
  • Sent according to the delivery settings in the XML instructions file

Example:

    <recipients>
        <retry />
            See the Retry topic.
        <new_recipients>
            See the New_recipients topic.
        </new_recipients>
        <test_recipients>
            See the Test_recipients topic.
        </test_recipients>
        <filter>
            See the Filter topic.
        </filter>
    </recipients>