retrieveMultipleRecords

Pridobi zbirko zapisov tabele.

Na voljo za

Aplikacije in portali, ki temeljijo na modelu.

Sintaksa

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

Parametrov

Ime	Vrsta	Zahtevano	Opis
entityLogicalName	String	Da	Logično ime tabele zapisov, ki jih želite pridobiti. Na primer: »račun«.
Možnosti	String	Ne	Možnosti sistemske poizvedbe OData ali poizvedba FetchXML za pridobivanje podatkov. Podprte so te možnosti sistemskih poizvedb: $select, $top, $filter, $expand in $orderby. Če želite določiti poizvedbo FetchXML, s fetchXml stolpcem določite poizvedbo. OPOMBA: Če želite omejiti lastnosti, ki $select zapisu tabele, morate vedno uporabiti možnost sistemske poizvedbe, tako da dodate seznam imen lastnosti, ki so ločena z vejico. Omejevanje stolpcev, ki jih pridobite, je pomembna najboljša praksa za učinkovitost delovanja. Če lastnosti niso določene s $select, bodo vrnjene vse lastnosti. Določite možnosti poizvedbe, ki se začnejo z ?. Določite lahko tudi več sistemskih možnosti poizvedbe, tako da & ločite možnosti poizvedbe.
maxPageSize	Število	Ne	Navedite pozitivno število, ki označuje število zapisov tabele, ki bodo vrnjeni na stran. Če tega parametra ne navedete, je privzeta vrednost posredovana kot 5000. Če je število zapisov, ki so maxPageSize pridobljeni, večje od določene vrednosti, nextLink stolpec v vrnjenem predmetu obljube vsebuje povezavo za pridobivanje naslednjega nabora tabel.
uspehPovratni klic	Function	Ne	Funkcija, ki pokliče, ko so pridobljeni zapisi tabele. Funkciji je posredovan predmet s temi stolpci: entitete: Matrika predmetov JSON, kjer vsak predmet predstavlja pridobljen zapis tabele, ki vsebuje stolpce in njihove vrednosti kot key: value pare. Id zapisa tabele je privzeto pridobljen. nextLink: Niz. Če je število zapisov, ki so pridobljeni maxPageSize , večje od vrednosti, določene v parametru v zahtevi, ta stolpec vrne URL, da vrne naslednji nabor zapisov.
errorCallback	Function	Ne	Funkcija, ki jo pokličete, ko operacija ne uspe.

Vrednost vračila

Vrsta: Promise<RetrieveMultipleResponse>

Opis: RetrieveMultipleResponse Vrne obljubo, ki vsebuje matriko predmetov JSON, ki vsebujejo pridobljene zapise tabele, in parameter nextLink z URL-jem, ki kaže na naslednji nabor zapisov v primeru, da je ostranjevanje (maxPageSize) določeno v zahtevi, vrnjeno število zapisov pa presega vrednost ostranjevalne vrednosti. Vsebuje te parametre:

parameter	Vrednost vračila	Opis
Subjekti	Entity[]	Matrika predmetov JSON, kjer vsak predmet predstavlja pridobljen zapis tabele, ki vsebuje stolpce in njihove vrednosti.
nextLink	string	Če je število zapisov, ki so pridobljeni, večje od vrednosti, navedene v parametru »maxPageSize« v zahtevi, ta parameter vrne URL, da vrne naslednji nabor zapisov.

Povezani članki

Spletni API
Sklic na VMESNIK API za ogrodje komponent Power Apps
Pregled ogrodja komponent power apps