Dela via

retrieveMultipleRecords

Hämtar en samling tabellposter.

Tillgänglig för

Modelldrivna appar och portaler.

Syntax

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

Parameterar

Namn Typ Krävs Description
entityLogicalName String Yes Det logiska tabellnamnet för de poster som du vill hämta. Till exempel: "konto".
options String Nej

OData-systemfrågealternativ eller FetchXML-fråga för att hämta dina data.

  • Följande systemfrågealternativ stöds: $select, $top, $filter, $expand och $orderby.
  • Om du vill ange en FetchXML-fråga använder du fetchXml kolumnen för att ange frågan.

Obs! Du måste alltid använda alternativet $select systemfråga för att begränsa egenskaperna som returneras för en tabellpost genom att inkludera en kommaavgränsad lista med egenskapsnamn. Det är viktigt att begränsa de kolumner som du hämtar. Om egenskaper inte anges med $select returneras alla egenskaper.

Du anger frågealternativ som börjar med ?. Du kan också ange flera systemfrågealternativ genom att använda & för att avgränsa frågealternativen.

maxPageSize Nummer Nej

Ange ett positivt tal som anger antalet tabellposter som ska returneras per sida. Om du inte anger den här parametern skickas standardvärdet som 5 000.

Om antalet poster som hämtas är större än det angivna maxPageSize värdet innehåller nextLink kolumnen i det returnerade promise-objektet en länk för att hämta nästa uppsättning tabeller.

framgångCallback Funktion Nej

En funktion som ska anropas när tabellposter hämtas. Ett objekt med följande kolumner skickas till funktionen:

  • entiteter: En matris med JSON-objekt, där varje objekt representerar den hämtade tabellposten som innehåller kolumner och deras värden som key: value par. ID:t för tabellposten hämtas som standard.
  • nextLink: Sträng. Om antalet poster som hämtas är mer än det värde som anges i parametern maxPageSize i begäran returnerar den här kolumnen URL:en för att returnera nästa uppsättning poster.
errorCallback Funktion Nej En funktion som ska anropas när åtgärden misslyckas.

Returvärde

Typ: Promise<RetrieveMultipleResponse>

Beskrivning: Returnerar RetrieveMultipleResponse ett löfte som innehåller en matris med JSON-objekt som innehåller de hämtade tabellposterna och parametern nextLink med URL:en som pekar på nästa uppsättning poster om växling (maxPageSize) anges i begäran och antalet returnerade poster överskrider växlingsvärdet. Den har följande parametrar:

parameter Returvärde Description
entities Entity[] En matris med JSON-objekt, där varje objekt representerar den hämtade tabellposten som innehåller kolumner och deras värden.
nextLink string Om antalet poster som hämtas är mer än det värde som anges i parametern "maxPageSize" i begäran returnerar den här parametern URL:en för att returnera nästa uppsättning poster.

Webb-API
Api-referens för Power Apps-komponentramverket
Översikt över Power Apps-komponentramverk

  • Last updated on