# XmlConvFileToFile

This program converts an input file to an output file using Java API calls in XML Export, and a template file. See Explore Conversion Options with the Sample Programs for more information on templates.

It demonstrates the following functions:

- Extracts file format information (document type, format, and version) if it is available in the source document.

- Extracts metadata if it is available in the source document.

  NOTE: Although the program extracts all the metadata in the document, it only displays the first element of metadata.

- Displays a list of the files that are automatically generated during the conversion.

- Specifies the directory in which temporary files created during conversion processes are stored. To specify the temporary directory, remove the comment from the following line in the `XmlConvFileToFile.java` file:

      objXmlExport.setConfigOption(new ConfigOption(Export.CFG_SETTEMPDIRECTORY, 0, "C:\\tmp"));

  NOTE: On Windows systems, there is a 64 K size limit to the temporary directory. After the limit is reached, you must either create a new directory or delete the contents of the existing directory; otherwise, you might receive an error message.

- Extracts elements from a source XML file based on the extraction settings in the `kvxconfig.ini` file. See Configure Element Extraction for XML Documents.

## Run XmlConvFileToFile on Windows

To run XmlConvFileToFile on Windows

1. In the `XmlConvFileToFile.bat` file, set `INSTALL_DIR` to the Export SDK installation directory.

2. In the first line of the `XmlSampleConfig_nt.txt` file, specify the path to the template file used in the conversion. You can use any of the template files in the `install\xmlexport\programs\ini` directory, where `install` is the path name of the Export installation directory. If you are processing XML files, specify the location of the `kvxconfig.ini` file. This is in the `bin` directory.

3. In the second line of the `XmlSampleConfig_nt.txt` file, specify the path to the `Export SDK\bin` directory.

4. Copy `XmlSampleConfig_nt.txt` to `XmlSampleConfig.txt`.

5. Run the batch file in the `install\javaapi\sample` directory. Type the following:

   `XmlConvFileToFile` `inputfile` `outputfile`

   where:

   `inputfile` is the path and file name of the source file.

   `outputfile` is the path and file name of the generated XML file. If you do not specify a path, the XML file is output to the current directory.

   To view the XML file in a browser, the `Verity.dtd` and other support files (`.xsl` and `.ent`) must be in the same directory as the XML file. These files are in the `install\javaapi\sample` directory.

## Run XmlConvFileToFile on UNIX

To run XmlConvFileToFile on UNIX

1. In the`XmlConvFileToFile.csh` file, set `MKENV` to the platform on which you are running, either `_hpux11`, `_ilnx21`, `_rs6k43`, or `_ssol26`.

2. In the `XmlConvFileToFile.csh` file, set `INSTALL_DIR` to the Export SDK installation directory.

3. In the first line of the `XmlSampleConfig_unix.txt` file, specify the path to the template file used in the conversion. You can use any of the template files in the `install/xmlexport/programs/ini` directory, where `install` is the path name of the Export installation directory. If you are processing XML files, specify the location of the `kvxconfig.ini file`. This is in the `bin` directory.

4. In the second line of the `XmlSampleConfig_unix.txt` file, specify the path to the directory `Export SDK/bin`.

   NOTE: If you have copied the `XmlSampleConfig_unix.txt` and C shell file from a Windows system or edited the files on a Windows system, remove the carriage returns from these files. You can use a utility such as the ColdFusion function `stripcr()` (`http://www.macromedia.com`) to do this. This step is not required if the files are taken from the UNIX installation.

5. Copy `XmlSampleConfig_unix.txt` to `XmlSampleConfig.txt`.

6. Run the C shell file in the `install/javaapi/sample` directory. Type the following:

   `./XmlConvFileToFile.csh` `inputfile` `outputfile`

   where,

   `inputfile` is the path and file name of the source file.

   `outputfile` is the path and file name of the generated XML file. If a path is not specified, the XML file is output to the current directory.

_FT_HTML5_bannerTitle.htm