Função RecordInfo
Aplica-se a:
Aplicativos de tela Aplicativos controlados 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 retorna um valor booleano:
| Valor devolvido | Descrição |
|---|---|
| verdadeiro | O utilizador tem a permissão. |
| falso | O utilizador não tem a permissão. Se o registo estiver em branco, a RecordInfo também fará a devolução falso. |
O RecordInfo também leva em conta as permissões no nível 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(Record,Informação )
- Registro – Obrigatório. O registo para testar.
- Informação – Obrigató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.