Jagamisviis:


retrieveMultipleRecords

Toob tabelikirjete kogumi.

Saadaval:

Mudelipõhised rakendused ja portaalid.

Süntaks

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

Parameetrid

Nimetus Liik Nõutav Kirjeldus
olemuse loogiline nimi String Jah Toodavate kirjete tabeliloogiline nimi. Näiteks: "konto".
suvandid String Ei

OData süsteemipäringu suvandid või FetchXML-päring andmete toomiseks.

  • Toetatud on järgmised süsteemipäringusuvandid: $select, $top, $filter, $expand ja $orderby.
  • Päringu FetchXML määramiseks kasutage fetchXml päringu määramiseks veergu.

MÄRKUS. Tabelikirje tagastatavate atribuutide piiramiseks komaeraldusega atribuudinimede loendi kaasamisega peate alati kasutama süsteemipäringu suvandit $select . Toodavate veergude piiramine on oluline jõudluse hea tava. Kui atribuute pole $select abil määratud, tagastatakse kõik atribuudid.

Määrate päringusuvandid, mis algavad tähega ?. Samuti saate päringusuvandite eraldamiseks määrata mitu süsteemipäringu suvandit & .

maxPageSize Number Ei

Määrake positiivne arv, mis näitab lehel tagastatavate tabelikirjete arvu. Kui te seda parameetrit ei määra, edastatakse vaikeväärtus kujul 5000.

Kui toodavate kirjete arv on määratud maxPageSize väärtusest suurem, nextLink sisaldab tagastatava lubaduse objekti veerg linki järgmise tabelikomplekti toomiseks.

õnnestumineTagasihelistamine Function Ei

Funktsioon, mis helistab tabelikirjete toomisel. Funktsioonile edastatakse järgmiste veergudega objekt:

  • olemid: JSON-objektide massiiv, kus iga objekt tähistab toodud tabelikirjet, mis sisaldab veerge ja nende väärtusi paaridena key: value . Vaikimisi tuuakse tabelikirje ID.
  • nextLink: string. Kui toodavate kirjete arv on suurem kui taotluses parameetris maxPageSize määratud väärtus, tagastab see veerg URL-i järgmise kirjekomplekti tagastamiseks.
errorCallback Function Ei Funktsioon, mida kutsuda, kui toiming nurjub.

Tagastatav väärtus

Tüüp: Promise<RetrieveMultipleResponse>

Kirjeldus. Tagastab RetrieveMultipleResponse lubaduse, mis sisaldab JSON-objektide massiivi, mis sisaldab toodud tabelikirjeid, ja järgmist parameetritLink , mille URL osutab järgmisele kirjekomplektile juhul, kui taotluses on määratud saalimine (maxPageSize) ja tagastatud kirjete arv ületab saaleväärtuse. Sellel on järgmised parameetrid.

parameeter Tagastatav väärtus Kirjeldus
Üksused Entity[] JSON-objektide massiiv, kus iga objekt tähistab toodud tabelikirjet, mis sisaldab veerge ja nende väärtusi.
nextLink string Kui toodavate kirjete arv on suurem kui päringu parameetris maxPageSize määratud väärtus, tagastab see parameeter järgmise kirjekomplekti tagastamiseks URL-i.

Veebi API
Power Appsi komponendi raamistiku API viide
Power Appsi komponendi raamistiku ülevaade