XML Parser (XML File Converter)

 

Introduction

RC-WinTrans comes with a ready-made file converter for XML files.  However, XML files can have a variety of structures, so in many cases an additional converter must be realized in order

to support a specific XML file structure.  Essentially, the XML file converter needs to know which parts of a certain XML file are to be translated.  This information is provided to the XML converter via XSL extended stylesheets.  These stylesheets are called XML parsers.  An XML parser points out the elements to be translated in an XML file.

 

RC-WinTrans processes (reads/writes) XML files using an XSL transformation.  An XSL stylesheet acts as a parser reading a certain XML file format and specifying which data is to be translated.

 

 

Obtaining an XML Parser for a Specific XML File

Please contact Schaudin.com if you need an XML parser file to translate your specific XML format file with RC-WinTrans.  You should also send us an example of your XML file(s).

 

The RC-WinTrans Developer Help contains information and examples to help maintain/create XML parser files.

 

 

Activating an XML Parser File

 

Option 1:  Local Folder

Place the XML parser file in the same folder as the XML files to be translated.  This causes the XML parser to be used only on XML files located in the same folder.

 

If you're developing an XML parser, the parser file and an XML file (to be translated) will be in one folder.  The XML file can be directly added to an RC-WinTrans project.  RC-WinTrans will automatically use the XML parser if the parser file meets the predefined file naming convention.

 

Option 2:  General File Converters Folder

Place the XML parser file in the RC-WinTrans installation folder named "FileConverters" (<installdir>\RC-WinTrans X8\FileConverters).  This causes the XML parser to be used globally for all XML files (supplied by a particular XML parser file).

 

RC-WinTrans will look for the XML parser file in the same folder as the one containing the XML file to be translated (local folder) first.  If a converter is not found there, RC-WinTrans will check the "FileConverters" folder for the required XML parser.

 

 

XML Parser File Naming Convention

XML parser files (file extension =.xsl) have a predefined file naming convention.  It dictates that the file name begin with the prefix "XMLParser-" followed by the name of the root element of the XML file for which the parser is made.

 

EXAMPLE:  "XMLParser-Symbols.xsl"; "XMLParser-docroot.xsl"

 

Note:  if the name of the XML root element contains a namespace then an underline character must be used in the file name for the ':' between the namespace and the root element name

 

EXAMPLE:  root element name       <mnts:materials>

                  XML parser file name    "XMLParser-mnts_materials"

 

 

Examples

Examples to use in creating your own XML parser (XSL stylesheet) to translate an XML file can be found in the RC-WinTrans Developer Help (Help file: "X8DeveloperHelp.htm").

 

 

^ TOP ^