<%@ page language="C#" masterpagefile="~/templates/Documentation.master" inherits="Page" pagetitle="Specifying a Converter URI" keywords="Specifying a Converter URI"%>

Specifying a Converter URI

To specify a converter: URI, you need to specify

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:

converter:CSV:newline=lf:first=yes:?file:///c:/StylusStudio/examples/
three.txt 

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.