": Exception Caught" error message when you try to use Visual Studio Team System 2010 TFS to build and deploy a BizTalk 2009 project that contains a map that references a schema in another project

Applies to: BizTalk Server 2009 EnterpriseBizTalk Server 2009 BranchBizTalk Server 2009 Developer More


Consider the following scenario:
  • You create a Microsoft BizTalk 2009 project in Microsoft Visual Studio 2008.
  • The BizTalk 2009 project contains a map that references a schema in another project.
  • You use Microsoft Visual Studio Team Foundation Server (TFS) 2010 to build and deploy the project.
In this scenario, you receive an error message that resembles the following:
<MapName.btm>: Exception Caught: The map contains a reference to a schema node that is not valid. Perhaps the schema has changed. Try reloading the map in the BizTalk Mapper. The XSD XPath of the node is: /*[local-name()='<Schema>']/*[local-name()='FaultMessage']/*[local-name()='Header']/*[local-name()='Application']


The TFS 2010 build process uses MSBuild 4.0. Assembly references within a BizTalk project can be partly named. Since MSBuild 4.0 loads the .Net Framework 4.0 versions of the assemblies instead of the .NET Framework 3.5 versions of these assemblies, the referenced schemas are not resolved correctly by the BizTalk mapper compiler.


Cumulative update information

For BizTalk Server 2009, the hotfix that resolves this issue is included in Cumulative Update 1 for BizTalk Server 2009. 

For more information about how to obtain the cumulative update package, click the following article number to view the article in the Microsoft Knowledge Base: 

2429050 Cumulative update package 1 for BizTalk Server 2009

Hotfix information

A supported hotfix is available from Microsoft. However, this hotfix is intended to correct only the problem that is described in this article. Apply this hotfix only to systems that are experiencing the problem described in this article. This hotfix might receive additional testing. Therefore, if you are not severely affected by this problem, we recommend that you wait for the next software update that contains this hotfix.

If the hotfix is available for download, there is a "Hotfix download available" section at the top of this Knowledge Base article. If this section does not appear, contact Microsoft Customer Service and Support to obtain the hotfix.

Note If additional issues occur or if any troubleshooting is required, you might have to create a separate service request. The usual support costs will apply to additional support questions and issues that do not qualify for this specific hotfix. For a complete list of Microsoft Customer Service and Support telephone numbers or to create a separate service request, visit the following Microsoft website: Note The "Hotfix download available" form displays the languages for which the hotfix is available. If you do not see your language, it is because a hotfix is not available for that language.


To apply this hotfix, you must have BizTalk Server 2009 installed on the computer.

Restart requirement

You do not have to restart the computer after you apply this hotfix.

Hotfix replacement information

This hotfix does not replace any other hotfixes.

File information

The English version of this hotfix has the file attributes (or later file attributes) that are listed in the following table. The dates and times for these files are listed in Coordinated Universal Time (UTC). When you view the file information, it is converted to local time. To find the difference between UTC and local time, use the Time Zone tab in the Date and Time item in Control Panel.
File nameFile versionFile sizeDateTimePlatform
Biztalkcommon.targetsNot applicable10,68107-Sep-201018:08Not applicable


Microsoft has confirmed that this is a problem in the Microsoft products that are listed in the "Applies to" section.


To use TFS 2010, you can use either Visual Studio Team System 2008 Service Pack 1 that has Forward Compatibility Update for Team Foundation Server 2010 installed or Microsoft Visual Studio Team Explorer 2010. For more information about Forward Compatibility Update, visit the following Microsoft Download Center website: For more information about BizTalk Server hotfixes, click the following article number to view the article in the Microsoft Knowledge Base:

2003907 Information on BizTalk Server hotfixes