Uso di campi differenzianti e di campi di proprietà

i campi distinti sono dati di messaggi di particolare interesse utilizzati principalmente per assumere decisioni o modificare dati nell'orchestrazione.

Le proprietà dei messaggi sono dati, contenuto del messaggio stesso, o "metadati", informazioni di contenuto relative al messaggio quali timbri ora o informazioni di routing. È possibile utilizzare proprietà di contesto dei messaggi definite dal sistema o proprietà di contesto del trasporto oppure è possibile definire proprietà personalizzate facendo riferimento ai campi dello schema dall'interno della schema proprietà. Le proprietà vengono utilizzate in sottoscrizioni e correlazioni.

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

• È possibile designare un campo in un tipo .NET come campo differenziante decorandolo con l'attributo DistinguishedField o come una proprietà mediante l'attribuito Proprietà.

Utilizzo di campi differenzianti

Si fa riferimento ai campi differenzianti in base al percorso del campo del messaggio, utilizzando punti per separare il nome del messaggio, i nomi di eventuali record che racchiudono il campo e il nome del campo stesso:

MyMessage.MyRecord.MySubrecord.MyDistinguishedField  

Utilizzo dei campi Proprietà

Dopo aver aggiunto un campo alla schema proprietà è possibile accedere al relativo valore nell'orchestrazione con codice e in espressioni di filtro. Per altre informazioni sugli schemi delle proprietà, vedere Schemi delle proprietà.

Nota

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.

È possibile fare riferimento alle proprietà dei messaggi in base al nome del messaggio seguito dallo spazio dei nomi (schema) e dal nome della proprietà tra parentesi:

MyMessage(Invoice.PropertySchema.InvoiceID)  

Nota

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

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

Set di proprietà

È inoltre possibile assegnare tutte le proprietà di contenuto di un messaggio (insieme di proprietà) alle proprietà di contenuto di un altro messaggio. Per assegnare un insieme di proprietà basta posizionare un asterisco tra parentesi dopo i nomi dei messaggi, analogamente a come si procede per inserire una proprietà tra parentesi:

MyMessage2(*)=MyMessage1(*);  

Dopo che la proprietà impostata è stata assegnata a MyMessage2 nell'esempio, tutte le proprietà di MyMessage2 contengono gli stessi valori delle proprietà di MyMessage1.

Vedere anche

Promozione di proprietà
Uso di filtri con la forma del messaggio Ricezione
Uso di messaggi nelle orchestrazioni
Informazioni sulle proprietà di contesto di messaggi BizTalk