Partilhar via

recuperarMultipleRecords

Recupera uma coleção de registros de tabela.

Disponível para

Aplicativos e portais orientados por modelos.

Sintaxe

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

Parâmetros

Nome Tipo Obrigatório Description
entityLogicalName String Yes O nome lógico da tabela dos registros que você deseja recuperar. Por exemplo: "conta".
options String Não

Opções de consulta do sistema OData ou consulta FetchXML para recuperar seus dados.

  • As seguintes opções de consulta do sistema são suportadas: $select, $top, $filter, $expand e $orderby.
  • Para especificar uma consulta FetchXML, use a fetchXml coluna para especificar a consulta.

Observação : você sempre deve usar a opção de consulta do sistema $select para limitar as propriedades retornadas para um registro de tabela incluindo uma lista separada por vírgulas de nomes de propriedade. Limitar as colunas recuperadas é uma prática recomendada de desempenho importante. Se as propriedades não forem especificadas usando $select, todas as propriedades serão retornadas.

Você especifica as opções de consulta começando com ?. Você também pode especificar várias opções de consulta do sistema usando & para separar as opções de consulta.

maxPageSize Número Não

Especifique um número positivo que indique o número de registros de tabela a serem retornados por página. Se você não especificar esse parâmetro, o valor padrão será passado como 5.000.

Se o número de registros que estão sendo recuperados for maior do que o valor especificado maxPageSize , nextLink a coluna no objeto promise retornado conterá um link para recuperar o próximo conjunto de tabelas.

successCallback Função Não

Uma função a ser chamada quando os registros de tabela são recuperados. Um objeto com as seguintes colunas é passado para a função:

  • entidades: uma matriz de objetos JSON, onde cada objeto representa o registro de tabela recuperado contendo colunas e seus valores como key: value pares. O Id do registro de tabela é recuperado por padrão.
  • nextLink: String. Se o número de registros que estão sendo recuperados for maior do que o valor especificado no maxPageSize parâmetro na solicitação, essa coluna retornará a URL para retornar o próximo conjunto de registros.
errorCallback Função Não Uma função para chamar quando a operação falhar.

Valor de retorno

Tipo: Promise<RetrieveMultipleResponse>

Descrição: O RetrieveMultipleResponse retorna uma promessa que contém uma matriz de objetos JSON contendo os registros de tabela recuperados e o parâmetro nextLink com a URL apontando para o próximo conjunto de registros caso a paginação (maxPageSize) seja especificada na solicitação e a contagem de registros retornada exceda o valor de paginação. Tem os seguintes parâmetros:

parâmetro Valor de retorno Description
entidades Entity[] Uma matriz de objetos JSON, onde cada objeto representa o registro de tabela recuperado contendo colunas e seus valores.
Próximo Link string Se o número de registros que estão sendo recuperados for maior do que o valor especificado no parâmetro 'maxPageSize' na solicitação, esse parâmetro retornará a URL para retornar o próximo conjunto de registros.

API Web
Referência da API da estrutura do componente Power Apps
Visão geral da estrutura do componente Power Apps

  • Last updated on