Configuring default export formats

The iHub platform provides output format emitters as plug-ins. These emitters can be configured so that content exported by BIRT Viewer has specific settings. To configure emitter default options, add a RenderDefaults.cfg file to the emitter configuration JAR file for the emitter with specific options set with text. For example, to configure the Microsoft Excel (.xls) file emitter, add RenderDefaults.cfg to the following JAR file:

<iHub root>\Jar\BIRT\platform\plugins\com.actuate.birt.
report.engine.emitter.config.xls_11.0.4.<date_stamp>.jar

RenderDefaults.cfg contains one parameter and value pair on each line to configure each default setting. For example, to configure the XLS emitter to disable pivot tables and to not hide grid lines by default, the RenderDefaults.cfg file contains the following entries:

excelRenderOption.EnablePivotTable=false

excelRenderOption.hideGridlines=false

After adding the configuration file to the emitter configuration JAR file, re-archive and save the JAR file to the plugins folder. Then, restart the iHub Service. After these steps, the viewer displays the configured default options when exporting a report to the XLS output format, as shown in Figure 12-1.

Figure 12-1

Export content with the pivot table default disabled

Table 12-3 lists the default settings parameters for the different file formats the emitters produce.

Table 12-3

Configurable default settings for exporting content

Format	Parameter	Description
All	ChartDpi	Sets the chart resolution. For example, ChartDpi=120.
PDF	pdfRenderOption .bidiProcessing	Enables bidirectional text support.
	pdfRenderOption .embeddedFonts	Embeds fonts in the output document.
	pdfRenderOption .fontSubstitution	Enables font substitution for unknown fonts.
	pdfRenderOption .hyphenation	Enables splitting words with a hyphen at line breaks.
PDF (continued)	pdfRenderOption .pageOverflow	Controls rendering content when the content exceeds the page size. Integer values indicate the following options: 1: clips the content 2: scales the content to fit the page 4: (default) divides the content into multiple pages 8: expands the page to fit content
	pdfRenderOption .textWrapping	Enables text wrapping.
	RenderChartInSVG	Renders charts as vector graphics.
PPT/PostScript	BIDIProcessing	Enables bidirectional text support. For example, BIDIProcessing=false.
	FontSubstitution	Sets font substitution for unknown fonts. For example, FontSubstitution=false.
	TextWrapping	Enables text wrapping. For example, TextWrapping=false.
XLS/XLSX	excelRenderOption .AutoFitPivotTable	Enables BIRT Viewer to automatically adjust content for display in pivot tables.
	excelRenderOption .EnableLiveFormula	Enables formulas for derived values.
	excelRenderOption .EnablePivotTable	Enables pivot tables.
	excelRenderOption .ExportChartsAsImages	Renders charts as images only.
	excelRenderOption .hideGridlines	Hides grid lines.
	excelRenderOption .multipleSheet	Enables multiple worksheet output.
	excelRenderOption .wrappingText	Enables text wrapping.

 

© Copyright OpenText Corp. All rights reserved. Privacy Policy | Cookie Policy

BIRT iHub 2