Xrm.WebApi.online.executeMultiple (Tham khảo API máy khách)

Thực hiện tuyển tập các thao tác hành động, hàm hoặc CRUD.

Lưu ý

Phương pháp này chỉ được hỗ trợ cho chế độ trực tuyến (Xrm.WebApi.online).

Nếu bạn muốn thực hiện nhiều yêu cầu trong một giao dịch, bạn phải vượt qua trong một thay đổi thiết lập như là một tham số để phương pháp này. Tập thay đổi đại diện cho một tập hợp các thao tác được thực hiện trong một giao dịch. Bạn cũng có thể chuyển các yêu cầu riêng lẻ và thay đổi tập hợp cùng nhau làm tham số cho phương pháp này.

Lưu ý

• Bạn không thể bao gồm các thao tác đọc (truy xuất, truy xuất nhiều hàm và các hàm WEB API) như một phần của bộ thay đổi; theo thông số kỹ thuật OData v4.
• Yêu cầu có thể chứa tối đa 1.000 yêu cầu riêng lẻ và không thể chứa các lô khác. Thông tin thêm: Thực hiện các thao tác lô.

Cú pháp

Thực hiện nhiều yêu cầu:

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

Thực hiện nhiều yêu cầu trong một giao dịch:

Trong trường hợp này, req1, req2và được req3 thực hiện trong một giao dịch.

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

Thực hiện kết hợp các yêu cầu riêng lẻ và nhiều yêu cầu trong một giao dịch:

Trong trường hợp này, req1, và được req3 thực hiện trong giao dịch, nhưng req4 và req5 được thực req2hiện riêng lẻ.

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

Tham số

Tên	Loại	Bắt buộc	Sự miêu tả
requests	Mảng đối tượng	Có	Mảng gồm một trong các loại sau: Đối tượng mà mỗi đối tượng là một hành động, hàm hoặc yêu cầu CRUD mà bạn muốn thực thi đối với điểm cuối API Web. Mỗi đối tượng hiển thị một phương pháp getMetadata cho phép bạn xác định siêu dữ liệu cho hành động, hàm hoặc yêu cầu CRUD mà bạn muốn thực hiện. Phương pháp thực thi chấp nhận loại tham số này. Thay đổi tập hợp (một mảng đối tượng), trong đó mỗi đối tượng trong tập hợp thay đổi như được giải thích trước đó. Trong trường hợp này, tất cả các đối tượng yêu cầu được chỉ định trong tập hợp thay đổi được thực hiện trong một giao dịch. Tìm các ví dụ về yêu cầu trong phần Cú pháp.
successCallback	Hàm	Không	Hàm để gọi khi thao tác được thực thi thành công. Một mảng các đối tượng phản hồi được chuyển tới hàm. Xem Giá trị Trả về
errorCallback	Hàm	Không	Một hàm để gọi khi hoạt động không thành công. Một đối tượng với các thuộc tính sau đây được truyền đi: - errorCode:Số. Mã lỗi dưới dạng số thập phân dương. Ví dụ: mã lỗi được ghi là sẽ 0x80040333 được trả về dưới dạng 2147746611. - message:Xâu. Thông báo lỗi mô tả sự cố.

Trả về giá trị

Khi thành công, trả về một lời hứa chứa một mảng các đối tượng cho successCallback. Các đối tượng có các thuộc tính sau:

Tên	Loại	Bắt buộc	Sự miêu tả
json	Hứa	Không	Nội dung phản hồi ở định dạng JSON.
text	Hứa	Không	Nội dung phản hồi ở định dạng văn bản thuần.
headers	Đối tượng	Có	Tiêu đề phản hồi.
ok	Boolean	Có	Cho biết yêu cầu có thành công hay không.
status	Số điện thoại	Có	Giá trị số trong mã trạng thái phản hồi. Ví dụ: 200
statusText	String	Có	Mô tả mã trạng thái phản hồi. Ví dụ: OK
type	String	Có	Loại phản hồi. Giá trị là: chuỗi trống (mặc định), arraybuffer, blob, document, json, và text.
url	String	Có	YÊU CẦU URL của hành động, chức năng hoặc yêu cầu CRUD đã được gửi đến điểm cuối API Web.

Bài viết liên quan

Xrm.WebApi