Utilizzo di campi distinti e campi delle proprietà

I campi distinti sono dati di messaggio di particolare interesse usati principalmente per prendere decisioni o per modificare i dati nell'orchestrazione.

Le proprietà del messaggio sono dati, contenuti del messaggio stesso, o "metadati", informazioni di contesto sul messaggio, ad esempio timestamp o informazioni di routing. È possibile utilizzare proprietà del contesto di messaggio definite dal sistema o proprietà del contesto di trasporto oppure definire proprietà personalizzate facendo riferimento ai campi dello schema dall'interno di uno schema di proprietà. Le proprietà vengono usate nelle sottoscrizioni e nelle correlazioni.

• È possibile designare un campo in uno schema come campo distinto o campo proprietà utilizzando la finestra di dialogo Alza di livello proprietà dall'interno dell'editor. Per altre informazioni, vedere Promozione delle Proprietà

• È possibile designare un campo in un tipo .NET come campo distinto decorato con l'attributo DistinguishedField o una proprietà decorata con l'attributo Property.

Utilizzo di campi distinti

I campi distinti vengono indicati dal percorso del campo nel messaggio, utilizzando punti per separare il nome del messaggio, i nomi di tutti i record che racchiudono il campo e il nome del campo stesso:

MyMessage.MyRecord.MySubrecord.MyDistinguishedField  

Utilizzo dei campi delle proprietà

Dopo aver aggiunto un campo a uno schema di proprietà, è possibile accedervi nell'orchestrazione con codice e nelle espressioni di filtro. Per altre informazioni sugli schemi delle proprietà, vedere Schemi delle proprietà.

Annotazioni

Il contenuto del messaggio o le proprietà dei dati sono essenzialmente collegamenti ai dati sottostanti: se si modifica la proprietà, i dati verranno modificati e viceversa.

Le proprietà del messaggio vengono definite dal nome del messaggio seguito dallo spazio dei nomi (lo schema) e dal nome della proprietà tra parentesi:

MyMessage(Invoice.PropertySchema.InvoiceID)  

Annotazioni

Quando si usa una parola chiave riservata come nome di un campo in uno schema e si alza di livello il campo selezionando Promozione rapida, il nome della proprietà del campo viene modificato in __<Reserved Keyword>. Il doppio carattere di sottolineatura viene aggiunto prima del nome della proprietà. Tuttavia, se si usa questo nome di proprietà in un'espressione di orchestrazione, si riceverà un errore del compilatore durante la compilazione dell'orchestrazione. Per risolvere questo errore, è necessario aggiungere manualmente @ prima del doppio carattere di sottolineatura. Ad esempio:

MyMessage(Invoice.PropertySchema.@__Name) = "Product Name";

Set di proprietà

È anche possibile assegnare tutte le proprietà di contesto di un messaggio (un set di proprietà) alle proprietà di contesto di un altro messaggio. Per assegnare un set di proprietà, è sufficiente inserire un asterisco tra parentesi dopo entrambi i nomi dei messaggi, nello stesso modo in cui si inserisce una proprietà tra parentesi:

MyMessage2(*)=MyMessage1(*);  

Dopo che il set di proprietà è stato assegnato a MyMessage2 nell'esempio, tutte le proprietà in MyMessage2 contengono gli stessi valori delle proprietà in MyMessage1.

Vedere anche

Promozione delle proprietà
Utilizzo di filtri con la forma di ricezione di messaggi
Uso dei messaggi nelle orchestrazioni
Informazioni sulle proprietà del contesto del messaggio BizTalk