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

Laksanakan koleksi tindakan, fungsi atau operasi CRUD.

Nota

Kaedah ini hanya disokong untuk mod dalam talian (Xrm.WebApi.online).

Jika anda ingin melaksanakan berbilang permintaan dalam transaksi, anda mesti menghantar set perubahan sebagai parameter kepada kaedah ini. Set perubahan mewakili koleksi operasi yang dilaksanakan dalam transaksi. Anda juga boleh menghantar permintaan individu dan menukar set bersama-sama sebagai parameter kepada kaedah ini.

Nota

• Anda tidak boleh memasukkan operasi baca (mengambil, mendapatkan semula berbilang dan fungsi API Web) sebagai sebahagian daripada set perubahan; ini mengikut spesifikasi OData v4.
• Permintaan boleh mengandungi sehingga 1,000 permintaan individu dan tidak boleh mengandungi kumpulan lain. Maklumat lanjut: Laksanakan operasi kelompok.

Sintaks

Laksanakan berbilang permintaan:

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

Laksanakan berbilang permintaan dalam transaksi:

Dalam kes ini, req1, , req2dan req3 dilaksanakan dalam transaksi.

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

Laksanakan gabungan permintaan individu dan berbilang permintaan dalam transaksi:

Dalam kes ini, req1, , req2dan req3 dilaksanakan dalam transaksi, tetapi req4 dan req5 dilaksanakan secara individu.

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

Parameter

Nama	Jenis	Wajib	Keterangan
requests	Pelbagai objek	Ya	Tatasusunan salah satu daripada jenis berikut: Objek di mana setiap objek ialah tindakan, fungsi atau permintaan CRUD yang anda mahu laksanakan terhadap titik akhir API Web. Setiap objek mendedahkan kaedah getMetadata yang membolehkan anda mentakrifkan metadata untuk tindakan, fungsi atau permintaan CRUD yang ingin anda laksanakan. Kaedah pelaksanaan menerima parameter jenis ini. Set perubahan (tatasusunan objek), di mana setiap objek dalam set perubahan adalah seperti yang dijelaskan sebelum ini. Dalam kes ini, semua objek permintaan yang dinyatakan dalam set perubahan dilaksanakan dalam transaksi. Cari contoh permintaan dalam bahagian Sintaks.
successCallback	Function	Tidak	Fungsi untuk memanggil apabila operasi berjaya dilaksanakan. Tatasusunan objek tindak balas dihantar kepada fungsi. Lihat Nilai Pulangan
errorCallback	Function	Tidak	Fungsi untuk memanggil apabila operasi gagal. Objek dengan sifat berikut diluluskan: - errorCode:Nombor. Kod ralat sebagai nombor perpuluhan positif. Sebagai contoh, kod ralat yang didokumentasikan sebagai akan 0x80040333 dikembalikan sebagai 2147746611. - message:Rentetan. Mesej ralat yang menerangkan isu tersebut.

Nilai Pulangan

Apabila berjaya, mengembalikan janji yang mengandungi tatasusunan objek kepada successCallback. Objek mempunyai sifat ini:

Nama	Jenis	Wajib	Keterangan
json	Janji	Tidak	Badan respons dalam format JSON.
text	Janji	Tidak	Badan respons dalam format teks biasa.
headers	Objek	Ya	Tajuk respons.
ok	Boolean	Ya	Menunjukkan sama ada permintaan itu berjaya.
status	Nombor	Ya	Nilai berangka dalam kod status respons. Sebagai contoh: 200
statusText	String	Ya	Penerangan kod status respons. Sebagai contoh: OK
type	String	Ya	Jenis tindak balas. Nilai ialah: rentetan kosong (lalai), arraybuffer, blob, jsondocument, , dan text.
url	String	Ya	Permintaan URL tindakan, fungsi atau permintaan CRUD yang dihantar ke titik akhir API Web.

Artikel berkaitan

Xrm.WebApi