Compartilhar via

retrieveRecord

Recupera um registro de tabela.

Disponível para

Aplicativos baseados em modelos e portais.

Sintaxe

context.webAPI.retrieveRecord(entityLogicalName, id, options).then(successCallback, errorCallback);

Parâmetros

Nome Tipo Obrigatório Description
entityLogicalName String Yes O nome lógico da tabela do registro que você deseja recuperar. Por exemplo: "conta".
id String Yes GUID do registro de tabela que você deseja recuperar.
opções String Não

Opções de consulta do sistema OData, $select e $expand, para recuperar seus dados.

  • Use a opção de consulta do sistema $select para limitar as propriedades retornadas, incluindo uma lista separada por vírgulas de nomes de propriedade. Limitar as colunas que você recupera é uma prática recomendada de desempenho importante. Se as propriedades não forem especificadas usando $select, todas as propriedades serão retornadas.
  • Use a opção de consulta do sistema $expand para controlar quais dados de tabelas relacionadas são retornados. Se você incluir apenas o nome da propriedade de navegação, receberá todas as propriedades para registros relacionados. Você pode limitar as propriedades retornadas para registros relacionados usando a opção de consulta do sistema $select entre parênteses após o nome da propriedade de navegação. Use isso para propriedades de navegação de valor único e com valor de coleção .

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

?$select=name&$expand=primarycontactid($select=contactid,fullname)
sucessoRetorno de chamada Função Não

Uma função a ser chamada quando um registro é recuperado. Um objeto JSON com as propriedades e valores recuperados será passado para a função.
erroRetorno de chamada Função Não Uma função a ser chamada quando a operação falhar.

Valor de retorno

Tipo: Promise<Entity>

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

  • Last updated on