Metode UpdateEx
Digunakan untuk memperbarui properti berdasarkan parameter kunci input (key1, key2, ... keyn). Saat menggunakan UpdateEx
, Anda tidak dapat menghapus item dalam koleksi. Metode terpisah memfasilitasi penghapusan. Untuk informasi selengkapnya, lihat Metode DeleteOnly.
UpdateEx (key1, key2, ... keyn, correctionMode, interactiveMode,
properties)
Parameter | Deskripsi |
---|---|
key |
Sekumpulan parameter yang harus ada di database server, atau terjadi kesalahan. Kunci ini sesuai dengan set Dapatkan Kunci seperti yang didefinisikan untuk antarmuka komponen tertentu. |
correctionMode |
Bendera Boolean. Ketika diatur ke true, memungkinkan modifikasi pada antarmuka komponen dengan item tanggal efektif baik dengan memperbarui nilai bidang, atau dengan menyisipkan item baru ke dalam koleksi. Secara khusus, ini memungkinkan modifikasi pada item yang memiliki EFFDT sebelum tanggal efektif saat ini. Tanpa bendera ini diatur ke TRUE, modifikasi apa pun pada item ini menghasilkan kesalahan yang dikembalikan dari server PeopleSoft. Argumen correctionMode hanya diekspos untuk antarmuka komponen yang berisi item tanggal efektif. Jika tidak, itu tidak ditampilkan sebagai bagian dari argumen.Anda harus menghindari pengaturan correctionMode ke TRUE di lingkungan produksi. (Ini juga merupakan rekomendasi dari PeopleSoft.) Peristiwa yang telah terjadi sebagaimana ditentukan oleh kunci EFFDT sebelumnya tidak boleh dimodifikasi. Ini memungkinkan pembuatan jejak audit. correctionMode Bendera di UpdateEx memungkinkan mekanisme keamanan ini dilewati. Praktik yang disarankan adalah agar peristiwa sebelumnya dinonaktifkan dengan mengatur bidang dalam item, dan menambahkan (alih-alih menghapus) item yang diperbarui. |
interactiveMode |
Bendera yang digunakan untuk penanganan kesalahan. Saat mengakses properti di antarmuka komponen, BizTalk Adapter untuk 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 Anda melakukan panggilan normal dengan interactiveMode diatur ke FALSE. Seharusnya tidak ada dampak pada performa. Jika kesalahan dikembalikan, panggilan yang sama dapat dicoba kembali dengan bendera yang interactiveMode diatur ke TRUE. Ketika panggilan gagal, server mengembalikan pesan kesalahan yang lebih tepat. |
Saat Anda memanggil fungsi ini, properti rekaman yang sesuai dengan kunci digantikan oleh properti parameter input. Semua koleksi dengan rekaman asli dihapus dan digantikan oleh yang ada di parameter input. Ukuran koleksi ini tidak harus cocok karena prosedur di dalamnya UpdateEx
adalah menghapus semua item koleksi yang ada lalu menyisipkan yang diberikan.
Jika properti antarmuka komponen berisi item tanggal efektif, parameter properti harus berisi semua item tanggal efektif di masa mendatang karena daftar asli diganti. Ini menyediakan mekanisme untuk menambahkan dan menghapus item tanggal efektif di masa mendatang; namun, jika properti juga berisi item tanggal efektif masa lalu, kesalahan dikembalikan karena item tanggal efektif sebelumnya tidak dapat dimodifikasi. Jika item tanggal efektif saat ini juga disertakan, item tersebut akan diabaikan. Ini memungkinkan klien untuk memanggil Get()
dengan parameter yang getHistoryItems
diatur ke False, dan memodifikasi item tanggal efektif di masa mendatang atau menambahkan item tanggal efektif di masa mendatang, dan meneruskan struktur sebagai parameter untuk fungsi.UpdateEx()
Jika antarmuka komponen tidak memiliki kunci, seperti dalam kasus di mana hanya satu instans yang dapat ada, UpdateEx()
metode memiliki formulir:
UpdateEx(correctionMode, interactiveMode, properties)
Catatan
Metode BizTalk Adapter for PeopleSoft Enterprise UpdateEx()
disediakan jika PeopleSoft Get
dan Save
fungsi di antarmuka komponen diaktifkan.