Bendrinti naudojant


retrieveMultipleRecords

Nuskaito lentelės įrašų rinkinį.

Galima naudoti

Modeliu pagrįstos programėlės ir portalai.

Sintaksė

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

Parametrus

Vardas Rūšis Privalomas Aprašą
entityLogicalName String Taip Lentelės loginis norimų gauti įrašų pavadinimas. Pavyzdžiui: "sąskaita".
Parinktys String Ne

"OData" sistemos užklausos parinktys arba "FetchXML" užklausa jūsų duomenims gauti.

  • Palaikomos šios sistemos užklausų parinktys: $select, $top, $filter, $expand ir $orderby.
  • Norėdami nurodyti FetchXML užklausą, naudokite fetchXml stulpelį užklausai nurodyti.

PASTABA: visada turite naudoti $select sistemos užklausos parinktį, kad apribotumėte pateiktas lentelės įrašo ypatybes, įtraukdami kableliais atskirtų ypatybių pavadinimų sąrašą. Jūsų nuskaitomų stulpelių ribojimas yra svarbi geriausia veikimo praktika. Jei ypatybės nenurodytos naudojant $select, bus grąžintos visos ypatybės.

Užklausos pasirinktis galite nurodyti pradėdami nuo ?. Taip pat galite nurodyti kelias sistemos užklausos parinktis, atskirdami & užklausos parinktis.

maxPageSize Skaičius Ne

Nurodykite teigiamą skaičių, nurodantį, kiek lentelės įrašų turi būti pateikta puslapyje. Jei nenurodysite šio parametro, numatytoji reikšmė bus perduota kaip 5 000.

Jei nuskaitomų įrašų skaičius yra didesnis nei nurodyta maxPageSize reikšmė, nextLink grąžinamo pažado objekto stulpelyje bus saitas, skirtas kitam lentelių rinkiniui gauti.

sėkmėAtgalinis skambutis Funkcija Ne

Funkcija, iškviečiama, kai nuskaitomi lentelės įrašai. Funkcijai perduodamas objektas su šiais stulpeliais:

  • objektai: JSON objektų masyvas, kuriame kiekvienas objektas nurodo nuskaitytą lentelės įrašą, kuriame yra stulpelių, o jų reikšmės – kaip key: value poros. Lentelės įrašo ID nuskaitomas pagal numatytuosius parametrus.
  • nextLink: Eilutė. Jei nuskaitomų įrašų skaičius yra didesnis nei reikšmė, maxPageSize nurodyta užklausos parametre, šis stulpelis pateikia URL, kad būtų pateiktas kitas įrašų rinkinys.
errorCallback Funkcija Ne Funkcija, kurią reikia iškviesti, kai operacija nepavyksta.

Grąžinama reikšmė

Tipas: Promise<RetrieveMultipleResponse>

Aprašas: Pateikia RetrieveMultipleResponse pažadą, kuriame yra JSON objektų masyvas, kuriame yra nuskaityti lentelės įrašai ir parametras NextLink , kurio URL nurodo kitą įrašų rinkinį, jei užklausoje nurodytas puslapių kaitos (maxPageSize) parametras, o grąžintas įrašų skaičius viršija puslapių kaitos reikšmę. Ji turi šiuos parametrus:

parametras Grąžinama reikšmė Aprašą
Subjektai Entity[] JSON objektų masyvas, kuriame kiekvienas objektas nurodo nuskaitytą lentelės įrašą, kuriame yra stulpelių ir jų reikšmių.
nextLink string Jei nuskaitomų įrašų skaičius yra didesnis nei reikšmė, nurodyta užklausos parametre "maxPageSize", šis parametras grąžina URL, kad būtų pateiktas kitas įrašų rinkinys.

Žiniatinklio API
"Power Apps" komponento sistemos API nuoroda
"Power Apps" komponentų sistemos apžvalga