Chia sẻ qua

retrieveMultipleRecords

Truy xuất tuyển tập các bản ghi bảng.

Sẵn dùng cho

Ứng dụng & cổng thông tin dựa trên mô hình.

Cú pháp

context.webAPI.retrieveMultipleRecords(entityLogicalName, options, maxPageSize).then(successCallback, errorCallback);

Tham số

Tên Loại Bắt buộc Description
tên thực thể String Có Tên lô-gic bảng của các bản ghi bạn muốn truy xuất. Ví dụ: "tài khoản".
tùy chọn String Không

Tùy chọn truy vấn hệ thống OData hoặc truy vấn FetchXML để truy xuất dữ liệu của bạn.

  • Các tùy chọn truy vấn hệ thống sau đây được hỗ trợ: $select, $top, $filter, $expand và $orderby.
  • Để xác định truy vấn FetchXML, hãy sử dụng cột fetchXml để xác định truy vấn.

LƯU Ý: Bạn phải luôn sử dụng tùy chọn truy vấn $select hệ thống để giới hạn các thuộc tính được trả về cho bản ghi bảng bằng cách bao gồm danh sách tên thuộc tính được phân tách bằng dấu phẩy. Việc giới hạn các cột bạn truy xuất là một biện pháp tốt nhất cho hiệu suất quan trọng. Nếu thuộc tính không được xác định bằng cách $select, tất cả các thuộc tính sẽ được trả về.

Bạn chỉ định các tùy chọn truy vấn bắt đầu bằng ?. Bạn cũng có thể chỉ định nhiều tùy chọn truy vấn hệ thống bằng cách sử dụng & để phân tách các tùy chọn truy vấn.

maxPageSize Số điện thoại Không

Xác định số dương cho biết số bản ghi bảng được trả về trên mỗi trang. Nếu bạn không xác định tham số này, giá trị mặc định sẽ được truyền là 5.000.

Nếu số bản ghi được maxPageSize truy xuất lớn hơn giá trị đã xác định, nextLink cột trong đối tượng promise trả về sẽ chứa một nối kết để truy xuất tập hợp bảng tiếp theo.

successCallback Hàm Không

Hàm cần gọi khi truy xuất bản ghi bảng. Một đối tượng với các cột sau đây được chuyển đến hàm:

  • entities: Một mảng các đối tượng JSON, trong đó mỗi đối tượng đại diện cho bản ghi bảng được truy xuất chứa các cột và các giá trị của chúng dưới dạng key: value cặp. Id của bản ghi bảng được truy xuất theo mặc định.
  • nextLink: Chuỗi. Nếu số bản ghi được maxPageSize truy xuất lớn hơn giá trị đã xác định trong tham số trong yêu cầu, cột này trả về URL để trả về tập bản ghi tiếp theo.
errorCallback Hàm Không Một hàm để gọi khi hoạt động không thành công.

Trả về giá trị

Loại: Promise<RetrieveMultipleResponse>

Mô tả: RetrieveMultipleResponse Trả về một hứa có chứa một mảng các đối tượng JSON chứa các bản ghi bảng được truy xuất và tham số nextLink với tham số URL trỏ đến tập hợp bản ghi tiếp theo trong trường hợp phân trang (maxPageSize) được xác định trong yêu cầu và số lượng bản ghi được trả về vượt quá giá trị phân trang. Nó có các tham số sau đây:

tham số Trả về giá trị Description
thực thể Entity[] Một mảng đối tượng JSON, trong đó mỗi đối tượng đại diện cho bản ghi bảng được truy xuất chứa các cột và giá trị của chúng.
nextLink string Nếu số bản ghi được truy xuất lớn hơn giá trị đã xác định trong tham số 'maxPageSize' trong yêu cầu, tham số này trả về URL để trả về tập bản ghi tiếp theo.

Web API
Tham khảo API khung thành phần Power Apps
Tổng quan về khuôn khổ cấu phần Power Apps

  • Last updated on