Споделяне чрез

retrieveMultipleRecords

Извлича колекция от записи на таблица.

Налично за

Базирани на модел приложения и портали.

Синтаксис

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

Параметри

Име Вид Необходимо Описание
entityLogicName String Да Логическото име на таблицата на записите, които искате да извлечете. Например: "акаунт".
опции String Не

Опции за заявки за OData система или FetchXML заявка за извличане на вашите данни.

  • Поддържат се следните опции за системни заявки: $select, $top, $filter, $expand и $orderby.
  • За да зададете заявка FetchXML, използвайте fetchXml колоната, за да зададете заявката.

ЗАБЕЛЕЖКА: Винаги трябва да използвате опцията $select системна заявка, за да ограничите свойствата, върнати за запис на таблица, като включите разделен със запетаи списък с имена на свойства. Ограничаването на колоните, които извличате, е важна най-добра производителност. Ако свойствата не са зададени с помощта на $select, ще бъдат върнати всички свойства.

Задавате опциите за заявка, започващи с ?. Можете също да зададете няколко опции за системни заявки, като използвате & за отделяне на опциите за заявки.

maxPageSize Номер Не

Задайте положително число, което показва броя на записите на таблицата, които трябва да бъдат върнати на страница. Ако не зададете този параметър, стойността по подразбиране се подава като 5000.

Ако броят на записите, които се извличат, е по-голям от зададената maxPageSize стойност, nextLink колоната във върнатото обещание ще съдържа връзка за извличане на следващия набор от таблици.

успехОбратно обаждане Function Не

Функция за извикване, когато се извличат записи на таблица. На функцията се подава обект със следните колони:

  • обекти: масив от JSON обекти, където всеки обект представлява извлечения запис на таблица, съдържащ колоните и техните стойности като key: value двойки. ИД на записа на таблицата се извлича по подразбиране.
  • nextLink: Низ. Ако броят на извлечените записи е по-голям от стойността, зададена в параметъра maxPageSize в искането, тази колона връща URL адреса, за да върне следващия набор от записи.
errorCallback Function Не Функция, която да се извика, когато операцията е неуспешна.

Връщана стойност

Тип: Promise<RetrieveMultipleResponse>

Описание: RetrieveMultipleResponse Връща обещание, което съдържа масив от JSON обекти, съдържащи извлечените записи на таблицата, и параметъра nextLink с URL адрес, сочещ към следващия набор от записи, в случай че страниране (maxPageSize) е зададено в искането, а върнатият брой записи надхвърля стойността за виртуална памет. Той има следните параметри:

параметър Връщана стойност Описание
Обекти Entity[] Масив от JSON обекти, където всеки обект представлява извлечения запис на таблица, съдържащ колоните и техните стойности.
следваща връзка string Ако броят на извлечените записи е по-голям от стойността, зададена в параметъра "maxPageSize" в искането, този параметър връща URL адреса, за да върне следващия набор от записи.

Уеб API
Препратка към API на платформа за компоненти на Power Apps
Общ преглед на рамката на компонентите на Power Apps

  • Last updated on