Bagikan melalui


Mempromosikan Properti

Promosi properti melibatkan mempromosikan simpul Elemen Bidang atau Atribut Bidang dalam skema menjadi Bidang Dibedakan atau Bidang Properti. Anda juga dapat mempromosikan simpul Rekaman sebagai Bidang Properti jika memiliki konten sederhana (properti Tipe Konten dari simpul Rekaman diatur ke SimpleContent). Bagian ini menyediakan instruksi langkah demi langkah untuk mempromosikan simpul sebagai Bidang Khusus atau sebagai Bidang Properti.

Untuk mempromosikan node Rekaman (dengan konten sederhana), Elemen Bidang, atau Atribut Bidang sebagai Bidang Properti, Anda dapat terlebih dahulu menentukan jenis skema khusus yang disebut skema properti. Skema properti menentukan sekumpulan simpul Elemen Bidang yang tidak terstruktur di mana Anda mempromosikan Simpul Rekaman (dengan konten sederhana), Elemen Bidang, atau Atribut Bidang . Untuk instruksi langkah demi langkah untuk membuat skema properti, lihat Cara Membuat Skema Properti.

Atau, Anda dapat menggunakan fitur Promosi Cepat , yang akan secara otomatis membuat dan memperbarui skema properti tunggal setiap kali Anda mempromosikan simpul Elemen Bidang, Atribut Bidang, atau Rekaman baru (dengan konten sederhana).

Catatan

Anda dapat mempromosikan bidang sebagai Bidang Khusus dan Bidang Properti.

Catatan

Fitur Promosi Cepat memodifikasi skema properti dengan menyisipkan properti baru dengan nama simpul yang dipromosikan.

Penting

Jangan memindahkan atau mengganti nama bidang dalam skema setelah Anda mempromosikannya. Saat Anda memindahkan atau mengganti nama bidang skema, BizTalk Editor tidak memperbarui JalurX yang menentukan lokasi bidang yang dipromosikan.

Jenis Data XSD dan CLR

Di beberapa tempat, seperti dalam promosi properti, jenis data XSD dipromosikan ke jenis data Common Language Runtime (CLR). Tabel berikut ini memperlihatkan jenis data XSD yang bisa dipromosikan dan jenis data CLR terkait.

Tipe Data XSD Tipe Data CLR
anyURI String
Boolean Boolean
Byte sbyte
Tanggal DateTime
dateTime DateTime
Decimal Desimal
Ganda Ganda
ENTITAS String
Mengambang Tunggal
gDay DateTime
gMonth DateTime
gMonthDay DateTime
gYear DateTime
gYearMonth DateTime
ID String
IDREF String
Int Int32
Bilangan bulat Desimal
Bahasa String
Nama String
NCName String
bilangan bulat negatif Desimal
NMTOKEN String
nonNegativeInteger Desimal
nonPositiveInteger Desimal
normalizedString String
NOTASI String
positiveInteger Desimal
QName String
Short Int16
String String
Waktu DateTime
Token String
unsignedByte Byte
unsignedInt UInt32
unsignedShort UInt16

Catatan

Tipe Data XSD base64Binary, durasi, ENTITES, hexBinary, IDREFS, long, NMTOKENS, dan unsignedLong tidak didukung untuk promosi.

Batasan untuk Mempromosikan Properti

Saat mempromosikan properti, pertimbangkan hal berikut:

  • Properti yang dipromosikan dibatasi hingga 256 karakter sementara properti tertulis tidak memiliki batasan panjang.

  • Properti yang dipromosikan digunakan dalam perutean pesan dan berukuran terbatas karena alasan efisiensi dalam perbandingan dan penyimpanan. Meskipun properti tertulis tidak memiliki batasan ukuran yang keras, menggunakan nilai yang terlalu besar dalam konteks akan berdampak pada performa, karena nilai-nilai tersebut masih harus diproses dan diteruskan dengan pesan. Bidang Yang Dibedakan adalah contoh properti tertulis.

  • Node rekaman tidak pernah dapat dipromosikan sebagai Bidang Khusus.

  • Properti yang dipromosikan dibatasi untuk elemen/atribut yang tidak berulang.

  • Jangan promosikan bidang milik simpul akar yang sama ke properti yang sama. Promosi tersebut menghasilkan kesalahan kompilasi atau penyebaran.

  • Dalam konteks pesan, ada beberapa properti yang tidak tersedia karena tidak dipromosikan. The BTS. Properti ReceiveLocationName adalah salah satu properti tersebut. Jika Anda dapat menambahkan skema properti baru atau proyek BizTalk Server baru ke pengembangan Anda, dimungkinkan untuk mengakses properti ini dari dalam orkestrasi.

    Nilai properti diidentifikasi oleh namespace target properti dan nama properti. Contoh berikut menunjukkan cara mengakses lokasi penerimaan dalam kode.

    string receiveLocationName = pInMsg.Context.Read("ReceiveLocationName", sysNamespace);

Di Bagian Ini