Partilhar via

Função RecordInfo

  • Artigo

Aplica-se a: Aplicações de tela Aplicações condicionadas por modelo

Fornece informações sobre um registo de uma origem de dados.

Utilize a RecordInfo para obter informações sobre um registo específico de uma origem de dados. A origem de dados deve ser tabular e compatível com as funções Remove e Patch.

Nesta altura, apenas é suportado o Microsoft Dataverse. Registos de todas as outras origens de dados resultarão num erro de fórmula.

As informações disponíveis:

Argumento de informações Descrição
RecordInfo.DeletePermission O utilizador atual tem permissão para remover este registo da origem de dados?
RecordInfo.EditPermission O utilizador atual tem permissão para modificar este registo na origem de dados?
RecordInfo.ReadPermission O utilizador atual tem permissão para ler este registo da origem de dados?

RecordInfo devolve um valor booleano:

Valor devolvido Descrição
verdadeiro O utilizador tem a permissão.
false O utilizador não tem a permissão. Se o registo estiver em branco, a RecordInfo também fará a devolução falso.

RecordInfo também tem em conta permissões ao nível da origem de dados. Por exemplo, se o utilizador tiver permissão a nível de gravação para modificar um registo, mas o utilizador não tiver permissões ao nível da tabela, então irá devolver falso para ModifyPermission. Use a função DataSourceInfo para obter informações sobre uma origem de dados como um todo.

Sintaxe

RecordInfo( Registo, Informações )

  • Record – Obrigatório. O registo para testar.
  • Informações – Necessário. A informação desejada para o registo.

Exemplos

RecordInfo( First(Accounts), RecordInfo.EditPermission )

Verifica a permissão de editar para o primeiro registo na origem de dados Accounts, que pode estar em Dataverse, SharePoint, SQL Server, oun outra origem de dados tabular. Se o utilizador tiver permissão para editar este registo e modificar a origem de dados Accounts em geral, então a RecordInfo devolverá verdadeiro.

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

Captura um registo utilizando a função With e, em seguida, passa este valor para a função RecordInfo. O resultado será igual ao do último exemplo.

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

Captura os primeiros 10 registos da origem de dados Accounts para a coleção MyAccounts. Uma vez que os registos são originários de uma origem de dados, podem ser utilizados com a função RecordInfo. O resultado será igual ao do último exemplo.

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

Cria a coleção MyCollection e testa o primeiro registo para determinar se pode ser removido. Uma vez que a origem do disco é uma coleção e não uma origem de dados, a RecordInfo devolverá um erro.