Symptoms

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']

Cause

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.

Resolution

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: 2429050Cumulative 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:

http://support.microsoft.com/contactus/?ws=supportNote 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.

Prerequisites

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 name

File version

File size

Date

Time

Platform

Biztalkcommon.targets

Not applicable

10,681

07-Sep-2010

18:08

Not applicable

Microsoft.biztalk.mapper.compiler.dll

3.8.443.2

157,576

07-Sep-2010

18:08

x86

Microsoft.biztalk.mapper.om.dll

3.8.443.2

128,888

07-Sep-2010

18:08

x86

Microsoft.biztalk.schemaeditor.dll

3.8.443.2

214,912

07-Sep-2010

18:08

x86

Microsoft.biztalk.tom.dll

3.8.443.2

874,352

07-Sep-2010

18:08

x86

Microsoft.biztalk.tom.dll

3.8.443.2

874,352

07-Sep-2010

18:08

x86

Microsoft.visualstudio.biztalkproject.base.dll

3.8.443.2

32,664

07-Sep-2010

18:08

x86

Microsoft.visualstudio.biztalkproject.buildtasks.dll

3.8.443.2

41,384

07-Sep-2010

18:08

x86

Status

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

References

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:

Visual Studio Team System 2008 Service Pack 1 Forward Compatibility Update for Team Foundation Server 2010 (Installer)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

Need more help?

Want more options?

Explore subscription benefits, browse training courses, learn how to secure your device, and more.

Communities help you ask and answer questions, give feedback, and hear from experts with rich knowledge.