As you most likely know, when a document is received by a BizTalk Server adapter, the adapter creates a BizTalk message for it. The BizTalk message contains the received document and a message context. The message context is a container for properties used by BizTalk Server when processing the document. Each property in the Message Context consists of three parts: a name, a namespace, and a value.
Message context properties are added to the message context throughout the message’s lifetime as it passes through the BizTalk Server. These properties:
- Are either extracted from the message itself, for example, order ID or shipment number.
- Or added by pipelines and adapters at the receive location, for example, transport name or receive port name.
There are mainly two benefits of this context:
- The first is to provide the various components of BizTalk with easy access to these properties, without having to parse the message.
- The second is to support content-based routing.
📝 One-Minute Brief
A comprehensive whitepaper that explains BizTalk message context properties, their role in routing and processing, and the differences between Property Fields and Distinguished Fields. It also provides a complete reference of all BizTalk property schemas and out‑of‑the‑box adapter properties, helping developers better understand, troubleshoot, and extend BizTalk solutions.
There are two different types of message context properties used by BizTalk, as described below:
- Distinguished Fields.
- Property Fields.
In this whitepaper, you will learn the key differences between Distinguished and Property Fields, but most importantly, you will have access to a complete list of known property schemas and properties used internally by the BizTalk Server out-of-the-box components.
What’s in store for you?
This whitepaper will give you a detailed understanding of the following:
- BizTalk Message Context Properties
- What are Property fields, and how to promote properties?
- What are distinguished fields, and how to create a distinguished field?
- Summary of differences between Property Fields and Distinguished Fields
- System property schema and properties
- Error Report property schema and properties
- Legacy schema and properties
- Microsoft BizTalk XLANGs BTXEngine schema and properties
- Message Tracking schema and properties
- BizTalk Framework Schema and Properties
- MIME-SMIME Property Schema and Properties
- XML and Flat File Property Schema and Properties
- File adapter property schema and properties
- FTP Adapter Property Schema and Properties
- HTTP Adapter Property Schema and Properties
- MQSeries Adapter Property Schema and Properties
- MSMQ Adapter Property Schema and Properties
- POP3 Adapter Property Schema and Properties
- SMTP Adapter Property Schema and Properties
- SFTP Adapter Property Schema and Properties
- SOAP Adapter Property Schema and Properties
- SQL Adapter Property Schema and Properties
- WCF Adapters Property Schema and Properties
- Windows SharePoint Services Adapter Property Schema and Properties
- Azure Service Bus Adapter Property Schema and Properties
- Azure Blob Storage Adapter Property Schema and Properties
- Azure Event Hubs Adapter Property Schema and Properties
- Office 365 Outlook Calendar Adapter Property Schema and Properties
- Office 365 Outlook Contact Adapter Property Schema and Properties
- Office 365 Outlook Email Adapter Property Schema and Properties
- SharePoint Online Adapter Property Schema and Properties
- Microsoft BizTalk Accelerator for HL7 (BTAHL7) Property Schema and Properties
- How to write or promote properties in the context of a message through the BizTalk API
- Promote method
- Write method
- Property Schema Base
Where can I download it?
You can download the whitepaper here:
I hope you enjoy reading this paper, and any comments or suggestions are welcome.
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.
