Actuate BIRT Viewer Reference : Configuring Actuate BIRT Viewer : Configuring default export formats
 
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 13‑1.
Figure 13‑1 Export content with the pivot table default disabled
Table 13‑3 lists the default settings parameters for the different file formats the emitters produce.
Table 13‑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.