Report Recipients

The <report_recipients> section is where you can can modify the recipients that will receive the email report.

The <report_recipients> section is:

  • A child of the Report section and is optional
  • Positioned as the first entry in the <report> section

The <report_recipients> section includes the following children:

Child Type Description Use
report_recipient element A single recipient. optional

Use

  • To add two or more recipients, include as many <report_recipient> tags as needed, with one for every recipient
  • The default behavior is to append the new recipients to the default list
  • In order to overwrite the default list, use <report_recipients mode="overwrite">
  • You can also ensure the append behavior by using <report_recipients mode="append">

Note:

  • A <report_recipients> section cannot be used without a <report_recipient>, to avoid overwriting the default list with an empty list

Example

To append recipients to the default list:

    <report>
        <report_recipients>
            <report_recipient>somebody@mycompany.com</report_recipient>
            <report_recipient>someother@mycompany.com</report_recipient>
        </report_recipients>
    </report>

To overwrite the default list:

    <report>
        <report_recipients mode="overwrite">
            <report_recipient>somebody@mycompany.com</report_recipient>
            <report_recipient>someother@mycompany.com</report_recipient>
        </report_recipients>
    </report>

Next page:

Working examples

Also see: