Dalīties caur

izgūtVairāki ieraksti

Izgūst tabulas ierakstu kolekciju.

Pieejams

Modeļa vadītas programmas un portāli.

Sintakse

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

Parametrus

Vārds Tips Obligāti Apraksts
entityLogicalName String Jā Izgūstamo ierakstu tabulas loģiskais nosaukums. Piemēram: "konts".
Opcijas String Nē.

OData sistēmas vaicājuma opcijas vai FetchXML vaicājums, lai izgūtu datus.

  • Tiek atbalstītas šādas sistēmas vaicājumu opcijas: $select, $top, $filter, $expand un $orderby.
  • Lai norādītu FetchXML vaicājumu, izmantojiet fetchXml kolonnu, lai norādītu vaicājumu.

PIEZĪME: Vienmēr jāizmanto $select sistēmas vaicājuma opcija, lai ierobežotu tabulas ierakstam atgrieztos rekvizītus, iekļaujot ar komatiem atdalītu rekvizītu nosaukumu sarakstu. Izgūstamo kolonnu ierobežošana ir svarīga veiktspējas paraugprakse. Ja rekvizīti nav norādīti, izmantojot $select, tiks atgriezti visi rekvizīti.

Vaicājuma opcijas jānorāda ar ?. Varat arī norādīt vairākas sistēmas vaicājuma opcijas, izmantojot & vaicājuma opciju atdalīšanu.

maxPageSize Numurs Nē.

Norādiet pozitīvu skaitli, kas norāda tabulas ierakstu skaitu, kas jāatgriež vienā lappusē. Ja nenorādāt šo parametru, noklusējuma vērtība tiek nodota kā 5 000.

Ja izgūstamo ierakstu skaits ir lielāks par norādīto maxPageSize vērtību, atgrieztā solījuma objekta kolonnā būs saite, nextLink lai izgūtu nākamo tabulu kopu.

panākumsAtzvanīšana Funkcija Nē.

Funkcija, kas jāizsauc, kad tiek izgūti tabulas ieraksti. Funkcijai tiek nodots objekts ar šādām kolonnām:

  • entītijas: JSON objektu masīvs, kur katrs objekts attēlo izgūto tabulas ierakstu, kas satur kolonnas un to vērtības kā key: value pārus. Tabulas ieraksta ID tiek izgūts pēc noklusējuma.
  • nextLink: virkne. Ja izgūstamo ierakstu skaits ir lielāks par pieprasījuma parametrā maxPageSize norādīto vērtību, šī kolonna atgriež URL, lai atgrieztu nākamo ierakstu kopu.
kļūdaAtzvanīšana Funkcija Nē. Funkcija, kas jāizsauc, ja operācija neizdodas.

Atgrieztā vērtība

Tips: Promise<RetrieveMultipleResponse>

Apraksts: atgriež RetrieveMultipleResponse solījumu, kas satur JSON objektu masīvu, kas satur izgūtos tabulas ierakstus un parametru nextLink ar URL, kas norāda uz nākamo ierakstu kopu, ja pieprasījumā ir norādīta peidžeru (maxPageSize) un atgrieztais ierakstu skaits pārsniedz peidžeru vērtību. Tam ir šādi parametri:

parametrs Atgrieztā vērtība Apraksts
Vienības Entity[] JSON objektu masīvs, kur katrs objekts attēlo izgūto tabulas ierakstu, kas satur kolonnas un to vērtības.
nākamaisSaite string Ja izgūstamo ierakstu skaits ir lielāks par pieprasījuma parametrā 'maxPageSize' norādīto vērtību, šis parametrs atgriež URL, lai atgrieztu nākamo ierakstu kopu.

Tīmekļa API
Power Apps komponentu struktūras API atsauce
Power Apps komponentu struktūras pārskats

  • Last updated on