Cara Menggunakan 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 ini 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. Misalnya,
PortName = MyMessage(BTS.ReceivePortName);
MyFileName = MyMessage(FILE.ReceivedFileName);
MySubject= MyMessage(POP3.Subject);
Tabel terpisah mencantumkan properti tambahan yang mungkin digunakan di beberapa aplikasi BizTalk yang tidak dapat dipromosikan.
| 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 dalam 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 handler. |
| 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. IsDynamicSend | Properti ini dapat diatur pada konteks pesan. Ini tidak akan dipromosikan, dan hanya diterapkan pada operasi Kirim. | xs:boolean | Ini ditulis ke konteks pesan oleh Mesin Olahpesan dengan nilai true ketika operasi pengiriman berada di Port Pengiriman Dinamis. Jika Anda ingin mengatur properti secara dinamis untuk port pengiriman statis dalam alur kirim, Anda harus mengatur nilai ini ke true. |
| BTS. MessageDestination | Properti ini dapat diatur dalam alur terima oleh komponen alur pembakar saat mengembalikan pesan dari GetNext(). | xs:string | Digunakan terutama untuk mendukung Pemrosesan Pertukaran yang Dapat Dipulihkan dalam pemisah, properti ini mengontrol apakah pesan diterbitkan ke kotak pesan atau ditangguhkan ke dalam antrean yang ditangguhkan. Jika alur menemukan 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 pembakaran. 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 kabel). |
| BTS. MessageType | Dipromosikan oleh komponen alur pemisah selama penguraian pesan. | xs:string | Menentukan jenis pesan. Jenis pesan didefinisikan sebagai perangkaian namespace layanan 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 lebih 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 adaptor 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. 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. SPName | Dipromosikan oleh Mesin Olahpesan saat menerbitkan pesan respons dari port pengiriman Solicit-Response. | xs:string | Digunakan untuk berlangganan pesan respons dari port pengiriman Solicit-Response. Nilainya adalah nama port kirim. |
| BTS. SPTransportBackupID | Dipromosikan oleh Mesin Olahpesan saat pesan dikirim ke port pengiriman dari orkestrasi. | xs:string | Menentukan ID adaptor cadangan di port kirim. |
| BTS. SPTransportID | Dipromosikan oleh Mesin Olahpesan saat pesan dikirim ke port pengiriman dari orkestrasi. | xs:string | Menentukan ID adaptor utama dalam port kirim. |
| BTS. SuspendAsNonResumable | 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 urutan 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. |
Untuk informasi tambahan tentang properti dan skema properti yang terkait dengan komponen dan adaptor alur, lihat yang berikut ini:
Lihat juga
Tentang Properti Konteks Pesan BizTalk
Cara Menggunakan Ekspresi untuk Menetapkan Nilai ke Port Dinamis