Ler em inglês

Partilhar via


Utilizar o Power Fx no Power Pages (pré-visualização)

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

Power Fx é a linguagem low-code para expressar a lógica em todo o Microsoft Power Platform. É uma linguagem de programação funcional de fins gerais, de tipo forte e declarativa.

O Power Fx é expresso em texto simples. Trata-se de uma linguagem low-code que os criadores podem fazer funcionar diretamente numa barra de fórmulas semelhante à do Excel. O termo "pouco" na expressão de pouco código significa que é uma linguagem de natureza concisa e simples, o que facilita as tarefas de programação comuns para criadores e programadores.

Nota

Poderá achar que a sintaxe de criação da fórmula do Power Fx é diferente daquela a que está habituado no Power Apps ou no Power Automate. Para iniciar uma expressão do Power Fx, esta deve começar por um "=" (sinal de igual), como no Excel. Para mais informações, consulte Considerações importantes.

O Power Fx permite todo o espectro de desenvolvimento, desde criadores sem necessidade de código e sem qualquer conhecimento de programação até código profissional para programadores profissionais. Facilita a colaboração entre equipas diversas, ajudando-as a poupar tempo e esforço.

Importante

  • Esta é uma funcionalidade de pré-visualização.
  • As caraterísticas de pré-visualização não se destinam à produção e poderão ter caraterísticas restritas. Estas caraterísticas estão disponíveis antes do lançamento oficial, para que os clientes possam ter acesso antecipado e enviar comentários.
  • A funcionalidade está disponível na versão 9.6.5.x do Power Pages.

Utilizar o Power Fx no Power Pages

Num site do Power Pages, o Power Fx está disponível como uma linguagem de expressão para utilização com os seguintes componentes e seus atributos. Esta 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 de Imagem, Texto alternativo
Button URL do botão, Texto do botão
IFrame URL do IFrame

Utilizar a barra de fórmulas do Power Fx

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

Captura de ecrã do Power Fx comando na barra de comandos de um controlo de texto.

Selecione fx para aceder à barra de fórmulas do Power Fx.

Componentes da barra de fórmulas

A captura de ecrã seguinte realça alguns dos componentes importantes da barra de fórmulas:

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

  1. Um menu pendente permite-lhe escolher entre as propriedades do componente disponíveis.

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

  3. O botão Repor redefine uma propriedade de componente como predefinida.

  4. O botão Guardar persiste a fórmula e as expressões para a propriedade do componente. A tela do estúdio é imediatamente atualizada 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 aceder manualmente a esta funcionalidade.

    Captura de ecrã da experiência de conclusão automática no Power Fx.

  • Capacidade de visualização de problemas: ajuda na validação e depuração antecipadas de fórmulas e expressões.

    Captura de ecrã da experiência quando um problema é detetado numa fórmula Power Fx.

  • Diálogo de alterações não guardadas: é apresentado se navegar para longe da barra de fórmulas quando há alterações não guardadas numa fórmula.

    Captura de ecrã do diálogo de alterações não guardadas com opções para Voltar ou Dispensar.

    Selecione Voltar para continuar a editar a fórmula ou Dispensar para dispensar as alterações.

Considerações importantes

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

  • Comece com um sinal de igual: o texto pode ser introduzido diretamente como valor. Para iniciar uma expressão do Power Fx, esta deve começar por um "=" (sinal de igual), como mostrado no exemplo que se segue:

    =Concatenate("Hello, ", User.FullName)
    
  • As tabelas são acedidas de forma segura: as tabelas do Dataverse podem ser acedidas utilizando fórmulas. Verifique primeiro se as permissões de tabela estão configuradas adequadamente. Além disso, o contexto de um utilizador do site está disponível utilizando o objeto Utilizador. Por exemplo, a expressão seguinte obtém o valor DataverseUserId do utilizador autenticado atualmente.

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

    Nota

    O objeto Utilizador representa um utilizador do Power Pages e, portanto, não suporta o mesmo conjunto de propriedades que a função Utilizador.

  • Inserir um valor no texto: para inserir um valor no texto, utilize a seguinte sintaxe.

    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 a lista completa das funções disponíveis no Power Pages, aceda a Referência de fórmula – Power Pages.

Problemas e limitações conhecidos

  • Algumas funções do Power Fx apresentadas através do IntelliSense não são atualmente suportadas no Power Pages. Essas funções apresentam o seguinte erro de momento de conceção quando utilizadas:

    Parameter 'Value': PowerFx type is not supported.

  • O sistema não inicializa o Utilizador para utilizadores anónimos, o que resulta no erro seguinte quando o usa em qualquer formulário, incluindo uma verificação para vazios. Este problema será resolvido numa versão futura.

    UserInfo object was not added to service

  • Alguns utilizadores poderão ver problemas com as propriedades de Botão e URL de Imagem que não funcionam quando o valor é definido com fórmulas ou expressões Power Fx que contêm aspas. Este problema só acontece se tiver a versão 9.6.3.x e é resolvido quando o seu site do Power Pages for atualizado para a versão 9.6.5.x.

Perguntas mais frequentes

Devo usar Power Fx em vez de Liquid?

O Power Fx cumpre determinados cenários de dados dinâmicos de uma forma low-code que também pode ser alcançada através de código Liquid com ferramentas para programadores profissionais. O Power Fx, atualmente na sua fase de pré-visualização pública, é recomendado para avaliações de sites de teste ou desenvolvimento. Agradecemos o seu feedback durante esta fase. O Liquid é uma caraterística em disponibilidade geral (GA) e, em comparação, fornece mais capacidades. Use Liquid para os sites de produção, particularmente em cenários críticos e complexos.

Consulte também