Sequence Função

Aplica-se a: Aplicativos do Canvas Fluxos do Copilot Studio Desktop Aplicativos orientados por modelos Funções do Power Platform CLI Dataverse

Gere uma tabela de números sequenciais.

Descrição

A Sequence função gera uma tabela de coluna única de números sequenciais, como 1, 2, 3. O nome da coluna é Value. Sequence( 4 ) é equivalente a [1,2,3,4].

Use Sequence com a função ForAll para iterar um número específico de vezes. Por exemplo, a seguinte fórmula adiciona 10 números aleatórios à coleção MyRandomNumbers:

ForAll( Sequence( 10 ), Collect( MyRandomNumbers, Rand() ) )

ForAll também pode ser usado para transformar o valor em outros tipos de dados e retornar uma nova tabela. Por exemplo, a fórmula seguinte devolve uma tabela dos 10 dias seguintes:

ForAll( Sequence( 10 ), DateAdd( Today(), Value, Days ) )

O número de registos a gerar é arredondado para o número inteiro mais próximo e tem de estar entre 0 e 50.000. Gerar uma mesa com zero registos resulta numa tabela vazia.

Sintaxe

Sequence( Registos [, Iniciar [, Passo ] )

• Registos – Obrigatório. O número de registos a criar. Tem de estar no intervalo de 0 a 50.000.
• Iniciar – Opcional. O número inicial para a sequência. A predefinição é 1.
• passo – Opcional. O incremento para cada número sucessivo na sequência. passo pode ser negativo para contagem regressiva desde o início. A predefinição é 1.

Exemplos

Utilização básica

Fórmula	Descrição	Resultado
Sequence( 4 )	Gera uma tabela de 4 registos a partir do valor predefinido de 1 e com incremento de 1 por predefinição.
Sequence( 4, 24 )	Gera uma tabela de 4 registos a partir de 24 e com incremento de 1 por predefinição.
Sequence( 4, 4, -1 )	Gera uma tabela de 4 registos a partir do valor de 4 e com incremento de -1, uma contagem decrescente efetiva.
Sequence( 4, -100, 0.5 )	Gera uma tabela de 4 registos a partir de -100 e com incremento de 0,5.
Sequence( 0.9 )	Gera uma tabela vazia porque a contagem é arredondada para 0.
ForAll( Sequence( 4 ), Rand() )	Gera uma tabela de 4 registos de números aleatórios.	Os números reais variam.
Concat( Sequence( 5 ), Text( Valor ) & " " )	Gera uma cadeia de números de 1 a 5.	"1 2 3 4 5 "

Mapa de caracteres

Consulte a referência da função Char para duas Sequence funções trabalhando juntas para exibir um mapa de caracteres em um layout bidimensional.

Tabuleiro de Xadrez

Consulte a referência do operador As para duas Sequence funções trabalhando juntas para criar um tabuleiro de xadrez em uma cadeia de texto e em duas galerias aninhadas.