Informazioni sulle proprietà di contesto di messaggi BizTalk

Quando in un adapter BizTalk Server viene ricevuto un documento, viene creato un messaggio BizTalk per il documento. Oltre al documento ricevuto, nel messaggio BizTalk è contenuto anche un contesto del messaggio. Il contesto del messaggio è un contenitore di varie proprietà utilizzate in BizTalk Server durante l'elaborazione del documento. Ciascuna proprietà è composta da tre elementi: un nome, uno spazio dei nomi e un valore. La proprietà di contesto del messaggio illustrata di seguito, ad esempio, descrive l'ID di interscambio di un documento:

<Property Name="InterchangeID" Namespace="http://schemas.microsoft.com/BizTalk/2003/system-properties" Value="{AC07BF30-2F1A-42B0-8390-191EF38BA839}"/>  

Le proprietà di contesto di un messaggio vengono aggiunte al contesto del messaggio durante la permanenza del messaggio in BizTalk Server.

I due diversi tipi di proprietà di contesto del messaggio utilizzati in BizTalk sono descritti di seguito:

Campi delle proprietà

I campi delle proprietà sono proprietà di contesto dei messaggi utilizzate nel motore di messaggistica di BizTalk per il routing dei documenti, per il rilevamento dei messaggi e per la valutazione nelle orchestrazioni. È possibile elevare in modo esplicito un campo in un documento al contesto del messaggio come campo Proprietà modificando lo schema per il documento nell'editor dello schema BizTalk Server disponibile in Visual Studio. A tal fine è necessario che allo schema del documento sia associato uno schema proprietà. I campi delle proprietà sono limitati a 255 caratteri. La proprietà IsPromoted dei campi Property nel contesto del messaggio è impostata su True.

Campi differenzianti

I campi differenzianti sono proprietà di contesto dei messaggi che non richiedono uno schema proprietà separato e che sono accessibili solo dalle orchestrazioni. I campi differenzianti non possono essere utilizzati per il routing o il rilevamento. Poiché i campi differenzianti non richiedono uno schema proprietà separato, nel motore di orchestrazione verrà utilizzato meno overhead per la valutazione dei campi differenzianti rispetto alla valutazione dei campi delle proprietà. Per la valutazione dei campi delle proprietà è necessaria una query XPath, mentre per la valutazione dei campi differenzianti la query XPath non è necessaria in quanto il disassembler della pipeline li popola nel contesto e il motore di orchestrazione legge i valori inseriti nella cache. Se tuttavia il motore di orchestrazione non è in grado di reperire la proprietà nel contesto, per trovare il valore avvierà la query XPath. I campi differenzianti non presentano limitazioni relativamente alle dimensioni. La proprietà IsPromoted dei campi Distinguished nel contesto Message è impostata su False.

Riepilogo delle differenze fra campi delle proprietà e campi differenzianti

Nella seguente tabella vengono riepilogate le differenze e le analogie tra campi delle proprietà e campi differenzianti:

Attributo	Campo di proprietà	Campo differenziante
Proprietà IsPromoted	Vero	Falso
Limite delle dimensioni	255 caratteri	Nessun limite
Utilizzato per il routing	Sì	No
Utilizzato per il rilevamento	Sì	No
Utilizzato nell'orchestrazione	Sì	Sì
Schema proprietà necessario	Sì	No
Accessibile da pipeline e porte	Sì	No

Vedere anche

Modalità di utilizzo del contenuto dei messaggi per controllare l'elaborazione dei messaggi