Setting Options for the Template Builder
Use the Options dialog to specify template settings.
Access the Options dialog as follows: In the Options group, click Options.
The Options dialog contains four tabs: UI, Preview, Build, and Connection, as described in the following sections.
Setting UI Options
Use the Options dialog: UI tab to set options that influence the look and feel of the Template Builder.
The following illustration shows the Options dialog: UI tab.
The tree view that shows the data source can show either the correct XML tag names of the data source or they can show a slightly modified version that is easier to read. Select the option Element Names for Report XML to show the modified labels. These labels contain no <> characters, use "Title case" and use spaces (" ") instead of underscores ("_").
Setting Preview Options
The Options dialog: Preview tab allows you to specify options that influence the Preview functionality of the Template Builder.
The following illustration shows the Options dialog: Preview tab.
The following table describes the options available from the Preview tab.
| Option | Description |
|---|---|
|
Style Template |
If you have a BI Publisher Style Template available locally, then you can specify it here. A style template is an RTF template that contains style information that can be applied to RTF layouts, similar to a style sheet. The style information in the style template is applied to RTF layouts at runtime to achieve a consistent look and feel across your enterprise reports. For more information, Creating and Implementing Style Templates. |
|
Locale |
You can choose the language and territory used for previewing the template. While this change does not automatically translate any files, it is important to set the correct locale for the preview to use the correct direction of the text (left-to-right or right-to-left), and to correctly set locale-specific date, number, and currency formats. |
|
Java Home |
The Preview (and export functionality) requires Java code. You can change the path to the JAVA HOME directory. If this option is not specified, the Template Builder assumes that the Java virtual machine (java.exe) is accessible in the PATH specified in the environment variables of Windows. |
|
Java Option |
Specify the memory to reserve for the Template Builder to process the template. The default value is -Xmx256M. |
Setting Build Options
Use the Options dialog: Build tab to specify options that influence how the Template Builder generates tables and forms.
The following illustration shows the Options dialog: Build tab.
The following table describes the options available from the Build tab.
| Option | Description |
|---|---|
|
For-each form field |
Select how the Template Builder creates the form fields for processing instructions in the Insert Table/Form dialog. The Descriptive option (for example: for-each Invoice) renders a descriptive form field for the processing instructions. This option makes the layout template easier to understand. However, the longer fields may distract from the visual layout of the template. Note that the descriptive option does not apply to fields within table cells. The Abbreviated option (for example: F) provides a one letter abbreviation for each instruction. Select the Hidden box to generate the processing instruction form fields using Microsoft Word's hidden font effect. Hidden text is hidden in the Print Preview and you may display or hide the hidden text by changing the Hidden Text setting in the Display group of the Microsoft Word Options. |
|
Form Field Size |
Large - inserts the BI Publisher code to a document variable. The document variable field can accommodate approximately 48 kilobytes of code line. It is important to note that this setting affects only fields that are created or edited while this option is set. The form fields created with the Large setting cannot be understood by Oracle BI Publisher 10g. If the template is intended for use with the 10g version of BI Publisher, use the Backward Compatibility setting. Backward Compatible - in previous versions of the Template Builder the BI Publisher code was inserted to the Microsoft Word Form Field Help Text box. This limited the length of code that could be inserted for a single form field. By default, the Large option is used because it can accommodate much larger code strings. However, the Large option is not compatible with Oracle BI Publisher 10g. |
|
Table Header Color |
When you insert a table using the Table Wizard or the Insert Table/Form dialog the Template Builder applies the Table Header Color specified here to the table header background. Customize the default color for the templates. |
|
Generate XSLT 2.0 compliant code |
BI Publisher uses the XSLT processor provided by Oracle XDK 11.1.0.7.0, which supports the W3C XSL Transformations 1.0 recommendation. The processor also implements the current working drafts of the XSLT and XPath 2.0 standards. For more information about Oracle XDK, see: Oracle XML Developer's Kit Programmer's Guide. By default, BI Publisher is compatible with XSLT 1.0. If you want to use XSLT and XPath 2.0 features in the template, then enable this option. This configuration is performed at the template level. The template-level setting overrides the server setting. |