Erro "The template language function 'range' parameters are out of range"
O range cria uma lista de números consecutivos, e o segundo parâmetro é a quantidade. Essa quantidade tem de ser um inteiro positivo de, no máximo, 100.000, e a soma do início com a quantidade não pode passar de 2.147.483.647. O erro aparece quando a...
A mensagem completa
The template language function 'range' parameters are out of range: 'count' must be a positive integer no larger than '100000' and the sum of 'start index' and 'count' must be no larger than 2147483647. Please see https://aka.ms/logicexpressions#range for usage details.
No histórico de execuções, essa mensagem aparece dentro de uma frase maior: Unable to process template language expressions in action 'NOME_DA_ACAO' inputs at line '0' and column '0': '...'. O nome da ação é o da ação que contém a expressão e muda de fluxo para fluxo. O trecho em destaque acima é o que identifica o problema.
O que significa
O range cria uma lista de números consecutivos, e o segundo parâmetro é a quantidade. Essa quantidade tem de ser um inteiro positivo de, no máximo, 100.000, e a soma do início com a quantidade não pode passar de 2.147.483.647. O erro aparece quando a quantidade é zero, negativa ou grande demais.
Causas mais comuns
- A quantidade vem de uma conta que deu zero ou negativo, como length(lista) menos um.
- A quantidade vem de uma contagem que ficou vazia ou nula.
- A lista pedida é maior que 100.000 itens.
- O início e a quantidade foram trocados na ordem dos parâmetros.
Como corrigir
- Garanta que a quantidade é maior que zero antes de chamar o range, com uma condição que pule a etapa quando ela for zero.
- Confira de onde vem a quantidade: uma conta como length(lista) menos 1 pode dar zero ou negativo.
- Para listas grandes, divida o trabalho em partes menores.
- Lembre: o primeiro parâmetro é o início e o segundo é a quantidade, e não o fim.
Exemplo: antes e depois
| Expressão | Resultado no Power Automate |
|---|---|
range(1,-1) | Erro. The template language function 'range' parameters are out of range: 'count' must be a positive integer no larger than '100000' and the sum of 'start... |
range(1,3) | [1,2,3] |
Os dois resultados vêm da execução real de 09/11/2026, e um teste automático do Me Ajuda Flow confere que o texto desta página é idêntico ao registrado.
Como evitar que o erro volte
- Veja o valor real: abra a execução e confira a entrada da ação que falhou, não só a expressão.
- Trate vazio e tipo antes de calcular: use
coalescepara vazio eintoufloatpara texto que parece número. - Confira a expressão antes de rodar: o analisador de fluxo e o verificador de expressões apontam parte desses problemas sem executar o fluxo.
Perguntas frequentes
range(1,3) devolve quais números?
[1,2,3]: começa em 1 e gera 3 números.
Existe lista vazia pelo range?
Não, com count zero o range falha. Use uma condição para pular a etapa.