Megosztás:

retrieveMultipleRecords

Táblarekordok gyűjteményét kéri le.

Elérhető a következőhöz:

Modellalapú alkalmazások > portálok.

Szemantika

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

Paraméterek

Név Típus Kötelező Description
entitásLogikai név Lánc Igen A lekérni kívánt rekordok tábla logikai neve. Például: "fiók".
options Lánc Nem

OData rendszerlekérdezési beállítások vagy FetchXML-lekérdezés az adatok lekéréséhez.

  • A következő rendszer-lekérdezési beállítások támogatottak: $select, $top, $filter, $expand és $orderby.
  • FetchXML-lekérdezés megadásához használja az fetchXml oszlopot a lekérdezés megadásához.

MEGJEGYZÉS: A táblarekordok visszaadott tulajdonságainak korlátozásához mindig a $select rendszer lekérdezési beállítását kell használnia a tulajdonságnevek vesszővel tagolt listájával. A lekért oszlopok korlátozása fontos teljesítménybeli ajánlott eljárás. Ha a tulajdonságok nincsenek megadva $select használatával, a rendszer minden tulajdonságot visszaad.

A lekérdezési beállításokat a következővel ?kezdheti meg: . A lekérdezési beállítások elválasztásával & több rendszer-lekérdezési beállítást is megadhat.

maxPageSize Szám Nem

Adjon meg egy pozitív számot, amely az oldalanként visszaadandó táblarekordok számát jelzi. Ha nem adja meg ezt a paramétert, az alapértelmezett érték 5000 lesz.

Ha a lekért rekordok száma meghaladja a megadott maxPageSize értéket, nextLink a visszaadott ígéret objektum oszlopa tartalmaz egy hivatkozást a következő táblakészlet lekéréséhez.

sikerVisszahívás Funkció Nem

A táblarekordok lekérésekor meghívandó függvény. A függvény a következő oszlopokkal rendelkező objektumot továbbítja a függvénynek:

  • entitások: JSON-objektumok tömbje, ahol minden objektum az oszlopokat és értékeiket párként key: value tartalmazó beolvasott táblarekordot jelöli. A rendszer alapértelmezés szerint lekéri a táblarekord azonosítóját.
  • nextLink: Sztring. Ha a lekért rekordok száma meghaladja a kérelem paraméterében maxPageSize megadott értéket, ez az oszlop az URL-címet adja vissza a következő rekordkészlet visszaadásához.
errorCallback Funkció Nem A művelet sikertelensége esetén meghívandó függvény.

Visszaadott érték

Típus: Promise<RetrieveMultipleResponse>

Leírás: A RetrieveMultipleResponse visszaadott ígéret olyan JSON-objektumokat tartalmazó tömböt ad vissza, amely tartalmazza a lekért táblarekordokat és a nextLink paramétert a következő rekordkészletre mutató URL-címmel abban az esetben, ha a kérelemben a lapozás (maxPageSize) meg van adva, és a visszaadott rekordszám meghaladja a lapozási értéket. A következő paraméterekkel rendelkezik:

paraméter Visszaadott érték Description
entitások Entity[] JSON-objektumok tömbje, ahol minden objektum oszlopokat és értékeket tartalmazó beolvasott táblarekordot jelöl.
nextLink string Ha a lekért rekordok száma meghaladja a kérelem "maxPageSize" paraméterében megadott értéket, ez a paraméter visszaadja az URL-címet a következő rekordkészlet visszaadásához.

Webes API
Power Apps-összetevő-keretrendszer API-referenciája
A Power Apps összetevő-keretrendszerének áttekintése

  • Last updated on