Partilhar via


retrieveRecord

Recupera um registro de tabela.

Disponível para

Aplicativos e portais orientados por modelos.

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.
options String Não

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

  • Use a opção $select consulta do sistema para limitar as propriedades retornadas incluindo uma lista separada por vírgulas de nomes de propriedades. 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.
  • Use a opção $expand consulta do sistema 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 dos registros relacionados. Você pode limitar as propriedades retornadas para registros relacionados usando a opção $select consulta do sistema entre parênteses após o nome da propriedade de navegação. Use isso para propriedades de navegação com 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)
successCallback Função Não

Uma função para chamar quando um registro é recuperado. Um objeto JSON com as propriedades e valores recuperados será passado para a função.

errorCallback Função Não Uma função para chamar quando a operação falhar.

Valor de retorno

Tipo: Entidade Promise<>

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