Properti Konteks EDI
Properti konteks pesan dalam skema properti global EDI diekspos secara publik sehingga Anda dapat menggunakannya dalam operasi seperti perutean pesan. Properti konteks ini didefinisikan dalam PropertySchema.xsd di rakitan Microsoft.BizTalk.Edi.BaseArtifacts. Namespace layanan untuk properti adalah http://schemas.microsoft.com/ Edi/PropertySchema. Jika dipromosikan, properti konteks pesan ini tersedia sebagai Edi.<Nama> Properti di halaman FilterKotak Dialog Kirim Properti Port di panduan UI dan referensi namespace API pengembang.
Daftar properti konteks
Properti konteks EDI juga tersedia dalam orkestrasi, selama referensi ke rakitan Microsoft.BizTalk.Edi.BaseArtifacts telah ditambahkan ke proyek orkestrasi.
| Nama | Jenis | Deskripsi |
|---|---|---|
| AK901 | string | Menunjukkan apakah grup fungsional yang diidentifikasi di segmen AK1 dari pengakuan diterima atau ditolak (hanya X12 997 ACK). |
| AttachmentId | String | ID lampiran pesan. |
| AgreementID | Int | Ditulis oleh EDI menerima alur. Menentukan ID perjanjian tempat pesan masuk diselesaikan. Untuk perjanjian fallback, nilai ini adalah 0. |
| AgreementName | String | Ditulis oleh EDI menerima alur. Menentukan nama perjanjian tempat pesan masuk diselesaikan. Untuk perjanjian fallback, nilai ini adalah BTSGuestParty. |
| AgreementNameForSend | String | Digunakan oleh EDI mengirim alur untuk resolusi perjanjian untuk dokumen keluar. |
| AgreementPartIDForSend | Int | Digunakan oleh EDI mengirim alur untuk resolusi perjanjian untuk dokumen keluar. Nilai ini ditulis oleh Orkestrasi Batching. |
| AgreementPartIDOnReceive | Int | Ditulis oleh EDI menerima alur. Menentukan ID perjanjian satu arah dari perjanjian tempat pesan masuk diselesaikan. Untuk perjanjian fallback, nilai ini adalah 0. |
| BatchElementValidationFailure | boolean | Indikasi bahwa kesalahan dipromosikan oleh sistem batching ketika elemen batch gagal validasi. |
| BatchEncodingType | string | Jenis pengodean yang harus digunakan BizTalk Server untuk mengodekan pertukaran batch keluar. |
| BatchId | Int | ID batch konfigurasi batch yang akan digunakan saat memproses dokumen ini, jika dokumen hanya cocok dengan satu filter batch. |
| BatchIds | String | Daftar ID batch dari kumpulan filter batch yang cocok, jika dokumen cocok dengan lebih dari satu filter batch. |
| BatchingError | string | Deskripsi kesalahan yang dipromosikan oleh sistem batching ketika menangguhkan elemen batch. |
| NamaBatch | String | Nama konfigurasi batch yang akan digunakan saat memproses dokumen ini. |
| CodePage | string | Halaman kode yang akan digunakan untuk memvalidasi pertukaran. |
| CONTRL_UCI4 | string | Bidang Kode Tindakan dari pengakuan CONTRL, menunjukkan apakah pertukaran diterima (nilai "8") atau ditolak karena kesalahan di segmen UNA atau UNB (nilai "4") (hanya EDIFACT CONTRL ACK). |
| DestinationPartyID (tidak digunakan lagi di BizTalk Server) | int | ID pihak tujuan tempat pesan harus dikirim. |
| DestinationPartyName (tidak digunakan lagi di BizTalk Server) | string | Nama pihak tujuan tempat pesan harus dikirim. |
| DestinationPartyReceiver Pengidentifikasi |
string | Pengidentifikasi pihak tujuan tempat pesan harus dikirim. Properti ini dapat dipromosikan dalam komponen kustom untuk mengaktifkan resolusi pihak dalam alur kirim. |
| DestinationPartyReceiver Pengualifikasi |
string | Kualifikasi pihak tujuan tempat pesan harus dikirim. Properti ini dapat dipromosikan dalam komponen kustom untuk mengaktifkan resolusi pihak dalam alur kirim. |
| DestinationPartySender Pengidentifikasi |
string | Pengidentifikasi pihak yang mengirim pesan ke pihak tujuan. Properti ini dapat dipromosikan dalam komponen kustom untuk mengaktifkan resolusi pihak dalam alur kirim. |
| DestinationPartySender Pengualifikasi |
string | Kualifikasi pihak yang mengirim pesan ke pihak tujuan. Properti ini dapat dipromosikan dalam komponen kustom untuk mengaktifkan resolusi pihak dalam alur kirim. |
| EncodingType | short | Jenis pengodean yang harus digunakan BizTalk Server untuk mengodekan pesan keluar. |
| ErrorDescription | string | Untuk pesan yang ditangguhkan, berisi salinan pesan kesalahan (mirip dengan pesan di EventViewer). |
| GS_Segment | string | Segmen GS (grup fungsional) lengkap (X12). Alur penerima EDI menulis properti ini ke konteks ketika pertukaran dibagi sebagai set transaksi, bukan ketika pertukaran dipertahankan. |
| GS01 | string | Kode Pengidentifikasi Fungsi (X12) Alur penerimaan EDI mempromosikan properti ini ke konteks (jika pertukaran bukan pertukaran batch yang dipertahankan). |
| GS02 | string | Kode Pengirim Aplikasi (X12) Alur penerimaan EDI mempromosikan properti ini ke konteks (jika pertukaran bukan pertukaran batch yang dipertahankan). |
| GS03 | string | Kode Penerima Aplikasi (X12) Alur penerimaan EDI mempromosikan properti ini ke konteks (jika pertukaran bukan pertukaran batch yang dipertahankan). |
| GS07 | string | Agensi yang Bertanggung Jawab (X12) Alur penerimaan EDI mempromosikan properti ini ke konteks (jika pertukaran bukan pertukaran batch yang dipertahankan). |
| GS08 | string | Kode Pengidentifikasi Versi/Rilis/Industri (X12) Alur penerimaan EDI mempromosikan properti ini ke konteks (jika pertukaran bukan pertukaran batch yang dipertahankan). |
| ISA_Segment | string | Segmen ISA (header kontrol pertukaran) lengkap (X12). BizTalk Server menulis properti ini ke konteks ketika pertukaran dipisahkan sebagai set transaksi, bukan ketika pertukaran dipertahankan. Properti ini berisi informasi keamanan/otorisasi (ISA2, Informasi Otorisasi, dan ISA4, Informasi Keamanan) yang dapat menyebabkan pengungkapan informasi. Anda dapat menggunakan properti informasi keamanan/otorisasi/kata sandi masker (di halaman Validasi dan Pembuatan ACK ) untuk mengganti setiap karakter di bidang ISA2 dan ISA4 dengan karakter "#". Ini adalah proses satu arah: karakter "#" tidak dapat dikonversi ke karakter aktual. Alur penerima EDI menulis properti ini ke konteks ketika pertukaran dipisahkan sebagai set transaksi, bukan ketika pertukaran dipertahankan. |
| ISA05 | string | Kualifikasi Pengirim Pertukaran (X12) Alur penerimaan EDI mempromosikan properti ini ke konteks (jika pertukaran bukan pertukaran batch yang dipertahankan). |
| ISA06 | string | ID Pengirim Pertukaran (X12) Alur penerimaan EDI mempromosikan properti ini ke konteks (jika pertukaran bukan pertukaran batch yang dipertahankan). |
| ISA07 | string | Kualifikasi Penerima Pertukaran (X12) Alur penerimaan EDI mempromosikan properti ini ke konteks (jika pertukaran bukan pertukaran batch yang dipertahankan). |
| ISA08 | string | ID Penerima Pertukaran (X12) Alur penerimaan EDI mempromosikan properti ini ke konteks (jika pertukaran bukan pertukaran batch yang dipertahankan). |
| ISA15 | string | Indikator Penggunaan (X12) Alur penerimaan EDI mempromosikan properti ini ke konteks (jika pertukaran bukan batch yang dipertahankan). |
| IsResendControlMessage | int | Digunakan oleh mesin AS2 untuk menunjukkan bahwa pengiriman pesan APPLICAB2 harus dikirim ulang, karena respons MDN belum diterima dalam waktu yang dikonfigurasi. |
| IsSystemGeneratedACK | boolean | Menunjukkan bahwa pesan adalah pengakuan (X12 TA1 atau 997, atau EDIFACT CONTRL) yang dihasilkan oleh sistem. Bisa disetel ke Benar atau Salah. Ini adalah properti konteks pesan yang tersedia sebagai EDI. IsSystemGeneratedACK di halaman Filter kotak dialog Kirim Properti Port . |
| ReceiverPartyName | String | Ditulis oleh EDI menerima alur. Menentukan nama mitra tujuan yang disediakan dalam perjanjian tempat pesan diselesaikan. Untuk perjanjian fallback, nilai ini adalah RECEIVE-PARTNER. |
| ReceiverPartyNameForSend | String | Digunakan oleh EDI mengirim alur untuk resolusi perjanjian untuk dokumen keluar. |
| ReuseEnvelope | boolean | Menunjukkan apakah pertukaran dipertahankan atau dipisahkan. Jika pertukaran dipertahankan, BizTalk Server akan menggunakan kembali amplop saat memproses pertukaran untuk pengiriman. |
| SenderPartyName | String | Ditulis oleh EDI menerima alur. Menentukan nama mitra sumber yang disediakan dalam perjanjian tempat pesan masuk diselesaikan. Untuk perjanjian fallback, nilai ini adalah BTS-SENDER. |
| SenderPartyNameForSend | String | Digunakan oleh EDI mengirim alur untuk resolusi perjanjian untuk dokumen keluar. |
| ST01 | string | Kode Pengidentifikasi Set Transaksi (X12) Alur penerimaan EDI mempromosikan properti ini ke konteks (jika pertukaran bukan pertukaran batch yang dipertahankan). |
| ST03 | string | Kode Pengidentifikasi Versi/Rilis/Industri (X12) Anda dapat menulis dan mempromosikan properti ini ke konteks dan menggunakannya untuk perutean pesan. |
| TA1_TA104 | string | Bidang Perilaku Mesin dari pengakuan TA104, yang menunjukkan apakah pertukaran diterima (nilai "A"), diterima dengan kesalahan (nilai "E"), atau ditolak/ditangguhkan (nilai "R") (hanya X12 TA1 ACK). |
| ToBeBatched | boolean | Menunjukkan apakah pesan harus di-batch dengan pesan lain oleh orkestrasi batching. Setelah membuat batch pertukaran, orkestrasi batching mengatur properti ini ke "False". |
| ToBeRouted | boolean | Menunjukkan bahwa pesan harus diambil oleh orkestrasi perutean, yang membuat salinan elemen batch sebanyak yang ada langganan ke elemen tersebut, lalu merutekan salinan ke MessageBox. |
| UNA_Segment | string | Segmen UNA (Saran String Layanan) lengkap (EDIFACT) Alur penerima EDI menulis properti ini ke konteks ketika pertukaran dipisahkan sebagai set transaksi, bukan ketika pertukaran dipertahankan. |
| UNB_Segment | string | Segmen UNB (header kontrol pertukaran) lengkap (EDIFACT) Alur penerima EDI menulis properti ini ke konteks ketika pertukaran dipisahkan sebagai set transaksi, bukan ketika pertukaran dipertahankan. Properti ini berisi informasi keamanan/otorisasi (UNB6.1 dan UNB6.2) yang dapat menyebabkan pengungkapan informasi. Anda dapat menggunakan properti Informasi keamanan/otorisasi/kata sandi masker untuk mengganti nilai di bidang UNB6.1 dan UNB6.2 dengan karakter "#". Perhatikan bahwa karakter "#" tidak dapat dikonversi ke karakter aktual. |
| UNB11 | string | Indikator Penggunaan (EDIFACT) Alur penerimaan EDI mempromosikan properti ini ke konteks (jika pertukaran bukan pertukaran batch yang dipertahankan). |
| UNB2_1 | string | ID Pengirim Pertukaran (EDIFACT) Alur penerimaan EDI mempromosikan properti ini ke konteks (jika pertukaran bukan pertukaran batch yang dipertahankan). |
| UNB2_2 | string | Penentu Kode Pengirim Pertukaran (EDIFACT) Alur penerimaan EDI mempromosikan properti ini ke konteks (jika pertukaran bukan pertukaran batch yang dipertahankan). |
| UNB2_3 | string | Alamat untuk Perutean Terbalik (EDIFACT) Alur penerimaan EDI mempromosikan properti ini ke konteks (jika pertukaran bukan pertukaran batch yang dipertahankan). |
| UNB3_1 | string | ID Penerima Pertukaran (EDIFACT) Alur penerimaan EDI mempromosikan properti ini ke konteks (jika pertukaran bukan pertukaran batch yang dipertahankan). |
| UNB3_2 | string | Kualifikasi Kode Penerima Pertukaran (EDIFACT) Alur penerimaan EDI mempromosikan properti ini ke konteks (jika pertukaran bukan pertukaran batch yang dipertahankan). |
| UNG_Segment | string | Segmen UNG (grup fungsional) lengkap (X12) Alur penerima EDI menulis properti ini ke konteks ketika pertukaran dipisahkan sebagai set transaksi, bukan ketika pertukaran dipertahankan. |
| UNG1 | string | Identifikasi Grup Fungsional (EDIFACT) Alur penerimaan EDI mempromosikan properti ini ke konteks (jika pertukaran bukan pertukaran batch yang dipertahankan). |
| UNG2_1 | string | Identifikasi Pengirim Aplikasi (EDIFACT) Alur penerimaan EDI mempromosikan properti ini ke konteks (jika pertukaran bukan pertukaran batch yang dipertahankan). |
| UNG3_1 | string | Identifikasi Penerima Aplikasi (EDIFACT) Alur penerimaan EDI mempromosikan properti ini ke konteks (jika pertukaran bukan pertukaran batch yang dipertahankan). |
| UNH2_1 | string | Jenis Pesan (EDIFACT) Alur penerimaan EDI mempromosikan properti ini ke konteks (jika pertukaran bukan pertukaran batch yang dipertahankan). |
| UNH2_2 | string | Nomor Versi Pesan (EDIFACT) Alur penerimaan EDI mempromosikan properti ini ke konteks (jika pertukaran bukan pertukaran batch yang dipertahankan). |
| UNH2_3 | string | Nomor Rilis Pesan (EDIFACT) Alur penerimaan EDI mempromosikan properti ini ke konteks (jika pertukaran bukan pertukaran batch yang dipertahankan). |
Mengekstrak Bidang Individual dari Properti Konteks Segmen
Beberapa properti tidak ditulis atau dipromosikan ke konteks pesan oleh EDI menerima alur sebagai properti individual, tetapi hanya sebagai bagian dari string segmen. Hal ini dilakukan karena alasan performa, karena promosi properti berdampak pada performa. Misalnya, bidang ISA5, ISA6, ISA7, ISA8, dan ISA15 dari segmen ISA dipromosikan oleh alur penerima sebagai properti individual, tetapi bidang ISA lainnya hanya ditulis ke konteks pesan sebagai bagian dari properti ISA_Segment. Properti ini ditulis atau dipromosikan hanya ketika ReuseEnvelope tidak diatur ke True, menunjukkan bahwa pertukaran batch yang diterima tidak dipertahankan.
Jika Anda memerlukan bidang individual dari salah satu segmen (ISA, GS, UNB, UNG, atau UNA) untuk ditulis ke konteks pesan, tetapi bidang individual ini tidak ditulis ke konteks pesan secara default, Anda harus menulis komponen kustom untuk menulisnya ke konteks pesan. Komponen kustom ini perlu mengurai bidang segmen dan menulis bidang individual ke konteks pesan.
Sampel Pengayaan Pesan menunjukkan cara menggunakan pengurai untuk mengekstrak bidang individual dari segmen dan menulisnya ke konteks. Sampel ini disertakan dalam <drive>:\Program Files\Microsoft BizTalk Server\SDK\Samples\EDI\MessageEnrichment. Untuk informasi selengkapnya, lihat Sampel Pengayaan Pesan (Sampel Server BizTalk).