Xrm.WebApi.online.executeMultiple (Referensi API Klien)

Jalankan kumpulan operasi tindakan, fungsi, atau CRUD.

Nota

Metode ini hanya didukung untuk mode online (Xrm.WebApi.online).

Jika Anda ingin menjalankan beberapa permintaan dalam transaksi, Anda harus meneruskan set perubahan sebagai parameter ke metode ini. Set perubahan mewakili kumpulan operasi yang dijalankan dalam transaksi. Anda juga dapat meneruskan permintaan individual dan mengubah set bersama-sama sebagai parameter ke metode ini.

Nota

• Anda tidak dapat menyertakan operasi baca (mengambil, mengambil beberapa, dan fungsi API Web) sebagai bagian dari set perubahan; ini sesuai spesifikasi OData v4.
• Permintaan dapat berisi hingga 1.000 permintaan individual dan tidak dapat berisi batch lain. Informasi selengkapnya: Jalankan operasi batch.

Syntax

Jalankan beberapa permintaan:

var requests = [req1, req2, req3];
Xrm.WebApi.online.executeMultiple(requests).then(successCallback, errorCallback);

Jalankan beberapa permintaan dalam transaksi:

Dalam hal ini, req1, req2, dan req3 dijalankan dalam transaksi.

var changeSet = [req1, req2, req3];
var requests = [changeSet];
Xrm.WebApi.online.executeMultiple(requests).then(successCallback, errorCallback);

Jalankan campuran permintaan individual dan beberapa permintaan dalam transaksi:

Dalam hal ini, req1, req2, dan req3 dijalankan dalam transaksi, tetapi req4 dan req5 dijalankan secara individual.

var changeSet = [req1, req2, req3];
var requests = [req4, req5, changeset];
Xrm.WebApi.online.executeMultiple(requests).then(successCallback, errorCallback);

Parameter-parameternya

Nama	Tipe	Diperlukan	Description
requests	Array dari objek-objek	Yes	Array dari salah satu jenis berikut: Objek di mana setiap objek adalah permintaan tindakan, fungsi, atau CRUD yang ingin Anda jalankan terhadap titik akhir API Web. Setiap objek mengekspos metode getMetadata yang memungkinkan Anda menentukan metadata untuk permintaan tindakan, fungsi, atau CRUD yang ingin Anda jalankan. Metode eksekusi menerima jenis parameter ini. Set perubahan (array objek), di mana setiap objek dalam set perubahan seperti yang dijelaskan sebelumnya. Dalam hal ini, semua objek permintaan yang ditentukan dalam set perubahan dijalankan dalam transaksi. Temukan contoh permintaan di bagian Sintaks.
successCallback	Function	Tidak.	Fungsi yang akan dipanggil saat operasi berhasil dijalankan. Array objek respons diteruskan ke fungsi . Lihat Mengembalikan Nilai
errorCallback	Function	Tidak.	Fungsi untuk memanggil saat operasi gagal. Objek dengan properti berikut diteruskan: - errorCode:Angka. Kode kesalahan sebagai angka desimal positif. Misalnya, kode kesalahan yang didokumenkan sebagai 0x80040333 akan dikembalikan sebagai 2147746611. - message:Tali. Pesan kesalahan yang menjelaskan masalah.

Mengembalikan Nilai

Setelah berhasil, mengembalikan janji yang berisi array objek ke successCallback. Objek memiliki properti ini:

Nama	Tipe	Diperlukan	Description
json	Janji	Tidak.	Isi respons dalam format JSON.
text	Janji	Tidak.	Isi respons dalam format teks biasa.
headers	Objek	Yes	Header respons.
ok	Boolean	Yes	Menunjukkan apakah permintaan berhasil.
status	Number	Yes	Nilai numerik dalam kode status respons. Misalnya: 200
statusText	String	Yes	Deskripsi kode status respons. Misalnya: OK
type	String	Yes	Jenis respons. Nilainya adalah: string kosong (default), arraybuffer, , blob, jsondocument, dan text.
url	String	Yes	URL permintaan tindakan, fungsi, atau permintaan CRUD yang dikirim ke titik akhir API Web.

Artikel terkait

Xrm.WebApi