Compartilhar via

Função RecordInfo

  • Artigo

Aplica-se a: Aplicativos Canvas Aplicativos baseados em modelos

Fornece informações sobre um registro de uma fonte de dados.

Use RecordInfo para obter informações sobre um determinado registro de uma fonte de dados. A fonte de dados deve ser tabular e compatível com as funções Remove e Patch.

No momento, apenas o Microsoft Dataverse é compatível. Os registros de todas as outras fontes de dados resultarão em um erro de fórmula.

As informações disponíveis:

Argumento de Informações Descrição
RecordInfo.DeletePermission O usuário atual tem permissão para remover este registro da fonte de dados?
RecordInfo.EditPermission O usuário atual tem permissão para modificar este registro na fonte de dados?
RecordInfo.Permissão de Leitura O usuário atual tem permissão para ler este registro da fonte de dados?

RecordInfo retorna um valor booliano:

Retornar valor Descrição
verdadeiro O usuário tem permissão.
falso O usuário não tem permissão. Se o registro estiver em branco, RecordInfo também retornará false.

RecordInfo leva em consideração permissões no nível fonte de dados também. Por exemplo, se o usuário tiver permissão no nível do registro para modificar um registro, mas não tiver permissão no nível da tabela, ele retornará false para ModifyPermission. Use a função DataSourceInfo para obter informações sobre a fonte de dados como um todo.

Sintaxe

RecordInfo( Registro, Informações )

  • Registro – Obrigatório. O registro a ser testado.
  • Informações – Obrigatório. As informações desejadas para o registro.

Exemplos

RecordInfo( First(Accounts), RecordInfo.EditPermission )

Verifica a permissão de edição para o primeiro registro na fonte de dados Accounts, que poderia estar no Dataverse, no SharePoint, no SQL Server ou em outra fonte de dados tabular. Se o usuário tiver permissão para editar este registro e modificar a fonte de dados Accounts em geral, RecordInfo retornará true.

With( { MyRecord: First( Accounts ) },
      RecordInfo( MyRecord, RecordInfo.EditPermission ) )

Captura um registro usando a função With e, em seguida, transfere esse valor para a função RecordInfo. O resultado será o mesmo do último exemplo.

Collect( MyAccounts, FirstN( Accounts, 10 ) );
RecordInfo( First( MyAccounts ), RecordInfo.EditPermission ) )

Captura os primeiros 10 registros da fonte de dados Accounts na coleção MyAccounts. Uma vez que os registros se originaram de uma fonte de dados, eles podem ser usados com a função RecordInfo. O resultado será o mesmo do último exemplo.

Collect( MyCollection, [ 1, 2, 3 ] );
RecordInfo( First(MyCollection), RecordInfo.DeletePermission )

Cria a coleção MyCollection e testa o primeiro registro para determinar se ele pode ser removido. Como a origem do registro é uma coleção e não uma fonte de dados, RecordInfo retornará um erro.