Home >Online Product Documentation >Table of Contents >Specifying a Converter URI
Specifying a Converter URI
To specify a converter: URI, you need to specify
- The XML Converter you want to use - EDI, CSV, dBase, custom XML conversion definition (
.conv
file), and so on. - Values for any XML Converters properties (separator or escape characters, for example) for which you do not want to use the default values. Options for custom XML conversions are part of the custom XML conversion definition and are not specified.
- The file to be converted.
Example - Converter URI with a DataDirect XML Converters
A converter: URI that invokes the DataDirect XML Converter for comma-separated values (CSV) to convert the three.txt
file in the Stylus Studio\examples
directory to XML might look like this:
The instructions to the XML Converters engine from this instance of the converter:URI are described the following table.
Instruction
|
Converter URI String
|
---|
Use the Comma-Separated Values XML Converter converter
|
converter:csv
|
The line separator in the source file is a line feed
|
newline=lf
|
The values in the first row of the source file should be used to supply field names
|
first=yes
|
The source file is three.txt
|
file:///c:/StylusStudio/examples/three.txt
|
Table 24. URI Scheme Example
Properties that use default values (a comma is the default separator character for the CSV XML Converter, for example) do not have to be specified in a converter:URI.
Example - Converter URI with a Custom XML Conversion Definition
A converter URI that references a custom XML conversion definition might look like this:
This converter uses myConverter.conv
to convert the file inventory.txt
to some format (specified in the custom XML conversion definition when it was built using the Custom XML Conversion Definition Editor in Stylus Studio). Note that individual configuration properties are not specified - they are part of the definition described in the .conv
file.