Quick Tip: BizTalk Schema Identity

  • Sandro Pereira
  • Aug 17, 2011
  • 2 min read

In BizTalk Server development, understanding how the engine identifies a message is crucial. Many developers mistakenly believe that the physical filename (e.g., MySchema.xsd) defines the schema’s identity. This is incorrect.

The Formula for Identity

BizTalk defines the unique MessageType of a schema using a simple combination:

  • Target Namespace # Root Node Name

For example, if your:

  • namespace is http://SandroPereira.com/Orders.
  • And your root node is PurchaseOrder.

Then the MessageType is: http://SandroPereira.com/Orders#PurchaseOrder

In other words, BizTalk uses this combination to identify and resolve schema references. Then… changing the filename of a schema does not make a new BizTalk schema!!

📝 One-Minute Brief

BizTalk Server identifies messages using a unique MessageType derived from the combination of Target Namespace#Root Node Name. A common misconception is that changing a schema’s filename creates a new identity; it does not. To create a unique schema identity or differentiate between similar schemas, you must modify either the namespace or the root node name within the schema editor.

You could modify the schema namespace or the name of the root node in order to enable BizTalk to differentiate among the remaining schemas.

Always remember: BizTalk ignores the .xsd filename for resolution. It only cares about what is inside.

Hope you find this helpful! If you liked the content or found it useful and would like to support me in writing more, consider buying (or helping to buy) a Star Wars Lego set for my son. 

Thanks for Buying me a coffe
Author: Sandro Pereira

Sandro Pereira lives in Portugal and works as a consultant at DevScope. In the past years, he has been working on implementing Integration scenarios both on-premises and cloud for various clients, each with different scenarios from a technical point of view, size, and criticality, using Microsoft Azure, Microsoft BizTalk Server and different technologies like AS2, EDI, RosettaNet, SAP, TIBCO etc. He is a regular blogger, international speaker, and technical reviewer of several BizTalk books all focused on Integration. He is also the author of the book “BizTalk Mapping Patterns & Best Practices”. He has been awarded MVP since 2011 for his contributions to the integration community.

Leave a Reply

Your email address will not be published. Required fields are marked *

The Ultimate Cloud
Management Platform for Azure

Supercharge your Azure Cost Saving

Learn More
Turbo360 Widget

Back to Top