<%@ page language="C#" masterpagefile="~/templates/Documentation.master" inherits="Page" pagetitle="How to Create a Custom XML Conversion Definition" keywords="How to Create a Custom XML Conversion Definition"%>

How to Create a Custom XML Conversion Definition

To create a custom XML conversion definition (.conv file):
1. Select File > New > Custom XML Conversion from the Stylus Studio menu.

The New Custom XML Conversion Definition dialog box appears.

Figure 148. New Custom XML Conversion Definition Dialog Box

2. Click the browse button ( ) and select the file you want to use to configure the custom XML conversion definition settings. See Choosing an Input File if you need help with this step.

The Open dialog box appears. By default, the Files of Type field filter is set to display .txt, .edi, .csv, .tab, .log, and .bin files.

Tip

 

The file you select should be representative of other files of this type that you wish to convert to XML using the custom XML conversion definition you are creating.

3. Click the Open button.

Stylus Studio displays the file URL in the first field of the New Custom XML Conversion Definition dialog box.

4. Optionally, change the default file encoding and layout settings. See Specifying File Settings if you need help with this step.
5. Click OK.

Stylus Studio displays the file you selected in the Custom XML Conversion Editor.

6. Examine the file and its properties as it was read into the Custom XML Conversion Editor by Stylus Studio.
7. Modify the file layout, its regions, and its fields as needed. See Working with Regions and Working with Fields if you need help with this step.
8. Modify the properties that govern XML output as needed. See Controlling XML Output if you need help with this step.
9. Click the Preview Results button ( ).

Stylus Studio displays the Save As dialog box.

10. Enter a name for the custom XML conversion definition and click Save.
11. If the results are not what you expect, return to step 7 and to step 8. You might also considering revisiting the input file, making fundamental changes there, and then reloading it.

The steps in this process are described in greater detail in the following sections.

Tip

 

Once you have created and saved a custom XML conversion definition, you can use it to open other non-XML files of the same type, just as you would with any other DataDirect XML Converter. See <xHyperlink>Using XML Converters to Open a Non-XML File as XML for more information.