Ler em inglês

Compartilhar via


Usar o Power Fx no Power Pages (versão preliminar)

[Este tópico faz parte da documentação de pré-lançamento e está sujeito a alterações.]

O Power Fx é o idioma low-code para expressar lógica no Microsoft Power Platform. É uma linguagem de programação de uso geral, fortemente tipada, declarativa e funcional.

Power Fx é expresso em texto de fácil leitura. É uma linguagem low-code com a qual os criadores podem trabalhar diretamente em uma barra de fórmulas semelhante ao Excel. O "pouco" no pouco código é devido à natureza concisa e simples da linguagem, tornando as tarefas de programação comuns fáceis para criadores e desenvolvedores.

Observação

Você pode achar a sintaxe da fórmula de criação do Power Fx um pouco diferente daquela com a qual você está acostumado no Power Apps ou no Power Automate. Para iniciar uma expressão do Power Fx, ela deve começar com um '=' (sinal de igual), como no Excel. Para obter mais informações, consulte Considerações importantes.

O Power Fx permite todo o espectro de desenvolvimento, desde criadores sem código, sem conhecimento de programação, até pro-code para desenvolvedores profissionais. Ele facilita a colaboração entre diversas equipes, ajudando-as a economizar tempo e esforço.

Importante

  • Este é um recurso em versão preliminar.
  • Os recursos de versão preliminar não foram criados para uso em ambientes de produção e podem ter funcionalidade restrita. Esses recursos são disponibilizados antes de um lançamento oficial para que os clientes possam ter acesso antecipado e forneçam comentários.
  • O recurso está disponível com a versão do Power Pages 9.6.5.x.

Usar Power Fx no Power Pages

Dentro de um site do Power Pages, o Power Fx está disponível como uma linguagem de expressão para uso com os seguintes componentes e seus atributos. Essa funcionalidade permite a atribuição dinâmica de valores com base nos resultados das expressões do Power Fx.

Componente Propriedades
Texto Texto
Image URL da Imagem, Texto Alternativo
Button URL do Botão, Texto do botão
Iframe URL do Iframe

Usar a barra de fórmula do Power Fx

A barra de ferramentas inclui um novo comando fx para componentes que suportam o Power Fx:

Captura de tela do comando do Power Fx na barra de comandos de um controle de texto.

Selecione fx para acessar a barra de fórmulas do Power Fx.

Componentes da barra de fórmulas

A captura de tela a seguir destaca alguns dos componentes importantes da barra de fórmulas:

Captura de tela da barra de fórmulas do Power Fx no Power Pages.

  1. Um menu suspenso permite que você escolha entre as propriedades de componente disponíveis.

  2. Uma caixa de texto expansível de várias linhas permite a criação de fórmulas do Power Fx.

  3. O botão Redefinir define uma propriedade de componente como padrão.

  4. O botão Salvar mantém a fórmula e as expressões da propriedade do componente. A tela do estúdio será atualizada imediatamente, se o valor resultante estiver disponível e puder ser mostrado como nas propriedades de texto.

Experiências da barra de fórmulas

A seguir estão alguns recursos centrados no desenvolvedor para aumentar a produtividade:

  • Assistência de preenchimento automático: sugere fórmulas, parâmetros, tabelas e objetos. Selecione Ctrl + espaço para acessar manualmente esse recurso.

    Captura de tela da experiência de preenchimento automático no Power Fx.

  • Exibir capacidade do problema: ajuda na validação e depuração antecipadas de fórmulas e expressões.

    Captura de tela da experiência quando um problema é detectado em uma fórmula do Power Fx.

  • Caixa de diálogo Alterações não salvas: é exibida se você sair da barra de fórmulas quando houver alterações não salvas em uma fórmula.

    Captura de tela da caixa de diálogo de alterações não salvas com opções para Voltar ou Descartar.

    Selecione Voltar para continuar editando a fórmula ou Descartar para descartar as alterações.

Considerações importantes

Considere as seguintes diretrizes ao usar a barra de fórmulas do Power Fx no Power Pages:

  • Comece com um sinal de igual: o texto pode ser inserido diretamente como o valor. Para iniciar uma expressão do Power Fx, ela deve começar com um '=' (sinal de igual), como no exemplo a seguir.

    =Concatenate("Hello, ", User.FullName)
    
  • As tabelas são acessadas com segurança: as tabelas do Dataverse podem ser acessadas com segurança usando fórmulas. Verifique primeiro se as permissões da tabela estão configuradas adequadamente. Além disso, o contexto de um usuário do site está disponível usando o objeto Usuário. Por exemplo, a expressão a seguir recupera o valor DataverseUserId do usuário autenticado no momento.

    =Concatenate("Hello, ", First(Filter(Contacts,Contact = User.DataverseUserId)).'First Name' & "!")
    

    Observação

    O objeto Usuário representa um usuário do Power Pages e, portanto, não oferece suporte ao mesmo conjunto de propriedades que a função Usuário.

  • Inserindo um valor no texto: para inserir um valor no texto, use a sintaxe a seguir.

    This text ${variable/ expression} includes a dynamic value.
    

    Por exemplo:

    The total number is ${Sum(10, 20)}
    

Funções do Power Fx disponíveis

Para obter uma lista completa de todas as funções no Power Pages, vá para Referência da fórmula – Power Pages.

Limitações e problemas conhecidos

  • Algumas funções do Power Fx apresentadas por meio do IntelliSense não têm suporte no Power Pages no momento. Essas funções exibem o seguinte erro de tempo de design quando usadas:

    Parameter 'Value': PowerFx type is not supported.

  • O sistema não inicializa o Usuário para usuários anônimos, o que gera o seguinte erro ao utilizá-lo em qualquer formulário, incluindo na verificação de espaços em branco. Este problema será corrigido em uma versão futura.

    UserInfo object was not added to service

  • Alguns usuários podem ver problemas com as propriedades de URL de Botão e Imagem não funcionando quando o valor é definido com fórmulas ou expressões do Power Fx que contêm aspas duplas. Esse problema só acontece se você tiver a versão 9.6.3.x e for corrigido quando seu site do Power Pages for atualizado para a versão 9.6.5.x.

Perguntas frequentes

Devo usar o Power Fx, em vez do Liquid?

O Power Fx atende a determinados cenários de dados dinâmicos de uma maneira com low-code que também pode ser alcançada por meio de código do Liquid com ferramentas para desenvolvedores profissionais. O Power Fx, atualmente em sua fase de versão preliminar pública, é recomendado para avaliações do local de teste ou desenvolvimento. Agradecemos seus comentários durante esta fase. O Liquid é um recurso GA (disponível ao público) e comparativamente fornece mais recursos. Use o Liquid para seus sites de produção, especialmente em cenários críticos e complexos.

Ver também