Cenário: usar fonte de dados e informações de registro
Os botões da barra de comandos sempre são mostrados por padrão na barra de comandos. Em alguns casos, não é viável executar a ação do botão. É possível controlar a visibilidade usando a lógica do Power Fx. Você pode usar o Power Fx para verificações condicionais em relação às informações do ambiente de runtime e os dados selecionados. Por exemplo, você poderá ocultar o botão quando um usuário criar uma nova linha ou se uma linha de dados tiver um valor específico. Você também pode verificar as permissões do usuário para garantir que não está oferecendo uma ação que ele não pode executar.
Há duas opções para verificar permissões para o usuário do aplicativo. Você pode usar a função DataSourceInfo para verificar amplamente as permissões na tabela no nível da fonte de dados. Essa abordagem é adequada se você pretende criar uma nova linha na ação e garantir que o usuário possa concluir a ação. DataSourceInfo não tem um contexto de linha de dados, portanto, não pode determinar se você pode atualizar uma linha específica. Por exemplo, você poderá criar uma nova linha pertencente ao usuário, mas não poderá atualizar uma linha pertencente a outro usuário. Para verificar permissões de um usuário específico, você pode usar a função RecordInfo. Essa função requer uma referência a uma linha de dados e verifica a permissão do usuário nesse contexto.
O vídeo a seguir demonstrará como usar o DataSourceInfo para melhorar a experiência do usuário de uma ação da barra de comandos.
Observação
Você pode aumentar a resolução de vídeo selecionando os três pontos, Qualidade e selecionando uma taxa de bits mais alta.
Além de ser útil na verificação de permissões, a função DataSourceInfo também fornece outras informações valiosas sobre as colunas da fonte de dados. Essas informações podem ser úteis ao redigir expressões do Power Fx da barra de comandos, de forma que não contenham valores sujeitos a alterações. Por exemplo, execute a seguinte função Notify que especifica o nome da coluna como literal.
Notify("Invalid value for Name")
O Dataverse permite alterar o nome de exibição das colunas da tabela; nesse exemplo, se o nome tiver sido alterado para "nome do produto", a mensagem ainda será exibida como "nome". Usando a fórmula a seguir, que chama a função DataSourceInfo, será exibido o nome de coluna adequado, sem que seja preciso alterar a expressão.
Notify("Invalid value for " & DataSourceInfo(Products,DataSourceInfo.DisplayName,"sample_name")
A função DataSourceInfo poderá fornecer outros valores úteis, como os valores mín./máx., se a coluna for necessária e o tamanho máximo for permitido.
O uso de DataSourceInfo e RecordInfo pode melhorar a experiência de usuários que interagem com suas personalizações da barra de comandos.