Your Guide to BizTalk Message Context Properties whitepaper

As you most likely are aware, when a document is received by a BizTalk Server adapter, the adapter creates a BizTalk message for the document. The BizTalk message contains the document that was received as well as a message context. The message context is a container for various properties that are used by BizTalk Server when processing the document. Each property in the Message Context is composed of three things, a name, a namespace, and a value.

Message context properties are added to the message context throughout the lifetime of the message 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, an easy access to these properties, without having to parse the message
  • The second is to support content-based routing.

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 schema 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 messages through the BizTalk API
    • Promote method
    • Write method
    • Property Schema Base

Where I can download it

You can download the whitepaper here:

I hope you enjoy reading this paper and any comments or suggestions are welcome.

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.

BizTalk360
BizTalk Server

Over 500+ customers across
30+ countries depend on BizTalk360

Learn More
Serverless360
Azure

Manage and monitor serverless
components effortlessly

Learn More
cerebrata
Azur Developers

Cross platform desktop tool
for managing your Azure Resources

Learn More

Back to Top