Converting Custom EDI Message Types

DataDirect XML Converters supports the Standard Exchange Format (SEF). SEF allows you to describe structure of an EDI document based on an extension (or restriction) to a standard EDI message type. You can instruct the EDI XML Converter to read your SEF extension file and use it when converting your proprietary EDI to XML.

Working with SEF Files

You can build a SEF file based on the SEF specification. A copy of the SEF standard specification has been placed on the DataDirect Technologies web site:

http://www.datadirect.com/docs/sef161.pdf

A far easier way is to use the Stylus Studio EDI to XML module to create a SEF file. Using graphical tools, the EDI to XML editor allows you to

l Take advantage of the XML Converters' repository of numerous EDI dialects and versions
l Create a SEF file based on a sample EDI document or an EDI dialect
l Customize an EDI dialect to suit your needs - changing a segment from mandatory to optional, for example
l Modify XML Converters properties
l Preview conversions of custom EDI to XML

See Chapter 4 "Converting EDI to XML" for more information.

Process Overview

The process for converting a custom EDI message type includes the following steps:

1. Create a SEF file (mycustomEDI.sef, for example) that describes how the custom EDI message type differs from the EDI standard on which it is based - its extensions or restrictions, in other words. The purpose of this document is to teach the DataDirect XML Converters engine about the differences between your custom EDI message type and the EDI standard message type on which it is based.
2. Open the EDI file you want to convert to XML. Select File > Open, and then select the Open Using XML Converter check box.
3. Select the EDI XML Converter in the Select XML Converter dialog box.
5. Click OK to convert your custom EDI message type to XML.

Specifying the SEF File Location

You can specify the location of the SEF file in the Extension map file property using

l An absolute URL (c:/mypath/mycustomEDI.sef, for example)
l A relative path (mydir/mycustomEDI.sef, for example)

Note that if you are using a relative path, it must be relative to the same directories in which the DataDirect XML Converters executables are installed:

l For XML Converters for .NET - Stylus Studio installation directory\compontents\XML Converters for .NET\bin\XMLConverters.dll
l For XML Converters for .Java - Stylus Studio installation directory\compontents\XML Converters for Java\lib\XMLConverters.jar

In environments in which the location of the XMLConverters.* file cannot be determined, you must specify the location. For example:

l For XML Converters for .NET - set the registry key HKLM/Software/DataDirect/XML Converters 5.0/ProductLocation
l For XML Converters for Java - set the system property com.ddtek.xmlconverter.bindir, or com.ddtek.xmlconverter.libdir
 
Free Stylus Studio XML Training: