Compartir por

Recuperar varios rexistros

Recupera unha colección de rexistros de táboas.

Dispoñible para

Aplicacións e portais baseados en modelos.

Sintaxe

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

Parámetros

Nome Tipo Obrigatorio Descrición
EntidadeNome Lóxico String Si Nome lóxico da táboa dos rexistros que desexa recuperar. Por exemplo: "conta".
opcións String Non

Opcións de consulta do sistema OData ou consulta FetchXML para recuperar os datos.

  • Soportan as seguintes opcións de consulta do sistema: $select, $top, $filter, $expand e $orderby.
  • Para especificar unha consulta FetchXML, use a fetchXml columna para especificar a consulta.

NOTA: Debe usar sempre a opción de consulta do sistema $select para limitar as propiedades devoltas para un rexistro de táboa incluíndo unha lista separada por comas de nomes de propiedades. Limitar as columnas que recuperas é unha boa práctica de rendemento importante. Se as propiedades non se especifican usando $select, todas as propiedades serán devoltas.

Especifica as opcións de consulta que comezan por ?. Tamén pode especificar varias opcións de consulta do sistema usando & para separar as opcións de consulta.

maxPageSize Número Non

Especifique un número positivo que indique o número de rexistros da táboa que se devolverán por páxina. Se non especifica este parámetro, o valor predeterminado pasa como 5.000.

Se o número de rexistros que se recuperan é maior que o valor especificado maxPageSize , nextLink a columna do obxecto de promesa devolto conterá unha ligazón para recuperar o seguinte conxunto de táboas.

éxitoChamada de volta Función Non

Función para chamar cando se recuperan os rexistros da táboa. Un obxecto coas seguintes columnas pasa á función:

  • entities: Un array de obxectos JSON, onde cada obxecto representa o rexistro da táboa recuperado que contén columnas e os seus valores como key: value pares. O ID do rexistro da táboa obtécese por defecto.
  • NextLink: String. Se o número de rexistros que se están a recuperar é maior que o valor especificado no maxPageSize parámetro da solicitude, esta columna devolve o URL para devolver o seguinte conxunto de rexistros.
erroChamada de volta Función Non Unha función a chamar cando a operación falla.

Valor devolto

Tipo: Promise<RetrieveMultipleResponse>

Descrición: Devolve RetrieveMultipleResponse unha promesa que contén unha matriz de obxectos JSON que contén os rexistros da táboa recuperados e o parámetro nextLink co URL que apunta ao seguinte conxunto de rexistros no caso de que se especifique a paginación (maxPageSize) na solicitude, e o número de rexistros devolto supere o valor de paginación. Ten os seguintes parámetros:

parámetro Valor devolto Descrición
Entidades Entity[] Un array de obxectos JSON, onde cada obxecto representa o rexistro da táboa recuperado que contén columnas e os seus valores.
Seguinte ligazón string Se o número de rexistros que se están a recuperar é maior que o valor especificado no parámetro 'maxPageSize' na solicitude, este parámetro devolve o URL para devolver o seguinte conxunto de rexistros.

Web API
Referencia da API do marco de compoñentes de Power Apps
Visión xeral do marco de compoñentes de Power Apps

  • Last updated on