Compartir a través de


Agregar variables a una tarjeta

Las variables almacenan datos para reutilizarlos. Los datos pueden ser de diferentes tipos, como colección, texto o un número. Las variables tienen nombres únicos, que es como se hace referencia a ellas en las fórmulas de Power Fx. Insértelas, modifíquelas y elimínelas en el diseñador de tarjetas.

El valor de una variable puede ser temporal, restableciéndose para cada sesión de la tarjeta, o permanente, compartido en todas las sesiones de una instancia específica de la tarjeta. Las variables temporales son diferentes para cada sesión de tarjeta, incluso para un solo usuario, lo que significa que si se le envía la misma instancia de tarjeta en un chat y un canal, una variable temporal podría ser diferente en esas dos sesiones.

A modo de ejemplo, ha creado una tarjeta que cuenta las veces que el usuario pulsa un botón durante una sesión. Crearía una variable numérica temporal para almacenar el número de pulsaciones de botón en la instancia actual de la tarjeta. Si también desea capturar el nombre del último usuario que ha pulsado un botón en una instancia de tarjeta, lo almacenaría en una variable de texto permanente. Si además quisiera guardar los datos entre instancias de tarjeta, usaría una conexión de datos.

Las variables también se pueden personalizar, lo que significa que el remitente establece el valor, ya sea en la página de reproducción antes de enviarla como un vínculo o en Power Automate como parte de la acción Crear una instancia de tarjeta.

Requisitos previos

Crear una variable

  1. Inicie sesión en Power Apps. Seleccione Tarjetas y, a continuación, seleccione una tarjeta. Si la pestaña Tarjetas no está visible, seleccione Más y ancle la pestaña Tarjetas.

  2. En el panel izquierdo del diseñador de tarjetas, seleccione Variables.

  3. Seleccione +Nueva variable.

  4. En la ventana Nueva variable, establezca los siguientes valores:

    • Nombre: el nombre de su variable (obligatorio)
    • Tipo: el tipo de variable (obligatorio)
    • Valor predeterminado: el valor predeterminado de la variable
    • Persistencia: si la variable es temporal (se reinicia cada vez que se abre la tarjeta) o permanente
    • Personalización: si el remitente puede personalizar la variable para que actúe como una variable de entrada

    No puede cambiar el nombre ni el tipo de una variable. Si necesita cambiarlos, cree una nueva variable.

    También puede personalizar las opciones del remitente y, en Información de variable adicional, el Título y la Descripción de la variable. Esta información puede ser útil para probar, depurar y usar su variable con flujos de Power Automate.

    Captura de pantalla de la ventana Nueva variable en el diseñador de tarjetas.

  5. Seleccione Guardar.

Uso del valor predeterminado para tablas y registros

El valor predeterminado se utiliza para establecer la estructura de las variables de colección y de registro. Hay dos formas de establecer el valor predeterminado de una variable de registro o de tabla:

  • Uso del editor de columna
  • Uso de Power Fx / JSON

Puede alternar entre usar el editor de columna o Power Fx / JSON usando el control de alternancia de la derecha.

Captura de pantalla de cómo alternar entre JSON y Power Fx para establecer el valor predeterminado de la variable.

Usar una expresión de Power Fx es útil cuando desea que la variable almacene datos de una fuente de datos, como Dataverse. Por ejemplo, si quisiera un registro que contuviera una fila específica de la tabla Cuenta, podría establecer el valor predeterminado en First(Account).

Las variables están fuertemente tipadas, por lo que establecer el valor predeterminado bloquea la variable en esos tipos.

Editar y eliminar variables

Para editar o eliminar una variable, seleccione los puntos suspensivos (...) a la derecha de la variable y, a continuación, seleccione Editar o Eliminar.

Captura de pantalla de las opciones Editar y Eliminar variable en el diseñador de tarjetas.

Usar variables en tarjetas

Hay varias formas de usar variables en tarjetas. Aprenda a trabajar con variables en Power Apps.

Un uso común de las variables es en las expresiones de Power Fx. Haga referencia a la variable por su nombre en su fórmula. Para ver un ejemplo, vaya al tutorial de tarjetas sencillas. Sus variables también se reconocen en la barra de fórmulas.

Captura de pantalla de un nombre de variable rellenado automáticamente en la barra de fórmulas del diseñador de tarjetas.

Actualización del valor de una variable

Las variables pueden actualizarse usando la función Establecer, excluyendo las variables de tabla a las que se agregan usando la función Recopilar.