Função RecordInfo

Aplica-se a: Aplicativos de tela Aplicativos baseados em modelo

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.ReadPermission	O usuário atual tem permissão para ler este registro da fonte de dados?

RecordInfo retorna um valor booliano:

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

RecordInfo também leva em consideração as permissões no nível da fonte de dados. 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.