Edit

Set map compilation and output settings

  • Article

Set the map properties in the BizTalk mapper.

Using these map properties, you can set how maps are compiled, include or exclude an XML declaration, and set the encoding.

This topic shows you how to set these properties on your map.

Set the map-level compilation

Starting with BizTalk Server 2016, you choose the XslTransform or the XslCompiledTransform class to compile your maps.

  1. Open your map in the Grid view.

  2. Right-click anywhere in the mapper grid, and select Properties.

  3. Set the Use XSL Transform property:

    Option Description
    Undefined The registry flag for the XslTransform setting is used:
    • 64-bit host instances: HKLM\SOFTWARE\Microsoft\BizTalk Server\3.0\Configuration
    • 32-bit host instances, and Visual Studio’s Test Map functionality: HKLM\SOFTWARE\Wow6432Node\Microsoft\BizTalk Server\3.0\Configuration
    True The map level compilation property is set to XslTransform (legacy behavior)
    False The map level compilation property is set to XslCompiledTransform

Note

Starting with BizTalk Server 2013, the mapper compilation behavior was changed from XslTransform to XslCompiledTransform. The What the Mapper Updates Mean for You blog post provides a great explanation of the behavior, and its potential impact.

Starting with BizTalk Server 2016, you can choose which class to compile your maps.

Include or exclude an XML declaration

You can choose whether an XML declaration is output or not.

  1. Open your map in the Grid view.
  2. Right-click anywhere in the mapper grid, and select Properties.
  3. In the drop-down list for the Omit XML Declaration property, select Yes to omit an XML declaration. Select No not to omit an XML declaration.

An XML declaration would appear (if you selected No) similar to the following.

<?xml version="1.0" encoding="utf-8"?>

Set encoding for output instance data

Encoding provides the run-time engine with the information it needs to determine which character set to use when creating the output result of a map.

  1. Open your map in the Grid view.
  2. Right-click anywhere in the mapper grid, and select Properties.
  3. In the drop-down list for the XSLT Encoding property, select the character set you want used for the output instance data.

See Also

Compiling and Testing Maps
Using BizTalk Mapper
Valid BizTalk Mapper XSLT Encoding Types