Metode CreateEx
Membuat rekaman baru menggunakan sekumpulan kunci unik dan properti tertentu.
CreateEx
(key1, key2, ..., keyn, interactiveMode, properties)
Parameter | Deskripsi |
---|---|
Key in/out parameter |
Parameter kunci individual (key1, key2, ... keyn), yang harus disediakan. Kumpulan kunci ini tidak boleh ada di database server, yaitu, kunci tersebut harus unik. Kunci ini sesuai dengan set Kunci CreateEx seperti yang didefinisikan untuk antarmuka komponen tertentu. |
interactiveMode |
Penanganan kesalahan. Saat mengakses properti di antarmuka komponen, Microsoft BizTalk Adapter for PeopleSoft Enterprise menggunakan API yang disediakan PeopleSoft, yang membaca dan menulis bidang individual di antarmuka komponen; namun, perubahan ini tidak disebarluaskan ke server PeopleSoft satu per satu. Sebagai gantinya, psjoa.jar (dengan mana BizTalk Adapter untuk PeopleSoft Enterprise berinteraksi) mengemas semua perubahan dan mengirim perubahan ke server dalam satu paket. Jika salah satu pembaruan individu gagal, kesalahan umum dikembalikan, yang tidak menentukan kesalahan aktual. Dengan mode interaktif diatur ke TRUE, setiap pembaruan bidang dikirim ke server satu per satu. Ini memiliki dampak besar pada performa, tetapi memberikan informasi kesalahan tertentu jika pembaruan gagal (misalnya, jika nilai yang tidak valid digunakan untuk mengatur bidang). InteractiveMode memberikan performa maksimum dan memberikan pelaporan kesalahan di tingkat pembaruan bidang. Untuk menggunakan fitur ini dengan benar, disarankan agar panggilan normal dilakukan dengan interactiveMode diatur ke FALSE. Seharusnya tidak ada dampak pada performa. Jika kesalahan dikembalikan, panggilan yang sama dapat dicoba kembali dengan bendera interactiveMode yang diatur ke TRUE. Ketika panggilan gagal, server mengembalikan pesan kesalahan yang lebih tepat. |
properties |
Struktur yang berisi semua properti antarmuka komponen. Ketika metode dipanggil CreateEx , properti ini dimasukkan ke dalam rekaman yang dibuat dengan kunci yang ditentukan. |
Dalam beberapa situasi, adalah praktik umum untuk memanggil CreateEx()
tanpa sekumpulan kunci eksplisit, tetapi CreateEx
fungsi mengembalikan kunci. Perilaku ini didukung dengan PeopleCode yang dipicu di server. Misalnya, untuk membuat pesanan pembelian, klien mungkin tidak tahu nomor PO berikutnya yang tersedia. Dengan menentukan NEXT sebagai kunci nomor PO, panggilan memicu PeopleCode, yang menentukan nomor PO berikutnya yang tersedia. Informasi ini harus dikembalikan ke klien panggilan, menggunakan parameter kunci masuk/keluar.
Catatan
Agar mekanisme ini berfungsi, kuncinya juga harus berupa properti pada tingkat 0. Jika tidak, kunci asli dikembalikan.
Metode BizTalk Adapter for PeopleSoft Enterprise CreateEx()
disediakan jika fungsi PeopleSoft Create and Save di antarmuka komponen diaktifkan.