Leer en inglés

Compartir a través de


Usar Power Fx en Power Pages (versión preliminar)

[Este tema es documentación preliminar y está sujeto a modificaciones.]

Power Fx es el lenguaje de poco código para expresar lógica a través de Microsoft Power Platform. Es un lenguaje de programación funcional, declarativo, de tipo fuerte y de uso general.

Power Fx se expresa en texto entendible para las personas. Es un lenguaje con poco código con el que los fabricantes pueden trabajar directamente en una barra de fórmulas similar a Excel. El "bajo" en código bajo se debe a la naturaleza concisa y simple del lenguaje, lo que facilita las tareas de programación comunes tanto para los creadores como para los desarrolladores.

Nota

Es posible que la sintaxis para crear fórmulas de Power Fx sea un poco diferente a la que está acostumbrado en Power Apps o Power Automate. Para iniciar una expresión Power Fx, debe comenzar con un '=' (signo igual) como en Excel. Para obtener más información, consulte Consideraciones importantes.

Power Fx capacita al espectro completo de desarrollo, desde creadores sin código sin conocimientos de programación hasta desarrolladores profesionales. Facilita la colaboración entre diversos equipos, ayudándoles a ahorrar tiempo y esfuerzo.

Importante

  • Esta es una característica en versión preliminar.
  • Las características en vista previa no se han diseñado para un uso de producción y pueden tener una funcionalidad restringida. Estas características están disponibles antes del lanzamiento oficial para que los clientes puedan tener un acceso anticipado y proporcionar comentarios.
  • La función está disponible con la Power Pages versión 9.6.5.x.

Usar Power Fx en Power Pages

Dentro de un sitio web de Power Pages, Power Fx está disponible como lenguaje de expresión para usar con los siguientes componentes y sus atributos. Esta funcionalidad permite la asignación dinámica de valores en función de los resultados de las expresiones Power Fx.

Componente Propiedades
Text Text
Image URL de imagen, texto alternativo
Button URL del botón, texto del botón
Iframe URL de Iframe

Usar la barra de fórmulas de Power Fx

La barra de herramientas incluye un nuevo comando fx para los componentes que admiten Power Fx:

Captura de pantalla del comando Power Fx en la barra de comandos de un control de texto.

Seleccione fx para acceder a la Power Fx barra de fórmulas.

Componentes de la barra de fórmulas

La siguiente captura de pantalla destaca algunos de los componentes importantes de la barra de fórmulas:

Captura de pantalla de la barra de fórmula de Power Fx en Power Pages.

  1. Un menú desplegable le permite elegir entre las propiedades de componentes disponibles.

  2. Un cuadro de texto expandible de varias líneas permite la creación de fórmulas Power Fx.

  3. El botón Restablecer establece una propiedad de componente a su valor predeterminado.

  4. El botón Guardar mantiene la fórmula y las expresiones de la propiedad del componente. El lienzo de Studio se actualiza inmediatamente si el valor resultante está disponible y se puede mostrar, por ejemplo, en las propiedades del texto.

Experiencias de barra de fórmulas

Las siguientes son algunas características centradas en el desarrollador para aumentar la productividad:

  • Asistencia de autocompletar: sugiere fórmulas, parámetros, tablas y objetos. Pulse Ctrl + espacio para acceder manualmente a esta función.

    Captura de pantalla de la experiencia de autocompletar en Power Fx.

  • Capacidad de ver problemas: ayuda en la validación temprana y la depuración de fórmulas y expresiones.

    Captura de pantalla de la experiencia cuando se detecta un problema en una fórmula de Power Fx.

  • Cuadro de diálogo de cambios no guardados: se muestra si navega fuera de la barra de fórmulas cuando hay cambios no guardados en una fórmula.

    Captura de pantalla del cuadro de diálogo de cambios no guardados con opciones para Volver o Descartar.

    Seleccione Volver para continuar editando la fórmula o Descartar para descartar los cambios.

Consideraciones importantes

Tenga en cuenta las siguientes directrices cuando use la barra de Power Fx fórmulas en Power Pages:

  • Empieza con un signo igual: el texto se puede ingresar directamente como valor. Para iniciar una expresión Power Fx , debe comenzar con un '=" (signo igual), como en el siguiente ejemplo:

    =Concatenate("Hello, ", User.FullName)
    
  • Se accede a las tablas de forma segura: Dataverse puede acceder a las tablas de forma segura mediante fórmulas. Primero verifique que los permisos de la tabla estén configurados correctamente. Además, el contexto de un usuario del sitio está disponible mediante el objeto Usuario. Por ejemplo, la siguiente expresión recupera el valor DataverseUserId del usuario actualmente autenticado.

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

    Nota

    El objeto Usuario representa un usuario de Power Pages y, por lo tanto, no admite el mismo conjunto de propiedades que la función User .

  • Insertar un valor dentro del texto: Para insertar un valor dentro del texto, utilice la siguiente sintaxis.

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

    Por ejemplo:

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

Funciones Power Fx disponibles

Para obtener una lista completa de todas las funciones disponibles en Power Pages, consulte Referencia de fórmula - Power Pages.

Problemas y limitaciones conocidos

  • Algunas funciones de Power Fx presentadas a través de IntelliSense no son compatibles actualmente en Power Pages. Esas funciones muestran el siguiente error de tiempo de diseño cuando se utilizan:

    Parameter 'Value': PowerFx type is not supported.

  • El sistema no inicializa el usuario para usuarios anónimos y genera el siguiente error cuando se utiliza en cualquier formulario, incluida la comprobación de campos vacíos. Este problema se corregirá en una próxima versión.

    UserInfo object was not added to service

  • Algunos usuarios pueden ver problemas con las propiedades de URL de imagen y botón que no funcionan cuando el valor se establece con Power Fx fórmulas o expresiones que contienen comillas dobles. Este problema solo ocurre si tiene la versión 9.6.3.x y se soluciona cuando su Power Pages sitio se actualiza a la versión 9.6.5.x.

Preguntas frecuentes

¿Debo usar Power Fx en lugar de Liquid?

Power Fx cumple ciertos escenarios de datos dinámicos con poco código que también se puede lograr a través de código Liquid con herramientas profesionales para desarrolladores. Power Fx, actualmente en su fase de versión preliminar pública, se recomienda para evaluaciones de sitios de prueba o de desarrollo. Agradecemos sus comentarios durante esta etapa. Liquid es una característica generalmente disponible (GA) y comparativamente proporciona más capacidades. Utilice Liquid para sus sitios web de producción, especialmente en escenarios críticos y complejos.

Consulte también