retrieveMultipleRecords

Načíta kolekciu záznamov tabuľky.

K dispozícii pre

Modelom riadené aplikácie a portály.

Syntax

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

Parametre

Meno	Typ	Požaduje sa	Popis
entityLogicalName	String	Áno	Logický názov tabuľky záznamov, ktoré chcete načítať. Napríklad: "účet".
možnosti	String	Nie	Možnosti dotazu systému OData alebo dotaz FetchXML na načítanie údajov. Podporované sú nasledujúce možnosti systémových dotazov: $select, $top, $filter, $expand a $orderby. Ak chcete zadať dotaz FetchXML, použite tento fetchXml stĺpec na zadanie dotazu. POZNÁMKA: Ak chcete obmedziť vlastnosti vrátené záznamom tabuľky zahrnutím zoznamu názvov vlastností oddelených čiarkou, musíte vždy použiť možnosť $select systémového dotazu. Obmedzenie načítania stĺpcov je dôležitým najvhodnejším postupom pri výkone. Ak vlastnosti nie sú zadané pomocou $select, vrátia sa všetky vlastnosti. Možnosti dotazu zadajte začínajúce na ?. Môžete tiež zadať viacero možností systémového dotazu pomocou na & oddelenie možností dotazu.
maxPageSize (maximálna veľkosť stránky)	Číslo	Nie	Zadajte kladné číslo, ktoré udáva počet záznamov tabuľky, ktoré sa majú vrátiť na stranu. Ak tento parameter nezadáte, predvolená hodnota sa odovzdá ako 5 000. Ak je počet načítaných záznamov vyšší ako zadaná maxPageSize hodnota, nextLink stĺpec vo vrátenom objekte sľubu bude obsahovať prepojenie na načítanie ďalšej množiny tabuliek.
úspechSpätné volanie	Function	Nie	Funkcia, ktorá sa zavolá pri načítavaní záznamov tabuľky. Do funkcie sa odovzdá objekt s nasledujúcimi stĺpcami: entity: pole objektov JSON, kde každý objekt predstavuje načítaný záznam tabuľky obsahujúci stĺpce a ich hodnoty ako key: value páry. Id záznamu tabuľky sa načíta v predvolenom nastavení. nextLink: Reťazec. Ak je počet načítaných záznamov vyšší ako hodnota zadaná v maxPageSize parametri v požiadavke, tento stĺpec vráti URL adresu, ktorá vráti nasledujúcu množinu záznamov.
errorCallback	Function	Nie	Funkcia, ktorá sa volá v prípade zlyhania operácie.

Vrátená hodnota

Typ: Promise<RetrieveMultipleResponse>

Popis: Vráti RetrieveMultipleResponse sľub, ktorý obsahuje pole objektov JSON obsahujúce načítané záznamy tabuľky a nasledujúci parameterLink s URL adresou smerujúcou na ďalšiu množinu záznamov v prípade, že je v žiadosti špecifikovaná stránkovanie (maxPageSize) a počet vrátených záznamov prekračuje hodnotu stránkovania. Má nasledujúce parametre:

parameter	Vrátená hodnota	Popis
Subjekty	Entity[]	Pole objektov JSON, kde každý objekt predstavuje načítaný záznam tabuľky obsahujúci stĺpce a ich hodnoty.
nextLink (ďalej Prepojenie)	string	Ak je počet načítaných záznamov vyšší ako hodnota zadaná v parametri maxPageSize v požiadavke, tento parameter vráti URL adresu, aby sa vrátila ďalšia množina záznamov.

Súvisiace články

Webové rozhranie API
Referenčné informácie k rozhraniam API architektúry súčastí služby Power Apps
Prehľad architektúry súčastí služby Power Apps