Menggunakan Bidang Khusus dan Bidang Properti

Bidang yang dibedakan adalah data pesan dengan kepentingan khusus yang Anda gunakan terutama untuk membuat keputusan atau memanipulasi data dalam orkestrasi Anda.

Properti pesan adalah data—konten pesan itu sendiri—atau "metadata"—informasi konteks tentang pesan seperti stempel waktu atau informasi perutean. Anda dapat menggunakan properti konteks pesan yang ditentukan sistem atau properti konteks transportasi, atau Anda dapat menentukan properti Anda sendiri dengan membuat referensi ke bidang skema dari dalam skema properti. Properti digunakan dalam langganan dan korelasi.

• Anda bisa menunjuk bidang dalam skema sebagai bidang atau bidang properti khusus dengan menggunakan kotak dialog Promosikan Properti dari dalam Editor. Untuk informasi selengkapnya, lihat Mempromosikan Properti

• Anda dapat menunjuk bidang dalam jenis .NET sebagai bidang khusus dengan mendekorasinya dengan atribut DistinguishedField, atau sebagai properti oleh atribut Properti.

Menggunakan Bidang Khusus

Bidang yang dibedakan dirujuk oleh jalur ke bidang dalam pesan, menggunakan titik untuk memisahkan nama pesan, nama rekaman yang mengelilingi bidang, dan nama bidang itu sendiri.

MyMessage.MyRecord.MySubrecord.MyDistinguishedField  

Menggunakan Kolom Properti

Setelah Anda menambahkan bidang ke skema properti, nilainya dapat diakses dalam orkestrasi dengan kode dan dalam ekspresi filter. Untuk informasi selengkapnya tentang skema properti, lihat Skema Properti.

Nota

Konten pesan atau properti data pada dasarnya adalah pintasan ke data yang mendasar: jika Anda memodifikasi properti, data akan dimodifikasi, dan sebaliknya.

Properti pesan disebut dengan nama pesan diikuti dengan namespace (skema) dan nama properti dalam tanda kurung:

MyMessage(Invoice.PropertySchema.InvoiceID)  

Nota

Saat Anda menggunakan kata kunci yang dipesan sebagai nama bidang dalam skema, dan Anda mempromosikan bidang dengan memilih Promosi Cepat, nama properti bidang diubah menjadi __<Kata Kunci Dicadangkan>. (Garis bawah ganda ditambahkan sebelum nama properti.) Namun, jika Anda menggunakan nama properti ini dalam ekspresi orkestrasi, Anda akan menerima kesalahan kompilator saat membangun orkestrasi. Untuk mengatasi kesalahan ini, Anda perlu menambahkan @ secara manual sebelum garis bawah ganda. Contohnya,

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

Kumpulan Properti

Anda juga dapat menetapkan semua properti konteks dari satu pesan (kumpulan properti) ke properti konteks pesan lain. Untuk menetapkan kumpulan properti, Anda cukup menempatkan tanda bintang dalam tanda kurung setelah kedua nama pesan, dengan cara yang sama Anda akan menempatkan properti dalam tanda kurung:

MyMessage2(*)=MyMessage1(*);  

Setelah kumpulan properti ditetapkan ke MyMessage2 dalam contoh, semua properti di MyMessage2 berisi nilai yang sama dengan properti di MyMessage1.

Lihat Juga

Mempromosikan Properti
Menggunakan Filter Dengan Bentuk Terima Pesan
Menggunakan Pesan dalam Orkestrasi
Tentang Properti Konteks Pesan BizTalk