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:

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

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>