Función ForAll

Se aplica a: Aplicaciones de lienzo Flujos de escritorio Aplicaciones basadas en modelos Power Platform CLI

Calcula valores y realiza acciones para todos los registros de una tabla.

Descripción

La función ForAll evalúa una fórmula para todos los registros que haya en una tabla. La fórmula puede calcular un valor o realizar acciones, como modificar datos o trabajar con una conexión. Use la función With para evaluar la fórmula de un solo registro.

Use la función Sequence con la función ForAll para iterar en función de un recuento.

Los campos de registro que se están procesando actualmente estarán disponibles en la formula. Use el operador ThisRecord o simplemente haga referencia a los campos por nombre como lo haría con cualquier otro valor. El operador As también se puede usar para nombrar el registro que se está procesando, lo que puede ayudar a que su fórmula sea más fácil de entender y hacer accesibles los registros anidados. Para obtener más información, vea los ejemplos siguientes y trabajar con el ámbito de registros.

Valor de retorno

Se devuelve el resultado de cada evaluación de fórmula en una tabla, en el mismo orden que la tabla de entrada.

Si el resultado de la fórmula es un valor único, la tabla resultante será una tabla con una sola columna. Si el resultado de la fórmula es un registro, la tabla resultante contendrá registros con las mismas columnas que el registro del resultado.

Si el resultado de la fórmula es un valor blank, no habrá ningún registro en la tabla de resultados para ese registro de entrada. En este caso, habrá menos registros en la tabla de resultados que en la tabla de origen.

Realización de acciones

La fórmula puede incluir funciones que realicen acciones, como modificar los registros de un origen de datos con las funciones Patch y Collect. La fórmula también puede llamar a métodos en las conexiones. Se pueden realizar varias acciones por registro mediante el operador ;. No se puede modificar la tabla objeto de la función ForAll.

Al escribir la fórmula, tenga en cuenta que los registros se pueden procesar en cualquier orden y, siempre que sea posible, en paralelo. Se puede procesar el primer registro de la tabla después del último registro.

Tenga cuidado para evitar la ordenación de las dependencias. Por esta razón, no puede usar las funciones UpdateContext, Clear y ClearCollect dentro de una función ForAll ya que se podrían usar fácilmente para mantener variables que son susceptibles de sufrir este efecto. Puede usar Collect, pero el orden en que se agregan los registros no está definido.

Varias funciones que modifican los orígenes de datos, incluidas las funciones Collect, Remove y Update, devuelven el origen de datos que han cambiado como su valor devuelto. Estos valores devueltos pueden ser grandes y consumir recursos significativos si se devuelven para cada registro de la tabla ForAll. También es posible que estos valores devueltos no sean los esperados, ya que ForAll puede funcionar en paralelo y puede separar los efectos secundarios de estas funciones a partir de la obtención de su resultado. Si el valor devuelto desde ForAll no se utiliza, y este suele ser el caso de las funciones de modificación de datos, el valor devuelto no se creará con lo que no habrá ningún problema de recursos u ordenación. Sin embargo, si va a utilizar el resultado de una función ForAll y el de alguna de las funciones que devuelve un origen de datos, medite concienzudamente sobre cómo estructurar el resultado y pruébelas primero en conjuntos de datos pequeños.

Alternativas

Muchas funciones de Power Apps pueden procesar más de un valor a la vez mediante el uso de una tabla de una sola columna. Por ejemplo, la función Len puede procesar una tabla de valores de texto, devolviendo una tabla de longitudes, de la misma manera que podría hacerlo la función ForAll. Esto hace que no sea necesario usar la función ForAll en muchos casos, puede resultar más eficaz y es más fácil de leer.

Otra consideración a tener en cuenta es que ForAll no es delegable mientras que otras funciones sí que lo pueden ser como, por ejemplo, Filter.

Delegación

Cuando se usa con un origen de datos, esta función no se puede delegar. Solo se recuperará la primera parte del origen de datos, y después se aplicará la función. Es posible que el resultado no represente la historia completa. Puede que aparezca una advertencia en el momento de la creación para recordarle esta limitación y sugerirle un cambio a alternativas delegables siempre que sea posible. Para obtener más información, consulte la información general sobre delegación

Sintaxis

ForAll( Table, Formula )

• Table - obligatorio. Tabla sobre la que se va a actuar.
• Formula (obligatorio). La fórmula que se evalúa para todos los registros de la tabla.

Ejemplos

Cálculos

Los ejemplos siguientes usan el origen de datosSquares:

Para crear este origen de datos como una colección, establezca la propiedad OnSelect de un control Button en esta fórmula, abra el modo de vista previa y, a continuación, seleccione el botón:

ClearCollect( Squares, [ "1", "4", "9" ] )

Fórmula	Descripción	Resultado
ForAll( Squares, Sqrt( Value ) ) Sqrt( Squares )	Para todos los registros de la tabla de entrada calcula la raíz cuadrada de la columna Value. La función Sqrt también puede utilizarse con una tabla de una sola columna, lo que permite ejecutar este ejemplo sin usar la función ForAll.
ForAll( Squares, Power( Value, 3 ) )	Para todos los registros de la tabla de entrada eleva la columna Valor a la tercera potencia. La función Power no admite tablas de una sola columna. Por tanto, se debe usar ForAll en este caso.

Uso de una conexión

Los ejemplos siguientes usan el origen de datosExpressions:

Para crear este origen de datos como una colección, establezca la propiedad OnSelect de un control Button en esta fórmula, abra el modo de vista previa y, a continuación, seleccione el botón:

ClearCollect( Expressions, [ "Hello", "Good morning", "Thank you", "Goodbye" ] )

Este ejemplo usa también una conexión con Microsoft Translator. Para agregar esta conexión a la aplicación, consulte el artículo acerca de cómo administrar conexiones.

Fórmula	Descripción	Resultado
ForAll( Expressions, MicrosoftTranslator.Translate( Value, "es" ) )	Para todos los registros de la tabla Expressions, traduce el contenido de la columna Value en español (abreviado "es").
ForAll( Expressions, MicrosoftTranslator.Translate( Value, "fr" ) )	Para todos los registros de la tabla Expressions, traduce el contenido de la columna Value en francés (abreviado "fr").

Copia de una tabla

A veces, es necesario filtrar, dar forma, ordenar y manipular los datos. Power Apps proporciona muchas funciones para hacer esto, como Filter, AddColumns y Sort. Power Apps trata cada tabla como un valor, lo que permite que fluya a través de las fórmulas y se consuma fácilmente.

Y, a veces, querrá hacer una copia de este resultado para usarlo posteriormente, o desea mover información de un origen de datos a otro. Power Apps proporciona la función Collect para copiar datos.

Pero antes de hacer esa copia, debe considerar cuidadosamente si la necesita. Hay muchas situaciones que se pueden solucionar mediante el filtrado y la forma del origen de datos subyacente a petición con una fórmula. Algunas de las desventajas a la hora de realizar una copia son:

• Dos copias de la misma información significa que una de ellas puede quedar desfasada por no sincronizarse.
• Realizar una copia puede consumir gran parte de la memoria del equipo, ancho de banda de red y mucho tiempo.
• En la mayoría de los orígenes de datos, la copia no se puede delegar, lo cual limita la cantidad de datos que se pueden mover.

Los ejemplos siguientes usan el origen de datosProducts:

Para crear este origen de datos como una colección, establezca la propiedad OnSelect de un control Button en esta fórmula, abra el modo de vista previa y, a continuación, seleccione el botón:

ClearCollect( Products,
    Table(
        { Product: "Widget",    'Quantity Requested': 6,  'Quantity Available': 3 },
        { Product: "Gadget",    'Quantity Requested': 10, 'Quantity Available': 20 },
        { Product: "Gizmo",     'Quantity Requested': 4,  'Quantity Available': 11 },
        { Product: "Apparatus", 'Quantity Requested': 7,  'Quantity Available': 6 }
    )
)

Nuestro objetivo es trabajar con una tabla derivada que incluya solo los artículos de los que se ha solicitado una cantidad mayor a la disponible y para los cuales hay que realizar un pedido:

Se puede realizar esta tarea de dos maneras diferentes, que generan el mismo resultado, y cada una con sus ventajas y desventajas.

Forma de tabla a petición

No haga esa copia. Podemos utilizar la fórmula siguiente en cualquier lugar que sea necesario:

// Table shaping on demand, no need for a copy of the result
ShowColumns(
    AddColumns(
        Filter( Products, 'Quantity Requested' > 'Quantity Available' ),
        "Quantity To Order", 'Quantity Requested' - 'Quantity Available'
    ),
    "Product",
    "Quantity To Order"
)

Se crea un ámbito de registro mediante las funciones Filter y AddColumns que permite realizar las operaciones de comparación y resta, respectivamente, con los campos 'Cantidad en pedido' y 'Cantidad disponible' de cada registro.

En este ejemplo, la función Filter se puede delegar. Esto es importante, ya que puede encontrar todos los productos que cumplen los criterios, incluso si se trata solo de unos pocos registros en una tabla de millones de ellos. En este momento, las funciones ShowColumns y AddColumns no se pueden delegar, por lo que se limitará el número real de productos que es necesario solicitar. Si sabe que el tamaño de este resultado siempre será relativamente pequeño, este enfoque es adecuado.

Y dado que no realizamos una copia, no hay ninguna copia adicional de la información para administrar o que esté obsoleta.

Función ForAll a petición

Otro enfoque consiste en utilizar la función ForAll para reemplazar las funciones de forma de tabla:

ForAll( Products,
    If( 'Quantity Requested' > 'Quantity Available',
        {
            Product: Product,
            'Quantity To Order': 'Quantity Requested' - 'Quantity Available'
        }
    )
)

Esta fórmula puede ser más sencilla de leer y escribir para algunas personas.

No se puede delegar ninguna parte de ForAll. Solo se evaluará la primera parte de la tabla Productos, lo cual podría ser un problema si esta tabla es muy grande. Dado que la función Filter se pudo delegar en el ejemplo anterior, esta podría funcionar mejor con grandes conjuntos de datos.

Recopilación de resultados

En algunos casos, puede que sea necesario realizar una copia de los datos. Puede que necesite mover información de un origen de datos a otro. En este ejemplo, se realizan los pedidos a través de una tabla denominada NewOrder del sistema del proveedor. Para interacciones de usuario de alta velocidad, puede que desee almacenar en caché una copia local de una tabla para que no haya ninguna latencia del servidor.

Se utilizará la misma forma de tabla que en los dos ejemplos anteriores, pero se capturará el resultado en una colección:

ClearCollect( NewOrder,
    ShowColumns(
        AddColumns(
            Filter( Products, 'Quantity Requested' > 'Quantity Available' ),
            "Quantity To Order", 'Quantity Requested' - 'Quantity Available'
        ),
        "Product",
        "Quantity To Order"
    )
)

ClearCollect( NewOrder,
    ForAll( Products,
        If( 'Quantity Requested' > 'Quantity Available',
            {
                Product: Product,
                'Quantity To Order': 'Quantity Requested' - 'Quantity Available'
            }
        )
    )
)

Las funciones ClearCollect y Collect no se pueden delegar. Como consecuencia, la cantidad de datos que se pueden mover de esta manera es limitada.

Recopilación dentro de ForAll

Por último, se puede realizar la función Collect directamente dentro de ForAll:

Clear( NewOrder );
ForAll( Products,
    If( 'Quantity Requested' > 'Quantity Available',
        Collect( NewOrder,
            {
                Product: Product,
                'Quantity To Order': 'Quantity Requested' - 'Quantity Available'
            }
        )
    )
)

Una vez más, la función ForAll no se puede delegar en este momento. Si la tabla Products es grande, la función ForAll buscará solo en el primer conjunto de registros y puede que se pasen por alto algunos productos que es necesario solicitar. Pero en el caso de tablas que sabemos que seguirán siendo pequeñas, este enfoque es adecuado.

Tenga en cuenta que no vamos a capturar el resultado de la función ForAll. Las llamadas de la función Collect realizadas desde dentro de ella devolverán el origen de datos NewOrder para todos los registros, lo que podría agregarse a muchos datos si los fuéramos a capturar.

Asignar tabla en un componente

Vea Asignar tablas.