Skip to content

Latest commit

 

History

History
57 lines (37 loc) · 3.71 KB

how-to-configure-the-xml-assembler-pipeline-component.md

File metadata and controls

57 lines (37 loc) · 3.71 KB
Raw
description title ms.custom ms.date ms.service ms.reviewer ms.suite ms.topic
Learn more about: Configure the XML Assembler Pipeline Component in BizTalk Server
How to Configure the XML Assembler Pipeline Component
01/13/2020
biztalk-server
article

Configure the XML Assembler Pipeline Component in BizTalk Server

The XML Assembler pipeline component is used to wrap the XML documents into the XML envelopes before sending a message from [!INCLUDEbtsBizTalkServerNoVersion].

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)