VDATranslator Component

Properties Methods Events Configuration Settings Errors

The VDATranslator component is optimized for VDA translation, providing a simple way to convert VDA documents to and from XML or JSON.

Syntax

nsoftware.IPWorksEDI.Vdatranslator

Remarks

The component provides a way to convert VDA to XML or JSON and vice versa.

Getting Started

The component will convert a document from the format specified by InputFormat to the format specified by OutputFormat. In practice this allows for converting to XML or JSON from EDI and vice versa.

Before translating from EDI to XML or JSON it is recommended to load a schema using the LoadSchema method. This ensures additional information can be included in the XML or JSON document. If a schema is specified the XML or JSON will include types and descriptions as element attributes which are useful for interpreting the data.

EDI elements may optionally be renamed when creating XML. To define how an element is renamed add a renaming rule by calling AddRenamingRule.

After calling Translate the resulting output will contain the EDI, XML or JSON data as defined by OutputFormat. If the output data is XML the ExportXMLSchema method may be called to export a schema (.xsd) defining the structure of a valid XML document. XML documents which adhere to this document may be translated from XML to EDI.

Input and Output Properties

The component will determine the source and destination of the input and output based on which properties are set.

The order in which the input properties are checked is as follows:

When a valid source is found the search stops. The order in which the output properties are checked is as follows:

SetOutputStream
OutputFile
OutputData: The output data is written to this property if no other destination is specified.

Property List

The following is the full list of the properties of the component with short descriptions. Click on the links for further details.


InputData	The data to translate.
InputFile	The file to translate.
InputFormat	The format of the input data.
OutputData	The translated data.
OutputFile	The file to which the translated data will be written.
OutputFormat	The format of the output data.
Overwrite	Whether to overwrite the file.
RenamingRule	The rule defining how EDI elements are renamed when translating to XML or JSON.
RenamingRuleCount	The number of renaming rules.
RenamingRuleIndex	The index of the current renaming rule.
SchemaFormat	The format of the schema file.
Suffix	What to append after each segment delimiter.
UseSchemaName	Whether the output XML uses element names based on name defined in the schema.

Method List

The following is the full list of the methods of the component with short descriptions. Click on the links for further details.


AddRenamingRule	This method adds a renaming rule to define how an EDI element is renamed when translating to XML.
Config	Sets or retrieves a configuration setting.
DisplaySchemaInfo	Returns a string showing the structure of the schema defining the document.
ExportXMLSchema	Exports a XML schema.
GenerateAck	Generates an EDI acknowledgement.
LoadRenamingRules	Loads a set of renaming rules from file.
LoadSchema	Loads a schema file describing a Transaction Set.
LoadSchemaStream	Loads a schema stream describing a Transaction Set.
Reset	Resets the state of the control.
SaveRenamingRules	Saves the current renaming rule set to a file.
SetInputStream	The stream to which the component will read the data to translate.
SetOutputStream	The stream to which the component will write the translated data.
Translate	Translates the specified data.

Event List

The following is the full list of the events fired by the component with short descriptions. Click on the links for further details.


EndFunctionalGroup	Fires whenever a control segment is read that marks the end of an interchange.
EndInterchange	Fires whenever a control segment is read that marks the end of an interchange.
EndLoop	Fires when the end of a loop is detected in a transaction set.
EndTransaction	Fires whenever a control segment is read that marks the end of a transaction.
Error	Information about errors during data delivery.
ResolveSchema	Fires whenever a new transaction set is encountered and no schema is found for it.
Segment	Fires whenever a data segment in a transaction set is read.
StartFunctionalGroup	Fires whenever a control segment is read that marks the start of a functional group.
StartInterchange	Fires whenever a control segment is read that marks the start of an interchange.
StartLoop	Fires when the starting of a loop is detected in a transaction set.
StartTransaction	Fires whenever a control segment is read that marks the start of a transaction.
Warning	Fires whenever a validation warning is encountered.

Configuration Settings

The following is a list of configuration settings for the component with short descriptions. Click on the links for further details.


CloseStreamAfterTranslate	If true, the component will close the output stream after translation.
ComponentDelimiter	The delimiter character to use to separate components.
CrossFieldValidationEnabled	Enables cross-field validation rules.
ElementDelimiter	The delimiter character to use to separate data elements.
Encoding	The character encoding to be applied when reading and writing data.
IncludeEmptyElements	Whether to include empty data elements in a composite element.
IncludeFooters	Whether to include footer information in the XML.
JSONElementPrefix	An optional prefix for reserved names when translating to JSON.
LastIXControlNumber	The control number of the most recently parsed interchange.
LastTransactionControlNumber	The control number of the most recently parsed transaction.
ReleaseChar	The character to use to escape delimiters within values.
RenamingRulesData	The renaming rules data.
RepetitionChar	The repetition character.
SegmentDelimiter	The delimiter character to use to separate segments.
StrictSchemaValidation	Specifies the behavior during schema validation.
UseXMLComments	Whether the human readable description is stored as an attribute or XML comments.
BuildInfo	Information about the product's build.
GUIAvailable	Tells the component whether or not a message loop is available for processing events.
LicenseInfo	Information about the current license.
UseInternalSecurityAPI	Tells the component whether or not to use the system security libraries or an internal implementation.