The property fields are promoted so that their values can be referenced for content based routing purposes inside orchestration, Pipeline, Receive and Send ports. A term Promoting a Property is commonly used to describe a message’s promoted properties is message context.
Promoted field available in all the following BizTalk artifacts such as Receive, send ports, Pipelines, Orchestration.
Promoted properties are max Length of 255 Char
Promoted properties are persisted to the Message box database.
Distinguish filed only available in single instance of Orchestration.
Distinguish filed can be any length.
Distinguished fields have less of a performance impact than promoted properties, as
They are not persisted to the MessageBox database. Instead, they are essentially XPath
aliases, which simply point to the appropriate XML data field.
Here I am promoting the Age Property of the Contact.XSD
Once I Promote the age Property I can Filter the message (CBR) based on Age in my Receive , Send and Orchestration.
After promoting the Age Property you see difference in Age Element. ( Small Yellow circle on top).
Once you have deployed the solution with the promoted properties, they may be used to
perform content-based routing (CBR).
for example: Suppose I am receiving two Message with different age I can Route this message to two different send port based on age.
First send port : Only Age > =10
Second Send port Only < 10