Convert a BizTalk map to a BizTalk Services Transform


Updated: November 27, 2015


Microsoft Azure BizTalk Services (MABS) is being retired, and replaced with Azure Logic Apps. If you currently use MABS, then Move from BizTalk Services to Logic Appsprovides some guidance on moving your integration solutions to Logic Apps.

If you're brand new to Logic Apps, then we suggest getting started here:

A command line tool that converts BizTalk Server maps to Microsoft Azure BizTalk Services Transforms/maps.

The BizTalk Map Migration Tool is available in the Tools package provided with the BizTalk Services SDK and can be downloaded from

If an existing BizTalk environment contains maps and functoids, the BTM Migration Tool can help migrate these artifacts to a BizTalk Service project. The BTM Migration Tool is a command line tool that uses the following parameters:

  • A BizTalk map (.btm)

  • Optional. A resulting BizTalk Service project Transform (.trfm)

The following items must be installed on the same computer where you run the tool:

  • BizTalk Server 2010 or newer versions

  • Microsoft Azure BizTalk Services SDK


If the tools fails, confirm Microsoft Azure BizTalk Services is listed at C:\Program Files (x86)\Microsoft Visual Studio 12.0\Common7\IDE\Extensions\Microsoft.

  1. Copy the files and schemas associated with the BizTalk map (.btm) to the BtmToTrfmConvertor.exe folder.

  2. Open a command window and go to the BtmToTrfmConvertor.exe folder.

  3. Enter the following syntax:

    BtmToTrfmConvertor.exe BTMFilePath OutputTrfm

    For example, enter the following:

    BtmToTrfmConvertor.exe c:\BizTalkFiles\CustomerInput.btm C:\Transforms\Output.trfm

    If you do not enter the output parameter, a .trfm file is created in the same directory and with the same name as the input .btm file.

The BTM Migration Tool does not migrate all the functoids from the BizTalk Server map. For a list of limitations and known issues with the tool, refer to the readme in the tools package.