Variables de Power Fx

Nota

Microsoft Power Fx es el nuevo nombre del lenguaje de fórmulas para aplicaciones de lienzo. Estos artículos funcionan en curso a medida que Microsoft extrae el lenguaje de las aplicaciones de lienzo, lo integra con otros productos de Microsoft Power Platform y hace que esté disponible como código abierto. Empiece con la Descripción general de Microsoft Power Fx para una introducción al idioma.

Obtenga información sobre cómo las variables de Power Fx difieren de las variables de las herramientas, como Visual Basic o JavaScript, y cuándo las fórmulas son una mejor opción. En este artículo se explica cómo elegir variables globales, variables de contexto o colecciones para administrar los valores y el estado de la aplicación.

En otras herramientas, puede realizar explícitamente un cálculo y almacenar el resultado en una variable. Pero Power Fx y Excel recalculan automáticamente las fórmulas cuando los datos de entrada cambian, por lo que normalmente no tendrá que crear ni actualizar las variables. Si adopta este enfoque siempre que sea posible, podrá crear, comprender y mantener la aplicación más fácilmente.

En algunos casos, debe usar variables en Power Fx. Power Fx amplía el modelo de Excel agregando fórmulas de comportamiento. Estas fórmulas se ejecutan cuando, por ejemplo, un usuario selecciona un botón. Dentro de una fórmula de comportamiento, a menudo resulta útil establecer una variable que se usará en otras fórmulas.

En general debe evitar el uso de variables, pero a veces solo una variable puede habilitar la experiencia que busca. Se crean y escriben variables implícitamente cuando aparecen en funciones que establecen sus valores.

Traducir Excel a Power Fx

Excel

Revisemos el funcionamiento de Excel. Una celda puede contener un valor, como un número o una cadena, o una fórmula basada en los valores de otras celdas. Cuando el usuario introduce un valor diferente en una celda, Excel recalcula automáticamente las fórmulas que dependen del valor nuevo. No hace falta realizar ningún tipo de programación para habilitar este comportamiento.

En el ejemplo siguiente, la celda A3 se establece en la fórmula A1+A2. Si A1 o A2 cambian, A3 se vuelve a calcular automáticamente para reflejar el cambio. Este comportamiento no requiere codificación fuera de la propia fórmula.

Excel no tiene variables. El valor de una celda que contiene una fórmula cambia en función de su entrada, pero no es posible recordar el resultado de una fórmula y almacenarlo en una celda o en otro lugar. Si cambia el valor de una celda, toda la hoja de cálculo podría cambiar y se perderán los valores calculados anteriormente. Un usuario de Excel puede copiar y pegar las celdas, pero esto depende del control manual del usuario y no es posible hacerlo con las fórmulas.

Power Fx

La lógica que se crea en Power Fx se comportan de una manera muy parecida a Excel. En lugar de actualizar las celdas, puede agregar controles donde quiera en una pantalla y asignarles un nombre para usarlos en fórmulas.

Por ejemplo en Power Apps, puede replicar el comportamiento de Excel en una aplicación mediante la adición de un control Label, denominado Label1, y dos controles Text input denominados TextInput1 y TextInput2. Si después establece la propiedad Text de Label1 en TextInput1.Text + TextInput2.Text, siempre muestra la suma de los números que estén en TextInput1 y TextInput2 automáticamente.

Tenga en cuenta que el control Label1 está seleccionado y muestra su fórmula Text en la barra de fórmulas en la parte superior de la pantalla. Aquí encontrará la fórmula TextInput1.Text + TextInput2.Text. Esta fórmula crea una dependencia entre estos controles, del mismo modo que se crean las dependencias entre las celdas de un libro de Excel. Vamos a cambiar el valor de TextInput1:

La fórmula de Label1 se vuelve a calcular automáticamente, mostrando el nuevo valor.

En Power Fx, puede usar fórmulas para determinar no solo el valor principal de un control, sino propiedades como el formato. En el ejemplo siguiente, una fórmula para la propiedad Color de la etiqueta muestra automáticamente valores negativos en rojo. El aspecto de la función If debería resultarle familiar de Excel:

If( Value(Label1.Text) < 0, Color.Red, Color.Black )

Puede usar fórmulas para una amplia variedad de escenarios:

• Mediante el uso del GPS de su dispositivo, un control Mapa puede mostrar su ubicación actual con una fórmula que use Location.Latitude y Location.Longitude. A medida que se desplaza, el mapa sigue automáticamente su ubicación.
• Otros usuarios pueden actualizar los orígenes de datos. Por ejemplo, otros miembros del equipo pueden actualizar los elementos de una lista de SharePoint. Al actualizar un origen de datos, las fórmulas dependientes se recalculan automáticamente para reflejar los datos actualizados. Además del ejemplo, puede establecer la propiedad Items de una galería en la fórmula Filter( SharePointList ), que muestra automáticamente el conjunto de registros recién filtrado.

Ventajas de las fórmulas de Power Fx

El uso de fórmulas para compilar aplicaciones ofrece muchas ventajas:

• Si está familiarizado con Excel, sabrá usar Power Fx. El lenguaje de fórmulas y modelos es el mismo.
• Si usa otras herramientas de programación, tenga en cuenta la cantidad de código que necesita para llevar a cabo estos ejemplos. En Visual Basic, tendría que escribir un controlador de eventos para el evento de cambio en cada control de entrada de texto. El código para realizar el cálculo en cada uno de estos controladores de eventos es redundante y podría salir de la sincronización, o bien tendría que escribir una subrutina común. En Power Fx, logra todo ese trabajo con una fórmula única de una sola línea.
• Para comprender de dónde procede el texto de Label1, sabe exactamente dónde buscar: la fórmula de la propiedad Text . No hay otra manera de influir en el texto de este control. En una herramienta de programación tradicional, cualquier controlador de eventos o subrutina puede cambiar el valor de la etiqueta desde cualquier lugar del programa. Este enfoque puede dificultar el seguimiento de cuándo y dónde se cambió una variable.
• Si el usuario cambia un control deslizante pero después cambia de opinión, puede devolver el control deslizante a su valor original Es como si no hubiera cambiado nada: la aplicación muestra los mismos valores de control que antes. No hay repercusiones si se experimenta y se comprueba qué sucede al cambiar algo, igual que en Excel.

En general, si puede lograr un efecto mediante una fórmula, es mejor. Deje que el motor de fórmulas de Power Fx trabaje por usted.

Saber cuándo usar variables

Vamos a cambiar el sumador simple para que actúe como una máquina de sumar antigua, con un total acumulado. Si selecciona un botón Agregar , agregue un número al total en ejecución. Si selecciona un botón Borrar , restablece el total en ejecución a cero.

Mostrar	Descripción
	Cuando se inicia la aplicación, el total acumulado es 0. El punto rojo representa el dedo del usuario en el cuadro de entrada de texto, donde el usuario escribe 77.
	El usuario selecciona el botón Agregar.
	77 se agrega al total agregado. El usuario selecciona de nuevo el botón Agregar.
	77 se agrega de nuevo al total acumulado, lo que da como resultado 154. El usuario selecciona el botón Borrar.
	El total acumulado se restablece en 0.

Esta máquina de sumar usa algo que no existe en Excel: un botón. En esta aplicación, no puede usar solamente fórmulas para calcular el total acumulado, ya que su valor depende de una serie de acciones que realiza el usuario. En su lugar, debe registrar y actualizar el total en ejecución manualmente. La mayoría de las herramientas de programación almacena esta información en una variable.

En ocasiones necesitará una variable para que la aplicación se comporte de la manera deseada, pero debe tener en cuenta una serie de advertencias:

• Debe actualizar manualmente el total acumulado. El recálculo automático no lo hará por usted.
• No se puede calcular el total en ejecución en función de los valores de otros controles. Depende del número de veces que el usuario haya seleccionado el botón Agregar y del valor que se encontrase en cada ocasión en el control de entrada de texto. ¿El usuario ha escrito 77 y ha seleccionado Agregar dos veces, o bien ha escrito 24 y 130 para cada una de las sumas? No se puede saber la diferencia después de que el total alcance 154.
• Los cambios en el total pueden proceder de diferentes acciones. En este ejemplo, tanto el botón Agregar como el botón Borrar pueden actualizar el total. Si la aplicación no se comporta de la manera esperada, ¿qué botón causa el problema?

Usar una variable global

Para crear la máquina de adición, necesita una variable para contener el total en ejecución. Las variables más sencillas para trabajar con Power Fx son las variables globales.

Cómo funcionan las variables globales:

• Use la función Set para establecer el valor de la variable global. Set( MyVar, 1 ) establece la variable global MyVar en un valor de 1.
• Use la variable global haciendo referencia al nombre que usó con la función Set . En este caso, MyVar devuelve 1.
• Las variables globales pueden contener cualquier valor, como cadenas, números, registros y tablas.

Vamos a recompilar la máquina de sumar mediante el uso de una variable de global:

1. Agregue un control de entrada de texto, denominado TextInput1, y dos botones, denominados Button1 y Button2.

2. Establezca la propiedad Text de Button1 en "Agregar" y la propiedad Text de Button2 en "Borrar".

3. Para actualizar el total acumulado cada vez que un usuario seleccione el botón Agregar, establezca su propiedad OnSelect en esta fórmula:

   Set( RunningTotal, RunningTotal + TextInput1.Text )

   La mera existencia de esta fórmula establece RunningTotal como una variable global que contiene un número debido al operador +. Puede hacer referencia a RunningTotal en cualquier parte de la aplicación. Cada vez que el usuario abre esta aplicación, RunningTotal tiene un valor inicial de en blanco.

   La primera vez que un usuario selecciona el botón Agregar y ejecuta Set, RunningTotal se establece en el valor RunningTotal + TextInput1.

   

4. Para establecer el total acumulado en 0 cada vez que el usuario seleccione el botón Borrar, establezca su propiedad OnSelect en esta fórmula:

   Set( RunningTotal, 0 )

   

5. Agregue un control Label y establezca su propiedad Text en RunningTotal.

   Esta fórmula recalcula automáticamente y muestra al usuario el valor de RunningTotal a medida que cambia en función de los botones que selecciona el usuario.

   

6. Obtenga una vista previa de la aplicación y tenga la máquina de adición como se ha descrito anteriormente. Escriba un número en el cuadro de texto y presione el botón Agregar varias veces. Cuando esté listo, vuelva a la experiencia de creación mediante la clave Esc .

   

7. Para mostrar el valor de la variable global, seleccione el menú Archivo y seleccione Variables en el panel izquierdo.

   

8. Para mostrar todos los lugares donde se define y se usa la variable, selecciónela.

   

Tipos de variables

Power Fx tiene dos tipos de variables:

Tipo de variable	Scope	Descripción	Funciones que establecen
Variables globales	App	Las más sencillas de utilizar. Contiene un número, una cadena de texto, un valor booleano, un registro, una tabla y mucho más. Puede hacer referencia a ella desde cualquier lugar de la aplicación.	Set
Recopilaciones	App	Contiene una tabla a la que puede hacer referencia desde cualquier lugar de la aplicación. Puede modificar el contenido de la tabla en lugar de establecerlo en su conjunto. Puede guardarlo en el dispositivo local para su uso posterior.	Collect ClearCollect

Al usar Power Apps, verá un tercer tipo de variable:

Tipo de variable	Scope	Descripción	Funciones que establecen
Variables de contexto	Pantalla	Idóneas para pasar valores a una pantalla, de forma parecida a como se pasan los parámetros a un procedimiento en otros lenguajes. Solo puede hacer referencia a ella desde una sola pantalla.	UpdateContext Navigate

Crear y quitar variables

Todas las variables se crean implícitamente cuando aparecen en una función Set, UpdateContext, Navigate, Collect o ClearCollect . Para declarar una variable y su tipo, solo tiene que incluirla en cualquiera de estas funciones en cualquier parte de la aplicación. Ninguna de estas funciones crea variables; solo rellenan las variables con valores. Nunca se declaran variables explícitamente como se haría en otra herramienta de programación, y todo lo que se escribe es implícito en el uso.

Por ejemplo, podría tener un control de botón con una fórmula OnSelect igual a Set (X, 1 ). Esta fórmula establece X como variable con un tipo de número. Puede usar X en las fórmulas como un número y esa variable tiene un valor en blanco después de abrir la aplicación, pero antes de seleccionar el botón. Cuando se selecciona el botón, se asigna a X el valor de 1.

Si agrega otro botón y establece su propiedad OnSelect en Set( X, "Hello" ), se produce un error porque el tipo (cadena de texto) no coincide con el tipo del conjunto anterior (número). Todas las definiciones implícitas de la variable deben estar de acuerdo en el tipo. De nuevo, todo esto sucedió porque mencionó X en fórmulas, no porque ninguna de esas fórmulas se ejecutó realmente.

Quite una variable quitando todas las funciones Set, UpdateContext, Navigate, Collect o ClearCollect que establezcan implícitamente la variable. Sin estas funciones, la variable no existe. También debe quitar las referencias a la variable porque provocan un error.

Duración de la variable y valor inicial

La aplicación contiene todas las variables en memoria mientras se ejecuta. Una vez que se cierra la aplicación, se pierden los valores que contienen las variables.

Puede almacenar el contenido de una variable en un origen de datos mediante las funciones Patch o Collect. También puede almacenar valores en colecciones en el dispositivo local mediante la función SaveData.

Cuando el usuario abre la aplicación, todas las variables tienen el valor inicial en blanco.

Leer variables

Use el nombre de la variable para leer su valor. Por ejemplo, puede definir una variable con esta fórmula:

Set( Radius, 12 )

A continuación, simplemente puede usar Radius en cualquier lugar en el que pueda usar un número y reemplazar por 12:

Pi() * Power( Radius, 2 )

Si asigna a una variable de contexto el mismo nombre que una variable global o una colección, la variable de contexto tiene prioridad. Sin embargo, todavía puede hacer referencia a la variable global o colección si utiliza el operador de desambiguación[@Radius].

Usar una variable de contexto (solo Power Apps)

Aquí se muestra cómo crear la máquina de adición mediante una variable de contexto en lugar de una variable global.

Cómo funcionan las variables de contexto:

• Puede establecer implícitamente variables de contexto mediante la función UpdateContext o Navigate. Cuando se inicia la aplicación, el valor inicial de todas las variables de contexto está en blanco.
• Las variables de contexto se actualizan con registros. En otras herramientas de programación, normalmente se usa "=" para la asignación, como en "x = 1". En el caso de las variables de contexto, se usa { x: 1 } en su lugar . Cuando use una variable de contexto, use su nombre directamente sin la sintaxis de registro.
• También puede establecer una variable de contexto al usar la función Navigate para mostrar una pantalla. Si piensa en una pantalla como un tipo de procedimiento o subrutina, este enfoque se asemeja al paso de parámetros en otras herramientas de programación.
• Excepto en el caso de Navigate, las variables de contexto están limitadas al contexto de una sola pantalla, que es donde obtienen su nombre. No puede usarlas ni establecerlas fuera de este contexto.
• Las variables de contexto pueden contener cualquier valor, como cadenas, números, registros y tablas.

Vamos a volver a compilar la máquina de sumar mediante el uso de una variable de contexto:

1. Agregue un control de entrada de texto, denominado TextInput1, y dos botones, denominados Button1 y Button2.

2. Establezca la propiedad Text de Button1 en "Agregar" y la propiedad Text de Button2 en "Borrar".

3. Para actualizar el total acumulado cada vez que un usuario seleccione el botón Agregar, establezca su propiedad OnSelect en esta fórmula:

   UpdateContext( { RunningTotal: RunningTotal + TextInput1.Text } )

   La mera existencia de esta fórmula establece RunningTotal como una variable de contexto que contiene un número debido al operador +. Puede hacer referencia a RunningTotal en cualquier parte de esta pantalla. Cada vez que el usuario abre esta aplicación, RunningTotal tiene un valor inicial de en blanco.

   La primera vez que el usuario selecciona el botón Agregar y se ejecuta UpdateContext, RunningTotal se establece en el valor RunningTotal + TextInput1.

   

4. Para establecer el total acumulado en 0 cada vez que el usuario seleccione el botón Borrar, establezca su propiedad OnSelect en esta fórmula:

   UpdateContext( { RunningTotal: 0 } )

   De nuevo, se usa UpdateContext con la fórmula UpdateContext( { RunningTotal: 0 } ).

   

5. Agregue un control Label y establezca su propiedad Text en RunningTotal.

   Esta fórmula recalcula automáticamente y muestra al usuario el valor de RunningTotal a medida que cambia en función de los botones que selecciona el usuario.

   

6. Obtenga una vista previa de la aplicación y tenga la máquina de adición como se ha descrito anteriormente. Escriba un número en el cuadro de texto y presione el botón Agregar varias veces. Cuando esté listo, vuelva a la experiencia de creación mediante la clave Esc .

   

7. Puede establecer el valor de una variable de contexto mientras se desplaza a una pantalla. Esta técnica es útil para pasar "contexto" o "parámetros" de una pantalla a otra. Para mostrar esta técnica, inserte una pantalla, inserte un botón y establezca su propiedad OnSelect en esta fórmula:

   Navigate( Screen1, None, { RunningTotal: -1000 } )

   

   Mantenga presionada la tecla Alt mientras selecciona este botón para mostrar Screen1 y establezca la variable de contexto RunningTotal en -1000.

   

8. Para mostrar el valor de la variable de contexto, seleccione el menú Archivo y, a continuación, seleccione Variables en el panel izquierdo.

   

9. Seleccione la variable de contexto para ver dónde se define y se usa.

   

Usar una colección

Por último, veamos cómo crear la máquina de sumar con una colección. Puesto que una colección contiene una tabla que se puede modificar fácilmente, esta máquina de adición mantiene una "cinta de papel" de cada valor mientras se escriben.

Cómo funcionan las colecciones:

• Use la función ClearCollect para crear y establecer colecciones. Puede usar la función Collect en su lugar, pero requiere eficazmente otra variable en lugar de reemplazar la antigua.
• Una colección es una clase de origen de datos y, por lo tanto, una tabla. Para obtener acceso a un valor único de una colección, use la función First y extraiga un campo del registro resultante. Si usa un valor único con ClearCollect, este valor es el campo Valor , como en este ejemplo:
  First(VariableName).Value

Vamos a recrear la máquina de sumar mediante una colección:

1. Agregue un control de Entrada de texto, denominado TextInput1, y dos botones, denominados Button1 y Button2.

2. Establezca la propiedad Text de Button1 en "Agregar" y la propiedad Text de Button2 en "Borrar".

3. Para actualizar el total acumulado cada vez que un usuario seleccione el botón Agregar, establezca su propiedad OnSelect en esta fórmula:

   Recopilar( PaperTape, TextInput1.Text )

   La mera existencia de esta fórmula establece PaperTape como una colección que contiene una tabla de cadenas de texto de una sola columna. Puede hacer referencia a PaperTape en cualquier parte de esta aplicación. Cada vez que un usuario abre esta aplicación, PaperTape es una tabla vacía.

   Cuando se ejecuta esta fórmula, agrega el nuevo valor al final de la colección. Dado que va a agregar un solo valor, Collect lo coloca automáticamente en una tabla de una sola columna y el nombre de la columna es Value, que se usa más adelante.

   

4. Para borrar el registro cada vez que el usuario seleccione el botón Borrar, establezca su propiedad OnSelect en esta fórmula:

   Clear( PaperTape )

   

5. Para mostrar el total acumulado, agregue una etiqueta y establezca su propiedad Text en esta fórmula:

   Sum( PaperTape, Value )

   

6. Para ejecutar la máquina de sumar, presione F5 para abrir la vista previa, escriba números en el control de entrada de texto y seleccione botones.

   

7. Para volver al área de trabajo predeterminada, presione la tecla Esc .

8. Para mostrar el registro, inserte un control Tabla de datos y establezca su propiedad Items en esta fórmula:

   PaperTape

   En el panel de la derecha, seleccione Editar campos y luego seleccione Agregar campo, seleccione la columna Valor y luego seleccione Agregar para mostrarlo.

   

9. Para ver los valores de la colección, seleccione Colecciones en el menú Archivo.

   

10. Para almacenar y recuperar la colección, agregue dos controles de botón adicionales y establezca sus propiedades Text en Cargar y Guardar. Establezca la propiedad OnSelect del botón Cargar en esta fórmula:

    Clear( PaperTape ); LoadData( PaperTape, "StoredPaperTape", true )

    Primero debe borrar la colección porque LoadData anexará los valores almacenados al final de la colección.

    

11. Establezca la propiedad OnSelect del botón Guardar en esta fórmula:

    SaveData( PaperTape, "StoredPaperTape" )

    

12. Vuelva a obtener una vista previa presionando la tecla F5 , escriba números en el control de entrada de texto y seleccione los botones. Seleccione el botón Guardar. Cierre y vuelva a cargar la aplicación y seleccione el botón Cargar para volver a cargar la colección.