Edit

Configure the XML Assembler Pipeline Component in BizTalk Server

  • Article

The XML Assembler pipeline component is used to wrap the XML documents into the XML envelopes before sending a message from BizTalk Server.

Configure the properties for the XML Assembler pipeline component

  1. Drag the XML Assembler pipeline component into the Assemble stage of a send pipeline.

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

    • Add processing instructions: Your options:

      • Append (default): Value of Add processing instructions text should append to pre-existing processing instructions in the message.

      • Create New: Value of Add processing instructions text entered in the field should overwrite or replace any pre-existing processing instructions in the message.

        If Create New is selected, the Add processing instructions text must contain valid processing instructions.

      • Ignore: If processing instructions text exists in the message, it is removed.

    • Add processing instructions text: Specifies the XML processing instructions to add to the beginning of the target XML document. Default value: None

      Processing instruction text should conform to the W3C XML processing instruction standards.

    • Add XML declarations: When True (default), adds an XML declaration similar to the following to the outgoing document: <?xml version='1.0' encoding='UTF-8'>. Encoding is determined by the target document encoding set at run time.

    • Document schemas: Indicates the namespace and typename of the schema or schemas to be applied to the document. Default value: Empty collection

      For more information, see How to Use the Schema Collection Property Editor.

      You may receive a Two or more of the selected schema share the same target namespace error if you enter two or more schemas for the Document schemas property.

    • Envelope schemas: Indicates the namespace and typename of the schema or schemas that will be applied to the envelope. Default value: Empty collection

      For more information, see How to Use the Schema Collection Property Editor.

      You may receive a Two or more of the selected schema share the same target namespace error if you enter two or more schemas for the Envelope schemas property.

    • Preserve byte order mark: Specifies whether to add a byte order mark (BOM) to the documents produced by the assembler component. Default value: True

    • Processing instruction scope: Specifies whether the processing instruction is defined on the outermost envelope or at the document level. Default value: Document

    • Target charset: Specifies the character set used to encode outgoing messages. Default value: None

See Also

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