10. Configuration

Unknown macro: {scrollbar}

Description

The following describes the property settings available.

CSV default separator

Defines the default separator, that should be used for the output.

<configuration>
 <property name="org.jfree.report.modules.output.table.csv.Separator">,</property>
</configuration>

CSV write column name into first row

Defines whether to write the column names of the data row into the first row.

<configuration>
 <property name="org.jfree.report.modules.output.csv.WriteDatarowNames">true</property>
</configuration>

Excel output set paper size

Defines the Paper that should be used in the excel print setup. If no paper is defined, a suitable paper will be selected automatically.

<configuration>
 <property name=" org.jfree.report.modules.output.table.xls.Paper">LETTER</property>
</configuration>

Excel output set paper orientation

Defines the Paper that should be used in the excel print setup. If no paper is defined, an suitable paper will be selected automatically. Valid values are "Landscape" or "Portrait"

<configuration>
 <property name="org.jfree.report.modules.output.table.xls.PaperOrientation">LETTER</property>
</configuration>

HTML encoding

Defines the encoding for the HTML.

<configuration>
 <property name="org.jfree.report.modules.output.table.html.Encoding">UTF-8</property>
</configuration>

HTML body fragment only

Defines whether to define a body fragment only. This removes the header and body tags and makes it easy to include the generated content in own pages.

<configuration>
 <property name="org.jfree.report.modules.output.table.html.BodyFragment">false</property>
</configuration>

HTML, XHTML 1.0 or HTML 4.0 format

Defines whether to generate XHTML1.0 or HTML4.0 content.

<configuration>
 <property name="org.jfree.report.modules.output.table.html.GenerateXHTML">false</property>
</configuration>

HTML default title

Defines the default title for generated HTML documents.

<configuration>
 <property name="org.jfree.report.modules.output.table.html.Title">My First Report</property>
</configuration>

HTML set author

Defines a author for generated HTML documents.

<configuration>
 <property name="org.jfree.report.modules.output.table.html.Author">Shakespeare</property>
</configuration>

HTML set empty cells to use CSS

Defines, whether empty cells will be controlled using CSS. If this is set to true, the Table gets the style property "empty-cells: show" assigned and the otherwise required no-break-space entities will no longer be generated.

The Internet Explorer is not able to use correct CSS2 yet. Thus, the default is set to "false".
This is a local configuration setting an can be enabled in the report.

<configuration>
 <property name="org.jfree.report.modules.output.table.html.EmptyCellsUseCSS">false</property>
</configuration>

HTML image size in Points or Pixels

Defines, whether image sizes should be given in device independent Point unit (1/72 inch) or in pixels (which is device dependent and makes it hard to predict the final size in the HTML-Page.

The default is pixels, false.

<configuration>
 <property name="org.jfree.report.modules.output.table.html.UseDeviceIndependentImageSize">false</property>
</configuration>

HTML table carrier a border definition

Defines, whether table rows should carry a border definition (in addition to the cell definitions). This is a workaround for a layout bug in the Mozilla browser family.

<configuration>
 <property name="org.jfree.report.modules.output.table.html.TableRowBorderDefinition">false</property>
</configuration>

HTML Table, use proportional column widths

Enables the use of proportional column widths instead of static ones. The resulting table will have a width of 100% and the columns will have the proportional equivalent of their static widths as width.

<configuration>
 <property name="org.jfree.report.modules.output.table.html.ProportionalColumnWidths">false</property>
</configuration>

PDF set author

The author string of the document.

<configuration>
 <property name="org.jfree.report.modules.output.pageable.pdf.Author">Larry Augustin</property>
</configuration>

PDF set title

The title of the document.

<configuration>
 <property name="org.jfree.report.modules.output.pageable.pdf.Title">Sales Report</property>
</configuration>

PDF encoding

Defines PDF encoding for report.

<configuration>
 <property name="org.jfree.report.modules.output.pageable.pdf.Encoding">Cp1252</property>
</configuration>

PDF embed fonts

Defines whether to embed fonts in the generated PDF. This will result in larger PDF files, but makes sure that all characters are displayed properly.

<configuration>
 <property name="org.jfree.report.modules.output.pageable.pdf.EmbedFonts">Cp1252</property>
</configuration>

PDF version

The PDF Version that should be created. Valid values are "1.2", "1.3","1.4" or "1.5"

<configuration>
 <property name="org.jfree.report.modules.output.pageable.pdf.Version">1.4</property>
</configuration>

PDF Security, Allow Copy

Defines, whether the PDF Security setting allows copying of the document's
contents by default. PDF Security flags are only used with security enabled and a password set.

<configuration>
 <property name="org.jfree.report.modules.output.pageable.pdf.AllowCopy">false</property>
</configuration>

PDF Security, Allow Printing

Defines, whether the PDF Security setting allows printing of the document's
contents by default

<configuration>
 <property name="org.jfree.report.modules.output.pageable.pdf.AllowPrinting">false</property>
</configuration>

PDF Security, Allow Modifying Contents

Defines, whether the PDF Security setting allows modifying of the document by default.

<configuration>
 <property name="org.jfree.report.modules.output.pageable.pdf.AllowModifyContents">false</property>
</configuration>

PDF Security, Allow Modifying Annotations

Defines, whether the PDF Security setting allows document annotations by default.

<configuration>
 <property name="org.jfree.report.modules.output.pageable.pdf.AllowModifyAnnotations">false</property>
</configuration>

PDF Security, Allow Fill-in of Document Forms

Defines, whether the PDF Security setting allows the fill-in of document forms (input fields etc).

<configuration>
 <property name="org.jfree.report.modules.output.pageable.pdf.AllowFillIn">false</property>
</configuration>

PDF Security, Allow access for screenreaders

Defines, whether the PDF Security setting allows access for screen readers by default. Although this could make it easier to grab the contents your PDF document, enabling this property will allow blind people to access your content. It is usually a good idea to always enable this property.

<configuration>
 <property name="org.jfree.report.modules.output.pageable.pdf.AllowScreenReaders">false</property>
</configuration>

PDF Security, Allows reassembly of document

Defines, whether the PDF Security setting allows reassembly of the document by default.

<configuration>
 <property name="org.jfree.report.modules.output.pageable.pdf.AllowAssembly">false</property>
</configuration>

PDF Security, Allow low quality printing

Defines, whether the PDF Security setting allows low quality printing of the document's contents by default.

<configuration>
 <property name="org.jfree.report.modules.output.pageable.pdf.AllowDegradedPrinting">false</property>
</configuration>

PDF Security, Encrypt

Defines whether the PDF file should be encrypted by default. Set this to "none" "40bit" or "128bit". Access restrictions have no effect if the document is not encrypted, and not all security settings are active on 40-Bit encryption.

No encryption

<configuration>
 <property name="org.jfree.report.modules.output.pageable.pdf.Encryption">none</property>
</configuration>

40 bit encryption

<configuration>
 <property name="org.jfree.report.modules.output.pageable.pdf.Encryption">40bit</property>
</configuration>

128 bit encryption

<configuration>
 <property name="org.jfree.report.modules.output.pageable.pdf.Encryption">128bit</property>
</configuration>

Specifying passwords in the property file can introduce a security risk. Do not use these settings on the client side or in unprotected (world-readable) server environments. In these cases use other means of defining the password.

PDF Security, Password

The default user password for the document. Users are able to access the document within the defined security restrictions.

<configuration>
 <property name="org.jfree.report.modules.output.pageable.pdf.UserPassword">password</property>
</configuration>

PDF Security, Owner

The default owner password for the document. The owner has all permissions on the document and will be able to change the security settings.

<configuration>
 <property name="org.jfree.report.modules.output.pageable.pdf.OwnerPassword">password</property>
</configuration>