Función Sequence
Se aplica a:
Aplicaciones de lienzo Flujos de escritorio Aplicaciones basadas en modelos Power Platform CLI
Generar una tabla de números secuenciales.
Description
La función Sequence genera una tabla de una sola columna de números secuenciales, como 1, 2, 3. El nombre de la columna es Value. Sequence( 4 ) es equivalente a [1,2,3,4].
Use Sequence con la función ForAll para iterar un número específico de veces. Por ejemplo, la siguiente fórmula agrega 10 números aleatorios a la colección MyRandomNumbers:
ForAll( Sequence( 10 ), Collect( MyRandomNumbers, Rand() ) )
ForAll también se puede utilizar para transformar el valor en otros tipos de datos y devolver una nueva tabla. Por ejemplo, la siguiente fórmula devuelve una tabla de los próximos 10 días:
ForAll( Sequence( 10 ), DateAdd( Today(), Value, Days ) )
El número de registros que se va a generar se redondea al número entero más cercano y debe estar en el intervalo de 0 a 50 000. Generar una tabla con cero registros da como resultado una tabla vacía.
Nota
Sequence está limitada a 50 000 registros.
Sintaxis
Sequence( Registros [, Inicio [, Incremento ] ] )
- Records: obligatorio. El número de registros que se van a crear. Debe estar dentro del intervalo 0 a 50 000.
- Inicio: opcional. El número de inicio de la secuencia. El valor predeterminado es 1.
- Paso (opcional) El incremento de cada número sucesivo de la secuencia. Incremento puede ser negativo para contar hacia atrás desde Inicio. El valor predeterminado es 1.
Ejemplos
Uso básico
| Fórmula | Descripción | Resultado |
|---|---|---|
| Sequence( 4 ) | Genera una tabla de 4 registros comenzando por el inicio predeterminado,1, e incrementando con el valor de incremento predeterminado, 1. |  |
| Sequence( 4, 24 ) | Genera una tabla de 4 registros que empieza por 24 y se incrementa con el valor de incremento predeterminado, 1. |  |
| Sequence( 4, 4, -1 ) | Genera una tabla de 4 registros que empieza por 4 y se incrementa en -1, lo que supone contar hacia atrás. |  |
| Sequence( 4, -100, 0.5 ) | Genera una tabla de 4 registros que empieza por -100 y se incrementa con un valor de incremento de 0,5. |  |
| Sequence( 0.9 ) | Genera una tabla vacía puesto que el recuento se redondea a 0. |  |
| ForAll( Sequence( 4 ), Rand() ) | Genera una tabla de 4 registros de números aleatorios. |  Los números variarán. |
| Concat( Sequence( 5 ), Text( Value ) & " " ) |
Genera una cadena de números del 1 al 5. | "1 2 3 4 5 " |
Mapa de caracteres
Consulte la referencia de la función Char para ver dos funciones Sequence que trabajan juntas para mostrar un mapa de caracteres con un diseño bidimensional.
Tablero de ajedrez
Consulte la referencia del operador As para ver dos funciones Sequence que trabajan juntas para crear un tablero de ajedrez en una cadena de texto y en dos galerías anidadas.