How to Configure the XML Disassembler Pipeline Component

The XML Disassembler pipeline component should be used in the Disassemble stage of a receive pipeline.

To configure the properties for the XML Disassembler pipeline component

  1. Drag the XML Disassembler pipeline component into the Disassemble stage of a receive pipeline.

  2. In the Properties window, in the Pipeline Component Properties section, do the following.

    Use this To do this
    Allow unrecognized message Indicates whether to allow messages that do not have a recognized message type to be passed through the disassembler.

    Default value: False
    Document schemas Indicates the namespace and typename of the schema or schemas to be applied to the document. For more information, see How to Use the Schema Collection Property Editor.

    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.

    Default value: Empty collection
    Envelope schemas Indicates the namespace and typename of the schema or schemas to be applied to the envelope. For more information, see How to Use the Schema Collection Property Editor.

    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.

    Default value: Empty collection
    Recoverable Interchange Processing When "false" - indicates that entire interchange is disassembled as a unit (if any contained message fails, entire interchange is suspended).

    When "true" - indicates that messages within interchange are extracted individually by disassembler with possibility of some propagating through messaging pathway and others being suspended.

    For more information on recoverable interchange processing, see Recoverable Interchange Processing.
    Validate document structure When True, performs a validation of the incoming message against document and optionally envelope schemas.

    If a promoted property does not have a default or fixed value and this property is set to False, the property is not promoted.

    Default value: False Note: When True, you may receive a "Two or more of the selected schema share the same target namespace" error if you specify two or more schemas for the Document schemas or Envelope schemas properties.

See Also

XML Disassembler Pipeline Component
XML and Flat File Property Schema and Properties
Pipelines-AssemblerDisassembler (BizTalk Server Samples Folder)
Configuring Native Pipeline Components