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

  1. 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.

  2. Click the ellipsis button (…) next to the pipeline that you want to set properties for.

  3. In the Configure Pipeline dialog box, enter the value for the property, and then click OK.

See Also

How Validation of an EDI Interchange Is Configured