The distribution.dtd File Using Variables Within Attributes

Creating Advanced Distributions 20-7 include src=mainSection attach foreach mail RequiredOptional Optional. You can have as many mail elements as you require. Description Use the mail element to specify distributions through an outgoing SMTP-based mail server. Use it to specify the recipients, the subject, and the priority of the e-mail. Between an open and close tag of the mail element, there can be only one body sub-element and anywhere from zero to multiple attach and foreach sub-elements. The mail element also has a set of related attributes. These are expressed within the mail tag. For example, the id, to, and subject attributes are expressed: mail id=a1 to=jsmithfoo.com subject=Recent Hires Table 20–2 lists and describes the attributes of the mail element. Table 20–2 Attributes of the mail Element Attribute Valid Values Description id string Required. A keyword, unique within a given distribution XML file, that identifies a particular mail element. This can be a combination of a text string and one or more numbers, for example id=a1. The id value must always start with an alpha character. to string Required. Variable values allowed. The recipients of the e-mail. Contains the full, formal e-mail address, for example: to=jsmithfoo.com Multiple recipients must be separated with commas. Can also contain variable values that reference columns used in the associated report. See Section 20.3.2 for more information. cc string Optional. Variable values allowed. The recipients to receive a copy of the e-mail. bcc string Optional. Variable values allowed. The recipients to receive a blind copy of the e-mail. from string Optional. Variable values allowed. The sender of the e-mail. replyTo string Optional. Variable values allowed. The e-mail account where replies should be sent. subject string Default: Mail Sent from amp;Report Optional. Variable values allowed. The subject of the e-mail. In the absence of a specified subject, the subject line will read: Mail Sent from [Name of Report] 20-8 Publishing Reports to the Web with Oracle Reports Services

20.4.4 body

Example On Windows mail id=a1 to=jsmithfoo.com subject=Results body srcType=file include src=c:\mail\body.html body mail On UNIX mail id=a1 to=jsmithfoo.com subject=Results body srcType=file include src=mailbody.html body mail RequiredOptional Optional. You can have a maximum of one body element associated with a given mail element. priority highest|high|normal| low|lowest Default: normal The e-mails delivery priority. returnRecei pt true|false Default: false Indication of whether the reply to individual or account should be notified when the e-mail is received. organizatio n string Optional. Variable values allowed. The name of the organization distributing the e-mail, for example: organization=Region 10 Sales Or organization=amp;department_name Note: For the mail element to work properly, the Reports Server must know which outgoing SMTP mail server to send mail to. You specify this information in the Reports Server configuration file rwserver.conf. This file has a pluginParam element where you can enter the name of a mail server. For example: pluginParam name=mailServer value=MAILSERVER property name=enableSSL value=yes pluginParam For more information, see Chapter 8, Configuring Oracle Reports Services . Table 20–2 Cont. Attributes of the mail Element Attribute Valid Values Description