Configuring EDI Pipeline Properties
Pipeline properties are used in processing an incoming or outgoing EDI interchange when BizTalk Server is unable to determine the agreement that the incoming or outgoing interchange resolves to. In some cases, BizTalk Server uses the pipeline property to process the interchange; in others, BizTalk Server use the fallback agreement. For more information, see How Validation of an EDI Interchange Is Configured.
There are a few exceptions to this rule:
For X12, the character set used at runtime is determined by the pipeline property, even if the agreement has been determined. The character set described in the agreement is used only to validate agreement property settings.
For EDIFACT, if an incoming interchange does not have a UNA segment, BizTalk Server uses the delimiters specified in the EfactDelimiters pipeline property, BizTalk Server does not use the properties defined in the agreement the message resolves to or the fallback agreement.
Prerequisites
You must be logged on as a member of the BizTalk Server Administrators or BizTalk Server B2B Operators group.
EDI Pipeline Properties
The following properties can be set in EDI pipelines:
Property | Use | Values | Pipeline - Stage |
---|---|---|---|
AllowTrailingDelimiters | Generates trailing separators on the interchange received. | False (default) True |
EdiReceive- Disassemble AS2EdiReceive -Disassemble EdiSend - Assemble AS2EdiSend - Assemble |
CharacterSet | Specifies the character set to be used during run-time validation of outgoing EDI interchanges. This property is used for X12 processing only, not for EDIFACT. |
UTF8 (default) Basic Extended |
EdiReceive - Disassemble AS2EdiReceive -Disassemble EdiSend - Assemble AS2EdiSend - Assemble |
ConvertToImpliedDecimal | For an incoming interchange, converts an EDI number that is specified with the format Nn into a base-10 numeric value in the intermediate XML in BizTalk Server. This property is used for X12 processing only, not for EDIFACT. |
False (default) True |
EdiReceive - Disassemble AS2EdiReceive - Disassemble |
CreateXMLTagForTrailingSeparators | Creates empty XML tags for each of the trailing separators (if you have set AllowTrailingDelimiters to true). | False (default) True |
EdiReceive - Disassemble AS2EdiReceive - Disassemble |
DetectMID | Enables the EDI Disassembler to parse multiple interchanges in a single message. | True (default) False |
EdiReceive - Disassemble AS2EdiReceive - Disassemble |
EdiDataValidation | Enables EDI type (data elements) validation of outgoing EDI interchanges, including validation of field length, optionality, and repeat count in addition to EDI data element validation. | True (default) False |
EdiReceive - Disassemble AS2EdiReceive - Disassemble EdiSend - Assemble AS2EdiSend - Assemble |
EfactDelimiters | Indicates the delimiters to be used in processing an incoming interchange. Used if an incoming interchange does not have a UNA segment. The delimiters include the following: - UNA1 (Component data element separator) - UNA2 (Data element separator) - UNA3 (Decimal notation) - UNA4 (Release indicator) - UNA5 (Repetition separator) - UNA6 (Segment terminator) Note: This property is used for EDIFACT processing only, not for X12. |
0x3A, 0x2B, 0x2C, 0x3F, 0x20, 0x27 (defaults) | EdiReceive - Disassemble AS2EdiReceive - Disassemble |
IgnoreMessageEncoding | Specifies that the BatchMarker component will not set the EDI.EncodingType context property to <X12> or <EDIFACT>. This applies to custom pipelines when processing non-EDI messages. | False (default) True |
EdiReceive - ResolveParty AS2EdiReceive - ResolveParty |
MaskSecurityInformation | Mask authorization/password security information in the context property of an incoming EDI interchange to prevent information disclosure. Applies to the ISA1, ISA2, ISA3, and ISA4 fields for X12 interchanges; and the UNB6 fields for EDIFACT interchanges. | True (default) False |
EdiReceive - Disassemble AS2EdiReceive - Disassemble |
PreserveInterchange | Specifies that a batch received will be processed as a single unit. | False (default) True |
EdiReceive - Disassemble AS2EdiReceive - Disassemble |
RouteAckOn2WayPort | Returns an EDI acknowledgment over the open connection of a two-way request-response receive port. | True (default) False |
EdiReceive - Disassemble AS2EdiReceive - Disassemble |
UseDotAsDecimalSeperator | When set to True, the EDI receive pipeline uses a decimal notation of “.” instead of the decimal notation of the incoming document. | False (default) True |
EdiReceive – Disassemble AS2EdiReceive - Disassemble |
UseIsa11AsRepetitionSeparator | Specifies that ISA11 is used as a Repetition separator instead of a Standard identifier. Note: This property is used for X12 processing only, not for EDIFACT. | False (default) True |
EdiReceive - Disassemble AS2EdiReceive - Disassemble |
XmlSchemaValidation | Enables extended (BTS-XSD) validation of outgoing EDI interchanges. This applies only if the schema has been customized with elements whose data type is not an EDI data type. These added elements are not be validated by EDI validation, so will be covered by extended validation. | False (default) True |
EdiReceive - Disassemble AS2EdiReceive - Disassemble EdiSend - Assemble AS2EdiSend - Assemble |
To set a pipeline property
In BizTalk Server Administration Console, right-click the receive location or send port using the pipeline that you want to set properties for, and then click Properties.
Click the ellipsis button (…) next to the pipeline that you want to set properties for.
In the Configure Pipeline dialog box, enter the value for the property, and then click OK.