Properti Konteks Pesan

 

Properti sistem sebagian besar digunakan secara internal oleh BizTalk Messaging Engine dan komponennya. Secara umum, mengubah nilai yang ditetapkan oleh mesin untuk properti tersebut tidak disarankan, karena dapat memengaruhi logika eksekusi mesin. Namun, ada sejumlah besar properti yang dapat Anda ubah.

Tabel berikut berisi daftar properti konteks pesan yang dapat dipromosikan oleh Mesin Olahpesan. Anda dapat menggunakan properti ini untuk membuat ekspresi filter pada port pengiriman dan orkestrasi di Microsoft BizTalk Server. Tabel terpisah mencantumkan properti tambahan yang mungkin digunakan di beberapa aplikasi BizTalk yang tidak dapat dipromosikan.

Untuk informasi tambahan tentang properti dan skema properti yang terkait dengan komponen dan adaptor alur, lihat yang berikut ini:

Properti Kapan dan di mana ia dipromosikan Jenis Deskripsi
BTS. AckFailureCategory Dipromosikan oleh Mesin Olahpesan sebelum menerbitkan pesan pengakuan ke dalam database MessageBox. xs:int Mengidentifikasi ErrorCategory, yang memberikan tempat dan alasan penangguhan.
BTS. AckFailureCode Dipromosikan oleh Mesin Olahpesan sebelum menerbitkan pesan pengakuan ke dalam database MessageBox. xs:string Mengidentifikasi ErrorCode, yang memberikan tempat dan alasan penangguhan.
BTS. AckID Dipromosikan oleh Mesin Olahpesan sebelum menerbitkan pesan pengakuan ke dalam database MessageBox. xs:string Mengidentifikasi MessageID dari pesan asli.
BTS. AckInboundTransportLocation Dipromosikan oleh Mesin Olahpesan sebelum menerbitkan pesan pengakuan ke dalam database MessageBox. xs:string Mengidentifikasi InboundTransportLocation dari pesan asli.
BTS. AckOutboundTransportLocation Dipromosikan oleh Mesin Olahpesan sebelum menerbitkan pesan pengakuan ke dalam database MessageBox. xs:string Mengidentifikasi OutboundTransportLocation dari pesan asli.
BTS. AckOwnerID Dipromosikan oleh Mesin Olahpesan sebelum menerbitkan pesan pengakuan ke dalam database MessageBox. xs:string Mengidentifikasi ID instans dari pesan asli.
BTS. AckReceivePortID Dipromosikan oleh Mesin Olahpesan sebelum menerbitkan pesan pengakuan ke dalam database MessageBox. xs:string Mengidentifikasi ReceivePortID dari pesan asli.
BTS. AckReceivePortName Dipromosikan oleh Mesin Olahpesan untuk pesan pengakuan. xs:string Mengidentifikasi ReceivePortName dari pesan asli.
BTS. AckSendPortID Dipromosikan oleh Mesin Olahpesan sebelum menerbitkan pesan pengakuan ke dalam database MessageBox. xs:string Mengidentifikasi SendPortID dari pesan asli.
BTS. AckSendPortName Dipromosikan oleh Mesin Olahpesan sebelum menerbitkan pesan pengakuan ke dalam database MessageBox. xs:string Mengidentifikasi SendPortName dari pesan asli.
BTS. AckType Dipromosikan oleh Mesin Olahpesan sebelum menerbitkan pesan pengakuan ke dalam database MessageBox. xs:string Memungkinkan pemantauan pengakuan dan non-pengakuan oleh orkestrasi. Nilainya adalah ACK untuk pengakuan dan NACK untuk pengakuan negatif.
BTS. ActionOnFailure Properti ini dapat diatur oleh adaptor sebelum memanggil API IBTTTransportBatch::SubmitMessage() untuk mengirimkan pesan ke BizTalk. xs:int Mengontrol perilaku mesin olahpesan ketika ada kegagalan dalam alur penerima. Biasanya mesin olahpesan menangguhkan pesan yang gagal; namun, adaptor tertentu (seperti HTTP) akan melaporkan kegagalan kembali ke klien alih-alih menangguhkan pesan pada kegagalan alur penerima.

Nilai yang valid:

-Default. Jika properti tidak ada, mesin olahpesan akan secara otomatis mencoba menangguhkan pesan.

- 0. Menunjukkan bahwa mesin olahpesan tidak boleh secara otomatis menangguhkan mesin.

Nilai lain dicadangkan untuk digunakan di masa mendatang.
BTS. CorrelationToken Jika properti ini diatur pada konteks pesan, properti ini dipromosikan oleh Mesin Olahpesan. Properti ini diatur pada konteks secara implisit saat adaptor respons permintaan atau orkestrasi mengirimkan pesan permintaan ke database MessageBox. xs:string Memungkinkan perutean respons ke port respons permintaan.
BTS. EpmRRCorrelationToken Dipromosikan oleh Mesin Olahpesan pada eksekusi pesan respons permintaan. Properti dipromosikan sebelum pesan dikirimkan ke database MessageBox. xs:int Digunakan secara internal oleh Mesin Olahpesan. Menentukan Nama Server, ID Proses, dan GUID unik untuk aliran respons permintaan pesan.
BTS. InboundTransportLocation Dipromosikan oleh Mesin Olahpesan setelah menerima pesan dari adaptor penerima dan sebelum menerbitkannya ke database MessageBox. xs:string Menentukan lokasi (URI) tempat pesan diterima oleh penangan.
BTS. InboundTransportType Dipromosikan oleh Mesin Olahpesan setelah menerima pesan dari adaptor penerima dan sebelum menerbitkannya ke database MessageBox. xs:string Menentukan jenis adaptor yang menerima pesan ini dan mengirimkannya ke server: FILE, HTTP, dll.
BTS. InterchangeSequenceNumber Dipindah oleh Mesin Olahpesan setelah menerima pesan dari adaptor penerima dan sebelum menerbitkannya ke database MessageBox. xs:int Menunjukkan nomor urut dokumen dalam pertukaran. Jika dokumen bukan bagian dari pertukaran yang dibongkar ke dalam dokumen individual, maka nilai ini akan menjadi 1. Properti dapat dibaca dalam orkestrasi, alur kirim, dan adaptor kirim.
BTS. MessageDestination Properti ini dapat diatur dalam alur penerima oleh komponen alur pembongkar saat mengembalikan pesan dari GetNext(). xs:string Digunakan terutama untuk mendukung Pemrosesan Pertukaran yang Dapat Dipulihkan dalam pembingkaran, properti ini mengontrol apakah pesan diterbitkan ke kotak pesan atau ditangguhkan ke dalam antrean tangguhan. Jika alur mengalami pesan buruk dalam pertukaran dan ingin menangguhkan pesan dan melanjutkan pemrosesan, alur dapat melakukannya dengan mengatur MessageDestination = SuspendQueue dan mengembalikan pesan saat mesin memanggil GetNext() pada pembongkar.

Nilai yang valid:

-Default. Jika properti tidak ada, pesan diasumsikan baik dan diterbitkan ke kotak pesan.

- SuspendQueue. Mengarahkan mesin olahpesan untuk menangguhkan pesan.

 Catatan Pesan yang ditangguhkan akan menjadi pesan pasca-alur/pemetaan dan bukan pesan yang dikirimkan oleh adaptor (yaitu pesan kawat).
BTS. MessageType Dipromosikan oleh komponen alur pemisah selama penguraian pesan. xs:string Menentukan jenis pesan. Jenis pesan didefinisikan sebagai perangkaian namespace skema dokumen dan simpul akar dokumen: http://<MyNamespace>#<MyRoot>.
BTS. OutboundTransportLocation Jika properti ini diatur pada konteks pesan, properti ini dipromosikan oleh Mesin Olahpesan. Properti ini diatur pada konteks pesan secara implisit ketika orkestrasi mengirim pesan ke port kirim. Properti ini juga dapat diatur secara eksplisit dalam orkestrasi atau dalam alur. xs:string Menentukan URI lokasi tujuan tempat pesan dikirim. URI mungkin berisi awalan adaptor, seperti http://. Awalan adaptor digunakan oleh Mesin Olahpesan untuk menentukan jenis adaptor yang akan digunakan saat mengirim pesan. Jika awalan adaptor dan BTS. Properti OutboundTransportType diatur, jenis adaptor dari BTS. OutboundTransportType selalu diutamakan daripada jenis adaptor yang ditentukan dari awalan.

Nilai yang valid:

Antrean Pesan BizTalk: DIRECT=, PRIVATE=, dan PUBLIC=

FILE: file://

FTP: FTP://

HTTP: http:// dan https://

SMTP: mailto:

SOAP: SOAP://

SQL: SQL://
BTS. OutboundTransportType Jika properti ini diatur pada konteks pesan, properti ini dipromosikan oleh Mesin Olahpesan. Properti ini diatur pada konteks secara implisit ketika orkestrasi mengirim pesan ke port kirim. Properti ini juga dapat diatur secara eksplisit dalam orkestrasi atau dalam alur. xs:string Menentukan tipe adapter yang digunakan untuk mengirim pesan. Jenis adaptor yang tersedia adalah FILE, FTP, HTTP, SMTP, SOAP, dan SQL.

Nilai yang ditetapkan pada properti ini serta awalan adaptor yang ditentukan dalam alamat tidak peka huruf besar/kecil.
BTS. PropertiesToUpdate Adaptor mengatur properti ini ketika perlu mempertahankan beberapa nilai properti pada pesan gagal yang sedang dikirim ulang atau ditangguhkan.

Ini berarti bahwa ketika pesan dikirim ulang atau dilanjutkan, pesan akan memiliki properti yang ditentukan yang diatur pada konteks.
xs:string Berisi string XML dengan elemen yang mewakili nama properti, namespace, dan nilai.
BTS. ReceiveLocationName Ditulis ke konteks pesan oleh Mesin Olahpesan setelah menerima pesan dari adaptor penerima dan sebelum menerbitkannya ke dalam database MessageBox. xs:string Nama lokasi terima yang mudah digunakan di mana pesan diterima.
BTS. ReceivePortID Dipromosikan oleh Mesin Olahpesan setelah menerima pesan dari adaptor penerima dan sebelum menerbitkannya ke database MessageBox. xs:int Mengidentifikasi port penerima tempat pesan diterima.
BTS. ReceivePortName Dipromosikan oleh Mesin Olahpesan setelah menerima pesan dari adaptor penerima dan sebelum menerbitkannya ke database MessageBox. xs:string Nama yang mudah digunakan dari port penerima tempat pesan diterima.
BTS. RouteDirectToTP Dipromosikan oleh Mesin Olahpesan pada pesan untuk eksekusi loop back atau request-response. Properti dipromosikan sebelum pesan dikirimkan ke database MessageBox. xs:boolean Digunakan secara internal oleh Mesin Olahpesan untuk mengaktifkan skenario loop back dan request-response.
BTS. SPGroupID Dipromosikan oleh Mesin Olahpesan saat pesan dikirim ke port kirim dari orkestrasi. xs:string Menentukan ID grup port kirim.
BTS. SPID Dipromosikan oleh Mesin Olahpesan saat pesan dikirim ke port kirim dari orkestrasi. xs:string Menentukan ID port pengiriman.
BTS. SPTransportBackupID Dipromosikan oleh Mesin Olahpesan saat pesan dikirim ke port kirim dari orkestrasi. xs:string Menentukan ID adaptor cadangan di port kirim.
BTS. SPTransportID Dipromosikan oleh Mesin Olahpesan saat pesan dikirim ke port kirim dari orkestrasi. xs:string Menentukan ID adaptor utama dalam port kirim.
BTS. TangguhkanAsNonResumable Properti ini dapat diatur oleh adaptor sebelum memanggil SubmitMessage() atau dalam orkestrasi sebelum mengirim pesan ke port kirim.

 Catatan SubmitRequestMessage() akan mengabaikan properti ini; pesan dua arah selalu ditangguhkan sebagai tidak dapat dilanjutkan.
xs:boolean Mengontrol apakah Mesin Pesan harus menangguhkan pesan sebagai tidak dapat dilanjutkan pada kegagalan pesan. Biasanya pesan ditangguhkan sebagai dapat dilanjutkan tetapi ada kasus ketika ini tidak pantas -- misalnya, melanjutkan pesan untuk port kirim atau terima yang diurutkan akan melanggar pesan.

Nilai yang valid:

-Palsu. Pesan ditangguhkan sebagai dapat dilanjutkan (ini adalah default).

-Benar. Pesan ditangguhkan sebagai tidak dapat dilanjutkan.
BTS. SuspendMessageOnRoutingFailure Dipromosikan oleh Mesin Olahpesan setelah menerima pesan dari adaptor penerima dan sebelum menerbitkannya ke database MessageBox. xs:boolean Menentukan perilaku ketika kegagalan perutean terjadi dengan pesan masuk.

Nilai yang valid:

- Default / False. Jika properti tidak ada atau diatur ke False, mesin akan memberi tahu adaptor kesalahan saat kegagalan perutean terjadi.

-Benar. Mesin perutean akan menangguhkan pesan secara otomatis ketika kegagalan perutean terjadi.

 Catatan Pesan yang ditangguhkan akan menjadi pesan pasca-alur/pemetaan dan bukan pesan yang dikirimkan oleh adaptor (yaitu pesan kabel).

Ada sejumlah properti lain di namespace layanan ini yang membawa informasi yang mungkin berguna untuk beberapa aplikasi BizTalk.

Properti Kapan dan di mana ia dipromosikan Jenis Deskripsi
BTS. AckDescription Atur oleh Mesin Olahpesan sebelum menerbitkan pesan pengakuan ke dalam database MessageBox. xs:string Mengidentifikasi ErrorDescription, yang memberikan tempat dan alasan penangguhan.
BTS. EncryptionCert Tidak dapat diproyeksikan. xs:int Mengidentifikasi thumbprint yang sesuai dengan sertifikat enkripsi. Atur properti ini dalam komponen orkestrasi atau alur kustom yang ditempatkan sebelum komponen alur Mime/SMIME Encoder dalam alur untuk melakukan enkripsi respons pada port respons permintaan yang menerima pesan yang ditandatangani dan dienkripsi.
BTS. ID Pertukaran Diatur oleh Mesin Olahpesan untuk setiap pesan yang tiba di server. xs:string Menentukan ID unik yang digunakan untuk mengelompokkan dokumen yang dihasilkan dari pesan pertukaran yang sama.
BTS. Loopback Diatur oleh adaptor saat mengirimkan pesan permintaan untuk eksekusi loop back. xs:boolean Menentukan apakah pesan harus dikirimkan ke server untuk eksekusi loop back. Dalam eksekusi loop back, pesan permintaan diterbitkan ke dalam database MessageBox tempat pesan dirutekan langsung ke adaptor penerima sebagai respons.
BTS. SignatureCertificate Diatur oleh beberapa adaptor saat mengirimkan pesan ke server. Properti ini digunakan oleh komponen alur Resolusi Pihak. xs:string Mengidentifikasi thumbprint sertifikat penandatanganan yang digunakan untuk menandatangani pesan yang diterima oleh BizTalk Server.
BTS. SourcePartyID Diatur oleh komponen alur Resolusi Pihak setelah pihak diidentifikasi untuk pesan masuk. xs:string ID pesta BizTalk.
BTS. SSOTicket Jika adaptor penerima mendukung properti ini, adaptor akan diatur saat menerbitkan pesan ke server. xs:string Tiket berisi domain terenkripsi dan nama pengguna pengguna saat ini, serta waktu kedaluwarsa tiket. Tiket digunakan oleh adaptor yang diaktifkan SSO untuk mendapatkan kredensial bagi pengguna saat mengautentikasi dengan titik akhir tujuan.
BTS. WindowsUser Diatur oleh beberapa adaptor saat mengirimkan pesan ke server. Properti ini digunakan oleh komponen alur Resolusi Pihak. xs:string Menentukan akun pengguna atas nama yang pesannya dikirimkan ke server.

Lihat juga

Tentang Properti Konteks Pesan BizTalk
Properti Konteks Pesan