--- title: "Comportamento do Bloco Array" description: "Como funciona o comportamento em Loop do Array" url: https://help.datacrazy.io/pt-br/articles/10670818-comportamento-do-bloco-array collection: "Automações" updated: 2026-08-10 language: pt-br --- # Comportamento do Bloco Array Como funciona o comportamento em Loop do Array ## Visão Geral O **Bloco Array (Loop)** é utilizado para percorrer e processar uma lista de itens dentro de um fluxo de automação. Cada item da coleção é executado individualmente, seguindo a sequência definida no fluxo. Para garantir a estabilidade da execução, o bloco possui algumas limitações e recomendações que devem ser observadas. * * * ## Limite de Processamento O Bloco Array pode processar **até 20 itens por execução contínua**. Quando a lista contém **20 itens ou menos**, todos os elementos são executados normalmente, de forma sequencial e sem necessidade de configurações adicionais. > **Limite máximo por execução:** **20 itens** * * * ## Execução Acima de 20 Itens Ao tentar processar **mais de 20 itens consecutivamente**, sem qualquer intervalo entre as execuções, o fluxo poderá atingir o limite de processamento do sistema. Nessa situação, a execução normalmente é interrompida e é exibida uma mensagem de erro relacionada a **Loop**, geralmente apresentada em inglês. Esse comportamento ocorre porque as iterações são executadas rapidamente, ultrapassando o limite permitido pelo mecanismo de execução. * * * ## Como Processar Listas Maiores Para percorrer listas com mais de 20 itens, recomenda-se utilizar um **Bloco de Temporizador (Espera)** entre cada iteração. O funcionamento é o seguinte: 1. O Bloco Array processa um item da lista. 2. O fluxo segue para um Bloco **Wait**, realizando uma pausa pelo tempo configurado. 3. Após a espera, o fluxo retorna ao Bloco Array. 4. O Array continua automaticamente a partir do próximo item da lista. 5. O processo se repete até que todos os itens sejam processados. Esse método reduz a velocidade das execuções e evita que o sistema identifique um loop excessivamente rápido. ### Fluxo recomendado ```text Array ↓ Processa 1 item ↓ Wait (Tempo de espera) ↓ Retorna ao Array ↓ Processa próximo item ↓ ... ``` Utilizando essa estratégia, é possível processar listas com qualquer quantidade de itens sem gerar erros relacionados ao limite de execução. * * * ## Restrição de Utilização Durante uma execução do fluxo, **apenas um Bloco Array pode estar ativo**. Não é permitido utilizar múltiplos Blocos Array executando simultaneamente dentro do mesmo fluxo. Caso seja necessário realizar novos percursos em listas, eles deverão ocorrer após a conclusão da execução do Array atual. * * * ## Boas Práticas - Utilize o Bloco Array para percorrer listas de forma sequencial. - Evite processar mais de 20 itens continuamente sem pausas. - Para listas extensas, utilize um Bloco **Wait** entre as iterações. - Mantenha apenas um Bloco Array ativo por execução do fluxo. - Sempre teste o fluxo antes de utilizá-lo em produção. * * * ## Resumo Regra Descrição

Limite por execução contínua	20 itens
Acima de 20 itens sem pausa	Pode gerar erro de Loop
Solução recomendada	Inserir um Bloco Wait entre cada iteração
Funcionamento recomendado	Processar 1 item → Wait → Retornar ao Array
Restrição	Apenas 1 Bloco Array pode estar ativo por execução do fluxo