EDIFACTTranslator Configuration
The control accepts one or more of the following configuration settings. Configuration settings are similar in functionality to properties, but they are rarely used. In order to avoid "polluting" the property namespace of the control, access to these internal properties is provided through the Config method.EDIFACTTranslator Configuration Settings
CloseStreamAfterTranslate: If true, the control will close the output stream after translation.When set to True (default), the control will close the output stream specified by SetOutputStream after Translate returns. If set to False the output stream will remain open. The default value is True. | |||||||
CrossFieldValidationEnabled: Enables cross-field validation rules.If true, cross-field validation rules present in the document schema will be checked. The default value is false. Note, Bots Schema Files do not support syntax rules, therefore CrossFieldValidation rules will never execute for these schemas. | |||||||
Encoding: The character encoding to be applied when reading and writing data.If the data contains non-ASCII characters this setting should be specified so characters are properly preserved. This value should be set to a valid character set such as "UTF-8" or "ISO-8859-1". | |||||||
IncludeFooters: Whether to include footer information in the XML.This setting specifies whether footer information is included in the translated XML. For EDIFACT this includes UNT, UNE, and UNZ. For X12 this include GE, SE, and IEA. The default value is False. | |||||||
RenamingRulesData: The renaming rules data.This setting may be used to get or set renaming rules without using a file on disk. When calling SaveRenamingRules
or LoadRenamingRules set the RuleFile parameter of the method to empty string to use the value in this
setting instead of a file on disk. For instance:
//Save Renaming Rules editranslator.SaveRenamingRules(""); string ruleData = editranslator.Config("RenamingRulesData"); //Load Renaming Rules editranslator.Config("RenamingRulesData=" + ruleData); editranslator.LoadRenamingRules(""); | |||||||
ComponentDelimiter: The delimiter character to use to separate components.When set, this changes the default delimiter to use to separate components within a data element. The default value depends on the EDI specification being used. | |||||||
ElementDelimiter: The delimiter character to use to separate data elements.When set, this changes the default delimiter to use to separate data elements within a segment. The default value depends on the EDI specification being used. | |||||||
ReleaseChar: The character to use to escape delimiters within values.When set, this changes the default escape character. The default value depends on the EDI specification being used. | |||||||
RepetitionChar: The repetition character.When set, this changes the default repetition character. The default value depends on the EDI specification being used. | |||||||
SegmentDelimiter: The delimiter character to use to separate segments.When set, this changes the default delimiter to use to separate segments within an EDI document. The default value depends on the EDI specification being used. | |||||||
UseSchemaId: Specifies whether to use the Id from the schema as the XML element name.This setting specifies whether the XML element name written to output is taken from the Id of the element defined in the schema.
It is only applicable to RSSBus JSON schemas.
For instance, given an EDIFACT document with the segment:
UCM+1++7 When this setting is True the XML generated may look like:
<UCMLoop1 type="Loop"> <UCM type="Segment"> <_0062 desc="Message reference number">1</_0062> <S009 type="Composite" desc="MESSAGE IDENTIFIER"><_0065></_0065></S009> <_0083 desc="Action, coded">7</_0083> </UCM> </UCMLoop1> Where the elements "_0062", "S009", etc. are taken from the Id values of the EDI elements in the schema files. Note: In order to produce valid XML, elements that would begin with a digit are prefixed with the "_" character. In contrast if UseSchemaId is set to False (default) the XML generated may look like:
<UCMLoop1 type="Loop"> <UCM type="Segment"> <UCM01 desc="Message reference number">1</UCM01> <UCM02 type="Composite" desc="MESSAGE IDENTIFIER"><UCM0201></UCM0201></UCM02> <UCM03 desc="Action, coded">7</UCM03> </UCM> </UCMLoop1>The default value is False. This setting is only applicable when using RSSBus JSON schemas. | |||||||
StrictSchemaValidation: Specifies the behavior during schema validation.This setting specifies what happens when performing schema validation and a validation
warning occurs. By default this value is set to 1 (Warn) and the Warning event will fire, but processing
will not stop. See the WarnCode parameter list in the Warning event for details about
possible validation warnings. Possible values for this setting are:
|
Base Configuration Settings
CodePage: The system code page used for Unicode to Multibyte translations.
The default code page is the Active Code Page (0).
The following is a list of valid code page identifiers:
|