Partekatu bidez


eskuratu erregistro anitzak

Taulako erregistroen bilduma bat eskuratzen du.

Horretarako erabilgarri

Model-driven aplikazioak eta atariak.

Sintaxia

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

Parametroak

Izena Mota Beharrezkoa Deskribapenak
entityLogicalName String Bai Eskuratu nahi dituzun erregistroen taularen izen logikoa. Adibidez: "cuenta".
aukerak String Ez

OData sistemaren kontsulta-aukerak edo FetchXML kontsulta datuak eskuratzeko.

  • Sistemaren kontsulta aukera hauek onartzen dira: $select, $top, $filter, $expand eta $orderby.
  • FetchXML kontsulta zehazteko, erabili zutabea fetchXml kontsulta zehazteko.

OHARRA: Sistemaren kontsulta $select aukera erabili behar duzu beti taulako erregistro baterako itzulitako propietateak mugatzeko, komaz bereizitako propietate-izenen zerrenda bat sartuta. Berreskuratzen dituzun zutabeak mugatzea errendimendu-praktika garrantzitsua da. Propietateak $select erabiliz zehazten ez badira, propietate guztiak itzuliko dira.

Zehaztu zein aukera dauden ?kontsultatzeko. Sistemaren kontsulta-aukera & anitz ere zehaztu ditzakezu kontsulta-aukerak bereizteko.

maxPageSize Zenbakia Ez

Zehaztu orrialde bakoitzeko itzuliko diren taulako erregistro kopurua adierazten duen zenbaki positiboa. Parametro hau zehazten ez baduzu, balio lehenetsia 5.000 gisa pasatuko da.

Berreskuratzen ari diren erregistroen kopurua zehaztutako maxPageSize balioa baino handiagoa bada, nextLink itzulitako promesa objektuko zutabeak esteka bat izango du hurrengo taula multzoa eskuratzeko.

successCallback Function Ez

Taulako erregistroak eskuratzean deitu beharreko funtzioa. Honako zutabe hauek dituen objektu bat pasatzen zaio funtzioari:

  • entitateak: JSON objektuen matrize bat, non objektu bakoitzak berreskuratutako taulako erregistroa adierazten duen, zutabeak eta haien balioak bikote gisa key: value . Taulako erregistroaren IDa lehenespenez eskuratzen da.
  • NextLink: Katea. Berreskuratzen ari diren erregistroen kopurua eskaeraren parametroan maxPageSize zehaztutako balioa baino handiagoa bada, zutabe honek URLa itzultzen du hurrengo erregistro-multzoa itzultzeko.
errorCallback Function Ez Eragiketan akats bat gertatzen denean deitzen zaion funtzioa.

Itzuli balioa

Mota: Promise<RetrieveMultipleResponse>

Deskribapena: Berreskuratutako RetrieveMultipleResponse taulako erregistroak eta nextLink parametroa dituen JSON objektuen matrize bat duen promesa bat itzultzen du, URLak hurrengo erregistro-multzoa seinalatzen duelarik, eskaeran paging (maxPageSize) zehazten bada eta itzulitako erregistro kopuruak paging-balioa gainditzen badu. Ondorengo parametroak ditu:

parametro Itzuli balioa Deskribapenak
entitateak Entity[] JSON objektuen matrize bat, non objektu bakoitzak berreskuratutako taulako erregistroa adierazten duen, zutabeak eta haien balioak dituena.
Hurrengoa-esteka string Berreskuratzen ari diren erregistroen kopurua eskaeran 'maxPageSize' parametroan zehaztutako balioa baino handiagoa bada, parametro honek hurrengo erregistro-multzoa itzultzeko URLa itzultzen du.

API webgunea
Power Apps-en osagaien esparruaren APIaren erreferentzia
Power Apps-en osagaien esparruaren ikuspegi orokorra