xfj:printing-options

Top Previous Topic Next Topic  Print this topic

The xfj:printing-options extension can be used for various output formats, most notably PostScript, to specify advanced printing options.

Its syntax is of the following form:

 

 

<?xml version="1.0" encoding="utf-8">

<xfj:job xmlns:xfj="http://www.ecrion.com/xfj/1.0">

       <xfj:printing-options input-tray="0" output-tray="0" copy-count="1" duplex="false" media-color="blue" sheet-width="8in" sheet-height="11in" rotate-content="90">

               <xfj:ps-printer-code>

                       <!-- insert PostScript specific printer code here -->

               </xfj:ps-printer-code>

       </xfj:printing-options>        

       <xfj:output mime-type="application/pdf"/>

       <xfj:overlay id="Header" z-index="1">

               <xfj:apply-rules>

                       <xfj:match rule="all" />

                       <xfj:match rule="exclude(toc)" />

               </xfj:apply-rules>

               <xfj:external-content src="url(.\resources\Overlay.fo)" />

        </xfj:overlay>

       <xfj:document id="toc" exclude-from-page-count="false">

               <xfj:external-content src="url(.\resources\TOC.xfd)"/>

               <xfj:input-xml src="job-info()"/>

       </xfj:document>

       <xfj:document id="doc2" title="Current Superannuation">

               <xfj:external-content src="url(.\resources\InputPDF.pdf)"/>

       </xfj:document>

       <xfj:document id="doc3" title="your Funds">

               <xfj:external-content src="url(.\resources\InputXFD.xfd)"/>

               <xfj:input-xml src="url(.\resources\data.xml)"/>

       </xfj:document>

</xfj:job>

 

 

The following attributes can be applied to this element:

 

The input-tray attribute specifies the index of the input tray that should be used. Default value is 0.

 

The values for this attribute are different depending on the output format.

For PS and AFP format input-tray is a numerical value. Any non-numerical value will have no effect and a warning will be issued.

For Direct Printing format the attribute may be as both numerical and non-numerical value. When a non numerical value is specified the, server tries to detect it automatically from the tray name.

 

The output-tray attribute specifies the index of the output tray that should be used. Default value is 0.

 

The values for this attribute are different depending on the output format.

For AFP format, the attribute is a numerical value. Any non-numerical value will have no effect and a warning will be issued.

For PS format, output-tray it is a string value.

For Direct Printing format, values for this attribute are not supported.

 

The copy-count attribute specifies the number of copies that should be printed. Default value is 1.
The duplex attribute specifies whether this page sequence should be printed in duplex mode. Default value is false.
The media-color attribute specifies the color to use for printing. Default value is none.
The rotate-content attribute specifies how the page content should be rotated for the printers that do not support landscape format. The values for this attribute are 90, 180 or 270 degrees.

 

The xfj:ps-printer-code element can be added as a child of xfj:printing-options and allows for PostScript specific printer code to be inserted.

 

 

Notes:

When this parameters are specified from both command line tools and DAL job, the xf:printing-options in the DAL job will overwrite command line parameters.
When this parameters are specified from both DAL job and page-sequence, the xf:printing-options in page-sequence will overwrite xf:printing-options in the DAL job.
When this parameters are specified from both page-sequence and simple-page-master, the xf:printing-options in simple-page-master will overwrite the xf:printing-options in page-sequence.