retrieveMultipleRecords

Henter en samling af tabelposter.

Tilgængelig for

Modeldrevne apps og portaler.

Syntaks

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

Parametre

Navn	Type	Påkrævet	Beskrivelse
entityLogicalName	String	Ja	Det tabellogiske navn på de poster, du vil hente. For eksempel: "konto".
indstillinger	String	Nej	OData-systemforespørgselsindstillinger eller FetchXML-forespørgsel for at hente dine data. Følgende systemforespørgselsindstillinger understøttes: $select, $top, $filter, $expand og $orderby. Hvis du vil angive en FetchXML-forespørgsel, skal du bruge kolonnen fetchXml til at angive forespørgslen. BEMÆRK! Du skal altid bruge indstillingen $select systemforespørgsel til at begrænse de egenskaber, der returneres for en tabelpost, ved at inkludere en kommasepareret liste over egenskabsnavne. Begrænsning af de kolonner, du henter, er en vigtig bedste praksis for ydeevne. Hvis der ikke er angivet egenskaber ved hjælp af $select, returneres alle egenskaber. Du angiver forespørgselsindstillingerne begyndende med ?. Du kan også angive flere indstillinger for systemforespørgslen ved hjælp & af for at adskille forespørgselsindstillingerne.
maxPageSize	Antal	Nej	Angiv et positivt tal, der angiver antallet af tabelposter, der skal returneres pr. side. Hvis du ikke angiver denne parameter, overføres standardværdien som 5.000. Hvis det antal poster, der hentes, er større end den angivne maxPageSize værdi, nextLink indeholder kolonnen i det returnerede løfteobjekt et link til hentning af det næste sæt tabeller.
succesTilbagekald	Funktion	Nej	En funktion, der skal kaldes, når tabelposter hentes. Et objekt med følgende kolonner overføres til funktionen: objekter: En matrix af JSON-objekter, hvor hvert objekt repræsenterer den hentede tabelpost, der indeholder kolonner og deres værdier som key: value par. Tabelpostens id hentes som standard. nextLink: Streng. Hvis det antal poster, der hentes, er større end den værdi, der er angivet i maxPageSize parameteren i anmodningen, returnerer denne kolonne URL-adressen for at returnere det næste sæt poster.
errorCallback	Funktion	Nej	En funktion, der skal kaldes, når handlingen mislykkes.

Returværdi

Type: Promise<RetrieveMultipleResponse>

Beskrivelse: Returnerer RetrieveMultipleResponse et løfte, der indeholder en matrix af JSON-objekter, der indeholder de hentede tabelposter, og parameteren nextLink , hvor URL-adressen peger på det næste sæt poster, hvis sideinddeling (maxPageSize) er angivet i anmodningen, og det returnerede antal poster overskrider sideværdien. Den har følgende parametre:

parameter	Returværdi	Beskrivelse
Enheder	Entity[]	En matrix af JSON-objekter, hvor hvert objekt repræsenterer den hentede tabelpost, der indeholder kolonner og deres værdier.
nextLink	string	Hvis det antal poster, der hentes, er større end den værdi, der er angivet i parameteren 'maxPageSize' i anmodningen, returnerer denne parameter URL-adressen for at returnere det næste sæt poster.

Relaterede artikler

Web-API
API-reference til Power Apps Component Framework
Oversigt over Komponentstruktur i Power Apps