Baca dalam bahasa Inggris

Bagikan melalui


Metode DeleteOnly

Memungkinkan Anda menghapus item dalam koleksi.

Sintaks

DeleteOnly(key1, key2, ..., keyn, correctionMode, interactiveMode,  
    properties)  

Parameter

Parameter Deskripsi
key Adalah sekumpulan parameter yang harus disediakan. Kumpulan kunci ini 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 penghapusan item tanggal efektif sebelumnya dalam koleksi. Secara khusus, ini memungkinkan penghapusan 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. Catatan: Argumen correctionMode hanya diekspos untuk antarmuka komponen yang berisi item tanggal efektif. Jika tidak, itu tidak ditampilkan sebagai bagian dari argumen.
interactiveMode Digunakan untuk penanganan kesalahan.

Saat mengakses properti di antarmuka komponen, Adapter BizTalk 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).

Parameter 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 interactiveMode yang diatur ke TRUE. Ketika panggilan gagal, server mengembalikan pesan kesalahan yang lebih tepat.
properties Berisi subset struktur yang ada di server. Semua item yang merupakan daun dihapus.

Keterangan

Properti memiliki jenis data yang sama dengan CreateEx metode atau UpdateEx antarmuka komponen ini; namun, hanya nilai kunci yang penting. Nilai non-kunci diabaikan. Nilai kunci harus cocok dengan yang ada di server, jika tidak, pengecualian akan dinaikkan.

Berikut ini menunjukkan penggunaan nilai kunci. Jika koleksi berisi item:

  • item0

  • item1

  • item2

  • item3

    Anda dapat menghapus item1 dan item3 dengan menyediakan kunci item1 dan item3 di properti:

  • item1

  • item3

    Setelah panggilan, server memiliki item yang tersisa dalam koleksi:

  • item0

  • item2

    Contoh kedua menunjukkan item yang berisi koleksi lain:

  • item0

    • item0a
  • item1

    • item1a

    • item1b

    • item1c

  • item2

    • item2a

    • item2b

    Anda dapat menghapus item1b dan semua item2 dengan memberikan kunci ke item1b dan item2:

  • item1

    • item1b
  • item2

    Dengan menyediakan sub-koleksi kosong untuk item2, Anda mengubahnya menjadi daun dan seluruh subcabang dihapus. Setelah panggilan, server memiliki item yang tersisa:

  • item0

    • item0a
  • item1

    • item1a

    • item1c

Lihat juga

Lampiran A: Metode Antarmuka Komponen