Sair do Laço
Objeto que permite sair do laço de repetição da operação desejada
Visão Geral
O objeto Sair do Laço tem como objetivo interromper definitivamente a execução de uma estrutura de repetição (loop), forçando o robô a abandonar o ciclo atual e todas as iterações subsequentes, continuando o fluxo de automação a partir do primeiro objeto localizado fora (após) o laço.
Funcionamento

Ao ser acionado durante o fluxo do robô, o comando diz ao motor de execução para cancelar a repetição da lista ou array que está sendo processada no momento. O robô não avaliará os próximos itens da estrutura e seguirá imediatamente para as próximas etapas do processo que estão fora do bloco de repetição.
Quando usar
Quando o robô estiver procurando por uma informação específica dentro de uma lista e, ao encontrá-la, não houver mais necessidade de continuar varrendo os itens restantes (otimizando o tempo de execução).
Quando uma condição de erro crítico for atingida no meio de um laço e for necessário abortar o processamento em lote para seguir para uma etapa de tratamento de erros fora do loop.
Quando não usar
Quando o objetivo for ignorar apenas o item atual e continuar processando os próximos itens da lista (neste caso, utilize o objeto "Próximo Laço").
Fora de estruturas de repetição, pois causará erro de compilação ou execução, uma vez que não há um laço para ser interrompido.
Configuração

CAMPO
DESCRITIVO
Título
É o nome do objeto e não precisa ser alterado, a menos que você queira identificá-lo para facilitar a leitura do fluxo, por exemplo: "Sair do Laço - Registro Encontrado".
Estrutura de Bloco
Na interface do fluxo de trabalho (Studio), o Sair do Laço atua como um objeto de controle posicionado dentro do bloco de um laço de repetição (como o "Varrer Lista Json"). Conforme descrito na própria interface, sua função exclusiva neste contexto é: "Interrompe a repetição da lista json".
Exemplos
Exemplo simples
Em um laço que verifica 100 itens, adicionar uma condição ("Se") para checar se a variável {item_encontrado} é igual a true. Se for, o fluxo entra na condição e aciona o Sair do Laço, encerrando a repetição na mesma hora, mesmo que o robô ainda estivesse no item 10.
Exemplo aplicado
Um robô recebe uma lista JSON contendo 500 registros de clientes. Ele precisa localizar o cliente cujo CPF seja "123.456.789-00" e extrair o seu e-mail. O robô inicia um "Varrer Lista Json" e, a cada iteração, compara o CPF do item atual com o CPF desejado. Ao encontrar a correspondência exata, o robô salva o e-mail em uma variável e imediatamente executa o objeto Sair do Laço. Isso evita que o robô desperdice recursos do sistema verificando os outros registros restantes da lista de forma inútil.
Erros comuns e como evitar
Objeto posicionado incorretamente sem condicional: Colocar o objeto Sair do Laço solto no fluxo principal do laço, sem estar protegido por uma condição (objeto "Se"). Isso fará com que o laço execute apenas a primeira iteração e seja interrompido imediatamente, impedindo o processamento correto da lista. Este objeto deve sempre ser consequência de uma tomada de decisão.
Uso em fluxo linear: Inserir este objeto em uma área do robô que não esteja encapsulada por um bloco de repetição. O objeto falhará ao tentar executar uma quebra de laço inexistente.
Boas práticas
Altere o campo "Título" para indicar claramente o motivo que levou o robô a abortar o laço (ex:
Sair do Laço - Cliente EncontradoouSair do Laço - Falha na API). Isso torna o fluxo autoexplicativo e facilita muito a manutenção.
Last updated
Was this helpful?

