include Elements of a Distribution XML File

Creating Advanced Distributions 20-15

20.4.8 printer

Example On Windows printer id=a1 name=\\server_name\printer_name copies=5 include src=report printer On UNIX printer id=a1 name=alias_to_registered_printer copies=5 instance=all include src=report printer RequiredOptional Optional. You can have as many printer elements as you require. Description Use the printer element to specify distributions to a printer. The printer element has one sub-element: include . There must be at least one include sub-element and there may be more between the open and close tags of the printer element. When used with the foreach element and the instance=this attribute, the printer element can distribute each group instance of a grouped report to a separate print job. For example, if you group a report on department_id, and there are four departments, you can use the foreachprinterinstance=this combination to generate four printed reports, each containing a separate departments report. In this case, the printer entry in the distribution XML file might look like this: foreach printer id=a7 name=\\server_name\printer_name instance=this include src=report printer foreach In this example, all report sections header, main, and trailer must repeat on the same group instance for example, department_id. Table 20–7 lists and describes the attributes of the printer element. Table 20–7 Attributes of the printer Element Attribute Valid Values Description id string Required. A keyword, unique within a given distribution XML file, that identifies a particular file 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. 20-16 Publishing Reports to the Web with Oracle Reports Services

20.4.9 destype

Example destype id=acustom1 name=fax include src=headerSection property name=number value=914925551212 destype See Section 20.5, Distribution XML File Examples for examples of using the destype element in a distribution XML file to specify distribution to the following destinations: Oracle Portal, FTP, WebDAV, and fax. RequiredOptional Optional. You can have as many destype elements as you require. Description Use the destype element to specify distribution to a custom destination, such as a fax machine or an FTP site. You also use destype to specify distribution to a portal created with Oracle Portal. The destype element allows for the use of two sub-elements: property and include . At least one include is required. name string Required. Variable values allowed. The destination printer. How you enter this information differs between Windows and UNIX. For Windows, specify the printer server name and the printer name. For example: name=\\server_name\printer_name For UNIX, specify the alias assigned to a registered printer. For example: name=sales_printer Can also contain variable values that reference columns used in the associated report. See Section 20.3.2 for more information. copies string Default: 1 Number of copies of each report or each report group instance to print. instance this|all Default: all Used when the foreach element is also present. With a grouped report that is burst into separate reports, instance specifies whether the groups will be broken into separate printed reports according to each group instance this or all contained within the same printed report all. Table 20–7 Cont. Attributes of the printer Element Attribute Valid Values Description Creating Advanced Distributions 20-17 When used with the foreach element and the instance=this attribute, the destype element can distribute each group instance of a grouped report to a separate destype instance for example, a separate fax. For example, if you group a report on department_id, and there are four departments, you can generate four destype instances, each containing a separate departments report. In this case, the destype entry in the distribution XML file might look like this: