Xrm.WebApi.online.executeMultiple (การอ้างอิง API ไคลเอ็นต์)

ใช้คอลเลกชันของการดําเนินการ ฟังก์ชัน หรือการดําเนินการ CRUD

Note

วิธีนี้ได้รับการสนับสนุนสําหรับโหมดออนไลน์ (Xrm.WebApi.online) เท่านั้น

หากคุณต้องการดําเนินการหลายคําขอในทรานแซคชัน คุณต้องส่งผ่านการเปลี่ยนแปลงที่ตั้งค่าเป็นพารามิเตอร์ไปยังวิธีนี้ ชุดการเปลี่ยนแปลง แสดงคอลเลกชันของการดําเนินการที่ดําเนินการในธุรกรรม คุณยังสามารถส่งผ่านคําขอแต่ละรายการและเปลี่ยนชุดร่วมกันเป็นพารามิเตอร์ไปยังวิธีนี้ได้

Note

• คุณไม่สามารถรวมการดําเนินการอ่าน (เรียกใช้หลายและฟังก์ชัน API ของเว็บ) เป็นส่วนหนึ่งของชุดการเปลี่ยนแปลงได้ ตามข้อกําหนดของ OData v4
• คําขอสามารถมีคําขอได้สูงสุด 1,000 คําขอและไม่สามารถมีชุดคําขออื่น ๆ ได้ ข้อมูลเพิ่มเติม:การดําเนินการตามชุดงาน

ไวยากรณ์

ดําเนินการหลายคําขอ:

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

ดําเนินการหลายคําขอในทรานแซคชัน:

ในกรณีนี้ req1, , req2และ req3 จะดําเนินการในทรานแซคชัน

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

ดําเนินการผสมผสานของคําขอแต่ละรายการและคําขอหลายรายการในการทําธุรกรรม:

ในกรณีนี้, req1, req2และ req3 จะดําเนินการในการทําธุรกรรม แต่ req4 และ req5 จะดําเนินการทีละรายการ

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

พารามิเตอร์

ชื่อ	ประเภท	ต้องมี	คำอธิบาย
requests	อาร์เรย์ของวัตถุ	ใช่	อาร์เรย์ของหนึ่งในชนิดต่อไปนี้: ออบเจ็กต์ ที่แต่ละออบเจ็กต์เป็นการดําเนินการ ฟังก์ชัน หรือคําขอ CRUD ที่คุณต้องการดําเนินการกับจุดสิ้นสุด API เว็บ วัตถุแต่ละรายการจะแสดง เมธอด getMetadata ที่ช่วยให้คุณกําหนดเมตาดาต้าสําหรับการดําเนินการ ฟังก์ชัน หรือคําขอ CRUD ที่คุณต้องการดําเนินการ วิธีดําเนินการยอมรับพารามิเตอร์ประเภทนี้ เปลี่ยนชุด (อาร์เรย์ของออบเจ็กต์) ซึ่งแต่ละออบเจ็กต์ในชุดการเปลี่ยนแปลงเป็นไปตามที่อธิบายไว้ก่อนหน้านี้ ในกรณีนี้ วัตถุคําขอทั้งหมดที่ระบุในชุดการเปลี่ยนแปลงจะดําเนินการในทรานแซคชัน ค้นหาตัวอย่างคําขอในส่วนไวยากรณ์
successCallback	ฟังก์ชัน	ไม่	ฟังก์ชันที่จะเรียกใช้เมื่อการดําเนินการเสร็จเรียบร้อยแล้ว อาร์เรย์ของวัตถุตอบสนองจะถูกส่งผ่านไปยังฟังก์ชัน ดู ค่าที่ส่งกลับ
errorCallback	ฟังก์ชัน	ไม่	ฟังก์ชันที่จะเรียกใช้เมื่อการดําเนินการล้มเหลว วัตถุที่มีคุณสมบัติต่อไปนี้จะถูกส่งผ่าน: - errorCode:เลข รหัสข้อผิดพลาดเป็นเลขทศนิยมบวก ตัวอย่างเช่น รหัสข้อผิดพลาดที่จัดทําเป็น 0x80040333 จะถูกส่งกลับเป็น2147746611 - message:เชือก ข้อความแสดงข้อผิดพลาดที่อธิบายปัญหา

ค่าส่งกลับ

ในความสําเร็จ ส่งกลับสัญญาที่มีอาร์เรย์ของออบเจ็กต์ไปยังsuccessCallback วัตถุมีคุณสมบัติเหล่านี้:

ชื่อ	ประเภท	ต้องมี	คำอธิบาย
json	สัญญา	ไม่	เนื้อความการตอบสนองในรูปแบบ JSON
text	สัญญา	ไม่	เนื้อหาคําตอบในรูปแบบข้อความธรรมดา
headers	วัตถุ	ใช่	ส่วนหัวของคําตอบ
ok	แบบบูลีน	ใช่	ระบุว่าคําขอสําเร็จหรือไม่
status	ตัวเลข	ใช่	ค่าตัวเลขในรหัสสถานะการตอบสนอง ตัวอย่าง: 200
statusText	สตริง	ใช่	คําอธิบายเกี่ยวกับรหัสสถานะการตอบสนอง ตัวอย่าง: OK
type	สตริง	ใช่	ชนิดการตอบสนอง ค่าคือ: สตริงว่าง (ค่าเริ่มต้น), arraybuffer, blobdocument, json, และtext
url	สตริง	ใช่	ร้องขอ URL ของการดําเนินการ ฟังก์ชัน หรือคําขอ CRUD ที่ถูกส่งไปยังจุดสิ้นสุดของ API เว็บ

บทความที่เกี่ยวข้อง

Xrm.WebApi