body Elements of a Distribution XML File

20-12 Publishing Reports to the Web with Oracle Reports Services RequiredOptional Required when used with body and attach when srcType is report or file, but not when srcType is text. Also required for file, printer, and destype. In the instances where it is required, you must have one and can have more than one include. Description The include element is available for use with the body , attach , file , printer , and destype elements. It specifies the file, report, or report section to be included in the body of an e-mail, as an attachment to an e-mail, in the content of a file, in the printer output, or in the content of a custom destination type. If you want to specify more than one section, but not the entire report, enter an include for each required section. For example: mail id=a1 to=jsmithfoo.com subject=Results body srcType=text Attached are quarterly results. body attach srcType=report format=htmlcss include src=headerSection include src=mainSection attach mail If the preceding body or attach element has srcType of file, the subsequent include can specify the file either with a directory path and filename or with just the filename, provided the file is located in a directory listed in the REPORTS_PATH environment variable. For example: mail id=a1 to=jsmithfoo.com body srcType=file include src=q4sales.pdf body mail If you do specify a path, use the appropriate standard for your platform. For example: On Windows: include src=c:\management\reports\current\Q4.htm On UNIX: include src=managementreportscurrentQ4.htm No other XML elements are placed between an include elements open and close tag. Table 20–5 describes the src attribute of the include element. Creating Advanced Distributions 20-13

20.4.7 file

Example On Windows file id=a7 name=c:\management\reports\report.pdf format=pdf include src=report file or file id=MyFiles2 name=c:\My_Departments_Report.txt format=delimiteddata include src=report file On UNIX file id=a7 name=managementreportsreport.pdf format=pdf include src=report file or file id=MyFiles2 name=My_Departments_Report.txt format=delimiteddata include src=report file On Windows or UNIX foreach file id=a7 name=sectionamp;lt;department_idgt;.pdf format=pdf instance=this include src=mainSection file foreach Table 20–5 Attributes of the include Sub-Element When Used with body or attach