Comparteix via

retrieveMultipleRecords

Recupera una col·lecció de registres de taula.

Disponible per a

Aplicacions i portals basats en models.

Sintaxi

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

Paràmetres

Nom Tipus Necessari Descripció
entityLogicalName String Sí Nom lògic de la taula dels registres que voleu recuperar. Per exemple: "compte".
opcions String No

Opcions de consulta del sistema OData o consulta FetchXML per recuperar les dades.

  • S'admeten les opcions de consulta del sistema següents: $select, $top, $filter, $expand i $orderby.
  • Per especificar una consulta FetchXML, utilitzeu la fetchXml columna per especificar la consulta.

NOTA: Sempre heu d'utilitzar l'opció de consulta del sistema $select per limitar les propietats retornades per a un registre de taula incloent una llista separada per comes de noms de propietats. Limitar les columnes que recupereu és una pràctica recomanada de rendiment important. Si les propietats no s'especifiquen amb $select, es retornaran totes les propietats.

Especifiqueu les opcions de consulta que comencen per ?. També podeu especificar diverses opcions de consulta del sistema utilitzant & per separar les opcions de consulta.

maxPageSize Número No

Especifiqueu un nombre positiu que indiqui el nombre de registres de taula que s'han de retornar per pàgina. Si no especifiqueu aquest paràmetre, el valor per defecte es passa com a 5.000.

Si el nombre de registres que s'estan recuperant és superior al valor especificat maxPageSize , nextLink la columna de l'objecte de promesa retornat contindrà un enllaç per recuperar el següent conjunt de taules.

successDevolució de trucada Function No

Funció per cridar quan es recuperen registres de taula. Es passa un objecte amb les columnes següents a la funció:

  • entities: Una matriu d'objectes JSON, on cada objecte representa el registre de taula recuperat que conté columnes i els seus valors com a key: value parells. L'identificador del registre de taula es recupera per defecte.
  • següentEnllaç: Cadena. Si el nombre de registres que s'estan recuperant és superior al valor especificat al maxPageSize paràmetre de la sol·licitud, aquesta columna retorna l'adreça URL per retornar el següent conjunt de registres.
errorDevolució de trucada Function No Una funció per cridar quan l'operació falla.

Valor retornat

Tipus: Promise<RetrieveMultipleResponse>

Descripció: Retorna RetrieveMultipleResponse una promesa que conté una matriu d'objectes JSON que conté els registres de taula recuperats i el paràmetre nextLink amb l'adreça URL que apunta al següent conjunt de registres en cas que s'especifiqui paginació (maxPageSize) a la sol·licitud i el recompte de registres retornat superi el valor de paginació. Té els paràmetres següents:

paràmetre Valor retornat Descripció
Entitats Entity[] Una matriu d'objectes JSON, on cada objecte representa el registre de taula recuperat que conté columnes i els seus valors.
següentEnllaç string Si el nombre de registres que s'estan recuperant és superior al valor especificat al paràmetre "maxPageSize" de la sol·licitud, aquest paràmetre retorna l'adreça URL per retornar el següent conjunt de registres.

Web API
Referència de l'API del marc de components del Power Apps
Informació general del marc de components del Power Apps

  • Last updated on