Promoting Property Vs Distinguished fields

 

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.

 

Property Promotion	Distinguish field
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

Message 1:

<ns0:Contact xmlns:ns0="http://BizTalk_Server_Project1.Contacts">

<Name>Name_0</Name>

<Age>10</Age>

<Email>Email_0</Email>

<Phone>Phone_0</Phone>

</ns0:Contact>

 

Message 2:

 

<ns0:Contact xmlns:ns0="http://BizTalk_Server_Project1.Contacts">

<Name>Name_0</Name>

<Age>25</Age>

<Email>Email_0</Email>

<Phone>Phone_0</Phone>

</ns0:Contact>

 

Thanks

SreenivasaRagavan.