Set Conversion Options

Conversion options are parameters that determine the content, structure, and appearance of the XML output. For example, you can specify:

You can set the conversion options either in the API or in the template files. Regardless of the method used to set the options, the values are ultimately passed to the API and used to populate the following classes:

Set Conversion Options by Using the API

Use the following classes to set conversion options:

There are methods to get or set the corresponding objects in the XmlExport instance. In the XmlExport class, the following methods are available:

In the XmlTOCOptionInfo class, the following methods are available:

Set Conversion Options by Using the Template Files

XML Export includes templates in the form of initialization files (.ini). The templates provide a quick and easy way to modify the conversion options without programming at the API level. However, the template files do not give you complete control of the conversion process. To control some features, you must use the API directly.

You can use a text editor to customize the template files. For example, to change the output character set from the default KVCS_UNKNOWN to KVCS_SJIS in the default.ini template, make the following change shown in bold:

[KVXMLOptions]
eOutputCharSet=KVCS_SJIS
bForceOutputCharSet=TRUE

To create valid XML, a template file must define at least two structures: KVXMLTemplateEx and KVXMLOptionsEx.

NOTE: If you enter markup in the template files that is not compliant with XML standards, XML Export inserts the markup into the output file unchanged. This might result in a malformed XML file.

An application must then read the template file and write the data to the appropriate Export class. In the XmlTest sample program, a template file is supplied as a command-line argument (see XmlTest). In a Java application, the template file is passed using the setIniFileName method.

objXmlExport.setIniFileName(iniFile);

Templates

The template files for the Java API implementation are in the directory install\javaapi\ini\html, where install is the path name of the Export installation directory.

The following templates are provided for the Java implementation.

Template

Description

Callback (xml1filecallback.ini)
  • Based on the single file template (xml1file.ini).

  • Implements a user callback named "UserCB_End_Block " at the bottom of the main XML file.

Single file with table of contents (xml1filetoc.ini)

  • Creates a single XML file.
  • Creates a table of contents at the top of the XML document.
  • Uses the Verity.dtd.
  • Uses an XSL style sheet (wp.xsl).
  • Forces the output character set to UTF-8.
  • Lists all metadata (Title, Subject, Author, Comments, Created, Modified, Last Saved By, and Revision Number).
  • Uses the name of the worksheets for spreadsheets.
  • Uses the slide titles for presentations. If no titles are available in the source document, it uses "slide 1," "slide 2," "slide 3," and so on.

XML one file (xml1file.ini)

  • Creates a single XML file.
  • Does not define an XSL style sheet. A default XSL style sheet that is appropriate to the source document type is used. The defaults supplied are wp.xsl (for word processing documents), ss.xsl (for spreadsheets), pg.xsl (for presentations).
  • Forces the output character set to UTF-8.
  • Maintains the source document's fonts and styles.
  • Does not create a table of contents.

_FT_HTML5_bannerTitle.htm