Interesting information in KB:
How to use distinguished fields and promoted properties in a BizTalk Server project” http://support.microsoft.com/kb/942250
“…
  • A promoted property may not be available as a promoted property after you write a value into the message context. This situation can occur if the value that you write into the message context has the same name and namespace that was used to promote the property.
  • Properties that have a null value are not permitted in the message context. Therefore, if a null value is written into the message context, this value will be deleted.
    …”
BTW What is it “a null value”?
  • Is it <shipDate xsi:nil=”true”></shipDate> ?
  • Is it absence of the value <shipDate></shipDate> ?
  • Is it “closed tag <shipDate /> ?
  • Is it absence of the whole node?
In http://www.w3.org/TR/2004/REC-xmlschema-0-20041028/#Nilswe have description of it. But frequently we’ve got different interpretation of this term. And I am not sure about interpretation in KB
And let me add one more, not obvious:
  • Distinguished fields and promoted properties have to always get Min/Max Occurs = 1. (Not 0, not “unbounded”, only 1)