retrieveMultipleRecords

Regăsește o colecție de înregistrări de tabel.

Disponibil pentru

Aplicații bazate pe modele și portaluri.

Sintaxă

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

Parametri

Nume	Tip	Obligatoriu	Descriere
entityLogicalName	Șir	Da	Numele logic al tabelului pentru înregistrările pe care doriți să le regăsiți. De exemplu: "cont".
opțiuni	Șir	Nu	Opțiunile de interogare a sistemului OData sau interogarea PreluareXML pentru a regăsi datele. Sunt acceptate următoarele opțiuni de interogare de sistem: $select, $top, $filter, $expand și $orderby. Pentru a specifica o interogare FetchXML, utilizați fetchXml coloana pentru a specifica interogarea. NOTĂ: Trebuie să utilizați întotdeauna opțiunea de interogare de sistem $select pentru a limita proprietățile returnate pentru o înregistrare de tabel, incluzând o listă separată prin virgulă de nume de proprietăți. Limitarea coloanelor regăsite este o practică importantă de performanță. Dacă proprietățile nu sunt specificate utilizând $select, se vor returna toate proprietățile. Specificați opțiunile de interogare începând cu ?. De asemenea, puteți specifica mai multe opțiuni de interogare de sistem, utilizând & pentru a separa opțiunile de interogare.
maxPageSize	Număr	Nu	Specificați un număr pozitiv care indică numărul de înregistrări de tabel de returnat pe pagină. Dacă nu specificați acest parametru, valoarea implicită este trecută ca 5.000. Dacă numărul de înregistrări regăsite este mai mare decât valoarea specificată maxPageSize , nextLink coloana din obiectul promisiune returnat va conține un link pentru a regăsi următorul set de tabele.
succesApelare înapoi	Funcţie	Nu	O funcție de apelat atunci când sunt regăsite înregistrările tabelului. Un obiect cu următoarele coloane este transmis funcției: entități: O matrice de obiecte JSON, unde fiecare obiect reprezintă înregistrarea de tabel regăsită care conține coloane și valorile lor ca key: value perechi. ID-ul înregistrării tabelului este regăsit în mod implicit. nextLink: Șir. Dacă numărul de înregistrări regăsite este mai mare decât valoarea specificată în maxPageSize parametrul din solicitare, această coloană returnează URL-ul pentru a returna următorul set de înregistrări.
errorCallback	Funcţie	Nu	O funcție de apelat atunci când operațiunea eșuează.

Valoare returnată

Tip: Promise<RetrieveMultipleResponse>

Descriere: Returnează RetrieveMultipleResponse o promisiune care conține o matrice de obiecte JSON care conțin înregistrările de tabel regăsite și următorul parametruLink cu următorul set de înregistrări indicând spre următorul set de înregistrări în cazul în care paginarea (maxPageSize) este specificată în solicitare, iar numărul de înregistrări returnat depășește valoarea de paginare. Acesta are următorii parametri:

parametru	Valoare returnată	Descriere
Entităţi	Entity[]	Este o matrice de obiecte JSON, unde fiecare obiect reprezintă înregistrarea de tabel regăsită care conține coloane și valorile lor.
nextLink	string	Dacă numărul de înregistrări regăsite este mai mare decât valoarea specificată în parametrul "maxPageSize" din solicitare, acest parametru returnează URL-ul pentru a returna următorul set de înregistrări.

Articole asociate

Web API
Referință API cadru componentă Power Apps
Prezentare generală a cadrului componentei Power Apps