Configure Pipeline Dialog Box

 

Use the Configure Pipeline dialog box to edit configurable pipeline properties. The properties of a specific Configure Pipeline dialog box will depend on whether the pipeline is for sending or receiving, and what stages and components within those stages that the specific pipeline contains. Changes that you make are applied to the per-instance pipeline property, and will overwrite the properties set at design time.

Use thisTo do this
AllowUnrecognizedMessageIndicates whether to allow messages that do not have a recognized message type to be passed through the disassembler.

Default value: False
DocumentSpecNamesIndicate the namespace and typename of the schema or schemas to be applied to the document. For more information, see Using the Schema Collection Property Editor. To specify more than one schema, separate them using the | (pipe) character. For example:

Microsoft.Samples.BizTalk.EnvelopeProcessing.PO1|Microsoft.Samples.BizTalk.EnvelopeProcessing.PO2|Microsoft.Samples.BizTalk.EnvelopeProcessing.PO3

Default value: Empty collection (Collection)
EnvelopeSpecNamesIndicate the namespace and typename of the schema or schemas to be applied to the envelope. For more information, see Using the Schema Collection Property Editor. To specify more than one schema, separate them using the | (pipe) character. For example:

Samples.BizTalk.EnvelopeProcessing.Envelope1|Microsoft.Samples.BizTalk.EnvelopeProcessing.Envelope2

Default value: (Collection), BTF2Schemas.btf2_envelope
RecoverableInterchangeProcessThis property is used to control the interchange processing mode. When the disassembler component of a receive pipeline is configured to perform recoverable interchange processing, the messages contained in an interchange are extracted independently of each other.

Messages that are successfully extracted are propagated further down the receive pipeline. Messages that are identified within an interchange but are not successfully extracted are placed in the Suspended queue.
ValidateDocumentPerform a validation of the incoming message to the disassembler, including validating the envelope(s), when set to True.

Default value: False Note: You must specify a document schema (using the Document schema property) and have it deployed if you want to validate the document structure. If you fail to specify a document schema, you will receive a runtime error.
AllowByCertNameIndicates whether to enable party resolution based on the thumbprint of the signature certificate from the party from where the messages are received.
AllowBySIDSet to True if you want to enable party resolution based on the security identifier (SID) of the sender account.

If both properties are set to True, the AllowByCertName property takes precedence over the AllowBySID property, meaning that if both the certificate and the SID are available, the certificate subject is used.

If the party cannot be resolved by using the certificate subject, the component does not fall back to the AllowByCertName property, and the default value (s-1-5-7) is stamped for BTS.SourcePartyID.

Default value: True
Use thisTo do this
Pre-assembleSpecify the component properties required to perform any action on the message before the message is serialized.
AssembleSpecify the component properties for assembly, serialization, and format conversion of outbound messages. The list of properties and descriptions follows this table.
EncodeSpecify the component properties required to encode or encrypt the message.

Available component properties

PropertyDescription
AddXMLDeclarationSpecifies whether an XML declaration should be added to an outgoing document.
DocumentSpecNameThe schema for XML components to use for parsing or serializing documents.

Schemas specified in this property should have unique target namespaces. If any of the schemas have the same namespace, the validation of the document instances may not work as expected. If schemas must have the same namespace, you should either create a separate pipeline for each schema and specify one schema per XML Disassembler pipeline component or use one pipeline but do not specify any schemas as parameters for the XML Disassembler pipeline component.
EnvelopeDocSpecNameThe envelope specification for XML components to use for parsing or serializing documents.

Schemas specified in this property should have unique target namespaces. If any of the schemas have the same namespace, the validation of the document instances may not work as expected. If schemas must have the same namespace, you should either create a separate pipeline for each schema and specify one schema per each XML Disassembler pipeline component or use one pipeline but do not specify any schemas as parameters for the XML Disassembler pipeline component.
PreserveBomSpecifies whether to preserve the byte order mark (BOM). BOM is a byte sequence at the beginning of a stream or file that indicates the encoding of the stream or file.
ProcessingInstructionOptionSpecifies how processing instructions are added to outgoing documents. For more information about the ProcessingInstructionOption, see Processing Instructions in the XML Assembler Pipeline Component.
ProcessingInstructionsScopeProcessing instruction scope indicates where processing instructions are inserted into the assembled XML document stream, either at the document level or at the envelope level.
TargetCharsetThe character set for XML components to use for encoding output messages. If you set this property, BizTalk Server converts the outbound documents to the specified character set regardless of the original one. Examples of valid character sets you can specify for this property include UCS-2 and UTF-16. If you do not set a target character set, XML uses the UTF-8 protocol and flat files use the code page specified in the flat file schema.
XmlAsmProcessingInstructionsProvides information to the application that processes an XML document. Such information may include instructions about how to process the document, how to display it, and so on. Note: Processing instructions should conform to the W3C XML processing instruction standards.

About Pipelines, Stages, and Components
How to Create a New Pipeline
How to Configure Tracking for a Pipeline
Investigating Orchestration, Port, and Message Failures
Receive Pipelines
Send Pipelines
How to Configure the XML Assembler Pipeline Component
How to Configure the XML Disassembler Pipeline Component

Show: