retrieveMultipleRecords

Отримує колекцію записів таблиці.

Доступно для

Програми на основі моделі та портали.

Синтаксис

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

Параметри

Ім'я	Тип	Обов'язковий	Опис
entityLogicalName	String	Так	Логічне ім'я таблиці записів, які потрібно отримати. Наприклад: "аккаунт".
параметри	String	Ні	Параметри системного запиту OData або запит FetchXML для отримання даних. Підтримуються такі параметри системного запиту: $select, $top, $filter, $expand та $orderby. Щоб указати запит FetchXML, скористайтеся fetchXml стовпцем, щоб указати запит. ПРИМІТКА. Щоб обмежити властивості, які повертаються для запису таблиці, потрібно завжди використовувати параметр $select системного запиту, включно з іменами властивостей, розділеними комами. Обмеження стовпців, які ви маєте, – це важлива практична практична практика. Якщо властивості не вказано за допомогою $select, буде повернуто всі властивості. Ви вказуєте параметри запиту, які починаються з ?. Також можна вказати кілька параметрів системного запиту, використовуючи & для відокремлення параметрів запиту.
maxPageSize	Номер	Ні	Укажіть додатне число, яке вказує кількість записів таблиці, які потрібно повернути на сторінці. Якщо не вказати цей параметр, значення за промовчанням передається як 5000. Якщо кількість записів, які отримуються, перевищує вказане maxPageSize значення, nextLink стовпець у повернутому об'єкті обіцянки міститиме посилання для отримання наступного набору таблиць.
Зворотній дзвінок	Function	Ні	Функція для виклику під час отримання записів таблиці. До функції передається об'єкт із такими стовпцями: сутності: масив об'єктів JSON, де кожен об'єкт представляє отриманий запис таблиці, що містить стовпці та їх значення як key: value пари. Ідентифікатор запису таблиці отримується за замовчуванням. nextLink: String. Якщо кількість записів, які отримуються, перевищує значення, указане в maxPageSize параметрі запиту, цей стовпець повертає URL-адресу, щоб повернути наступний набір записів.
errorЗворотний дзвінок	Function	Ні	Функція для виклику, коли операція не вдається.

Повернуте значення

Тип: Promise<RetrieveMultipleResponse>

Опис. Повертає RetrieveMultipleResponse обіцянку, яка містить масив об'єктів JSON, що містять отримані записи таблиці, і параметр NextLink з URL-адресою, яка вказує на наступний набір записів на випадок, якщо в запиті вказано довантаження (maxPageSize), а повернута кількість записів перевищує значення довантаження. Він має такі параметри:

параметр	Повернуте значення	Опис
Осіб	Entity[]	Масив об'єктів JSON, де кожен об'єкт представляє отриманий запис таблиці, що містить стовпці та їхні значення.
nextLink	string	Якщо кількість записів, які отримуються, перевищує значення, указане в параметрі "maxPageSize" в запиті, цей параметр повертає URL-адресу, щоб повернути наступний набір записів.

Пов’язані статті

Веб-API
Довідник із API компонента Power Apps
Огляд структури компонентів Power Apps