Sdílet prostřednictvím

retrieveMultipleRecords

Načte kolekci záznamů tabulky.

K dispozici pro

Modelem řízené aplikace a portály

Syntaxe

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

Parametry

Název Typ Povinné Description
Logický_název entity String Ano Logický název tabulky záznamů, které chcete načíst. Příklad: "účet".
options String Ne

Možnosti systémového dotazu OData nebo dotaz FetchXML pro načtení dat.

  • Podporují se následující možnosti systémového dotazu: $select, $top, $filter, $expand a $orderby.
  • Pokud chcete zadat dotaz FetchXML, zadejte dotaz pomocí fetchXml sloupce.

POZNÁMKA: Chcete-li omezit vlastnosti vrácené pro záznam tabulky tak, že zahrnete seznam názvů vlastností oddělených čárkami, musíte vždy použít možnost systémového dotazu $select. Omezení načtených sloupců je důležitým osvědčeným postupem z hlediska výkonu. Pokud nejsou vlastnosti zadány pomocí $select, vrátí se všechny vlastnosti.

Volby dotazu se zadávají začínající .? K oddělení možností dotazu můžete také použít několik systémových dotazů & .

maxPageSize Number Ne

Zadejte kladné číslo, které označuje počet záznamů tabulky, které se mají vrátit na stránku. Pokud tento parametr nezadáte, bude výchozí hodnota předána jako 5 000.

Pokud je počet načtených záznamů větší než zadaná maxPageSize hodnota, nextLink bude sloupec ve vrácených objektech příslibu obsahovat odkaz na načtení další sady tabulek.

úspěchZpětné volání Funkce Ne

Funkce, která se má volat při načtení záznamů tabulky. Do funkce se předá objekt s následujícími sloupci:

  • entity: Pole objektů JSON, kde každý objekt představuje načtený záznam tabulky obsahující sloupce a jejich hodnoty jako key: value páry. ID záznamu tabulky se ve výchozím nastavení načte.
  • nextLink: String. Pokud je počet načtených záznamů větší než hodnota zadaná v parametru maxPageSize v požadavku, vrátí tento sloupec adresu URL pro vrácení další sady záznamů.
errorCallback Funkce Ne Funkce, která se má volat v případě selhání operace.

Návratová hodnota

Typ: Promise<RetrieveMultipleResponse>

Popis: Vrátí RetrieveMultipleResponse příslib, který obsahuje pole objektů JSON obsahující načtené záznamy tabulky a parametr nextLink s adresou URL odkazující na další sadu záznamů v případě, že je v požadavku zadán stránkování (maxPageSize) a vrácený počet záznamů překračuje hodnotu stránkování. Má následující parametry:

parametr Návratová hodnota Description
entities Entity[] Pole objektů JSON, kde každý objekt představuje načtený záznam tabulky obsahující sloupce a jejich hodnoty.
další odkaz string Pokud je počet načtených záznamů větší než hodnota zadaná v parametru maxPageSize v požadavku, vrátí tento parametr adresu URL pro vrácení další sady záznamů.

Webové rozhraní API
Referenční informace k rozhraní API pro architekturu komponent Power Apps
Přehled architektury komponent Power Apps

  • Last updated on