UTF‑8 Encoding Support

As part of the extract format changes in the Jade Platform development environment, Jade Report Writer now supports extracting and reloading the following files encoded as UTF‑8 with a Byte Order Mark (BOM).

• Report Definition files (.rwr)

• Report View Definition files (.rwv)

• Report Folder files (.rwf)

• Report User Options files (.rwu)

• Report System Options files (.rwo)

• Report All Definitions and Options file (.rwa)

The Use UTF‑8 file encoding check box is now displayed on the respective dialogs for extracting and unloading the files in the previous list. Check this check box to output files encoded as UTF‑8 with a Byte Order Mark (BOM). If you do not check this check box, the file is output in native ANSI or Unicode format.

In addition, the dialogs that enable you to extract or unload data are now resizable.

The Options sheet of the User Preferences dialog enables you to specify the default setting of the Use UTF‑8 file encoding check box, using the following new check box.

• Use UTF‑8 for Report Definition files check box. If you check this check box, the Use UTF-8 file encoding check box is checked by default on dialogs for extracting and unloading Jade Report Writer files. By default, this check box is not checked; that is, native ANSI or Unicode is the default format.

The JadeReportWriterReport class now provides the setOutputFileEncoding method, which has the following signature.

setOutputFileEncoding(fileKind: Integer; unicodeBOM: Boolean);

The setOutputFileEncoding method sets the file kind and Unicode Byte Order Mark (BOM) of the file that is created when the report runs. The setOutputFileEncoding method parameters are listed in the following table.

Parameter	Description
fileKind	Contains the kind of file that is to be output, represented by one of the following constant values. 0 (Native); that is, existing ANSI or Unicode behavior File.Kind_ANSI (2), only for an ANSI system File.Kind_Unicode (3), only for a Unicode system File.Kind_Unicode_UTF8 (8), Unicode Transformation Format (UTF) 8 bit
unicodeBOM	Specifies whether a Unicode BOM is present in the file, represented by the File class unicodeBOM property. Applies only if File.Kind_Unicode_UTF8 is specified for the fileKind parameter.

For details, see "JadeReportWriterReport Class Constants", in Chapter 1 of the Encyclopaedia of Classes and for details about extract format changes in Jade, see "Extract Format Changes", earlier in this document.