# Ciclo

O ciclo permite repetir uma sequência de ações (blocos) várias vezes e contar o número de iterações do ciclo, registrando a quantidade atual em uma variável especial (especificada na propriedade "Ciclo"), que pode ser utilizada em outros blocos.

Na primeira entrada no bloco, o valor da variável da propriedade "Ciclo" é igualado ao "Valor Inicial" (![](https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-33a85e1e795700b990145706b87c8d07c6cc7c46%2F%D0%B8%D0%B7%D0%BE%D0%B1%D1%80%D0%B0%D0%B6%D0%B5%D0%BD%D0%B8%D0%B5%20\(174\).png?alt=media)), e então a execução do cenário continua em direção à saída "Ciclo" deste bloco (no chamado "corpo do ciclo").

<figure><img src="https://1245874961-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2Fti2Raw08aYi0Vr2rkcD9%2Fuploads%2Fgit-blob-191c958b45df2e2df033e766a7e80306d7a8e830%2F%D0%A6%D0%B8%D0%BA%D0%BB.png?alt=media" alt=""><figcaption></figcaption></figure>

Assim que a execução do cenário chegar novamente a este bloco, o valor da variável "Ciclo" será incrementado pelo valor do "Passo", e ocorrerá novamente a transição em direção à saída "Ciclo". Assim que o valor da variável "Ciclo" for maior ou igual ao "Valor Final", a execução do cenário continuará em direção à saída inferior do bloco. Não se esqueça de conectar a saída do último bloco no corpo do ciclo à entrada deste bloco ou de algum dos blocos anteriores.

<table data-header-hidden><thead><tr><th width="247" valign="top"></th><th width="311" valign="top"></th></tr></thead><tbody><tr><td valign="top">Valor Inicial</td><td valign="top">[Número] Valor inicial da variável da propriedade Ciclo, que será atribuído a esta variável no início do ciclo.</td></tr><tr><td valign="top">Valor Final</td><td valign="top"><p>[Número] Valor final da variável da propriedade Ciclo.</p><p>As iterações do ciclo serão executadas enquanto o valor da variável Ciclo for menor que o especificado nesta propriedade.</p></td></tr><tr><td valign="top">Passo</td><td valign="top"><p>[Número] Passo de incremento do valor da variável da propriedade Ciclo em cada iteração do ciclo.</p><p>O passo pode ter um valor negativo, o que é útil quando o Valor Inicial é maior que o Valor Final, e é necessário contar na direção inversa.</p></td></tr><tr><td valign="top">Ciclo</td><td valign="top">[Número] Variável na qual será registrado o valor atual do ciclo. Por exemplo, se: <code>Valor Inicial = 0</code>, <code>Valor Final = 7</code>, e <code>Passo = 2</code>, então os valores do ciclo serão sequencialmente os números <code>0</code>,<code>2</code>,<code>4</code>,<code>6</code>.</td></tr><tr><td valign="top">Nível de Tratamento</td><td valign="top"><p>Seleção do nível de tratamento de erros. Valores possíveis:</p><ul><li>"Default" - padrão;</li><li>"Ignore" - erros são ignorados;</li><li>"Handle" - erros são tratados.</li></ul><p>Se o valor "Default" for escolhido, será utilizado o valor do bloco "Início" deste diagrama.</p></td></tr><tr><td valign="top">Direção de Saída</td><td valign="top"><p>Seleção da direção de saída do bloco em caso de erro. Valores possíveis:</p><ul><li>"Default" - padrão;</li><li>"Right" - para a direita;</li><li>"Bottom" - para baixo.</li></ul><p>Esta propriedade permite definir a direção de saída em caso de erros para blocos que não contêm o conector "Se erro" (por exemplo, bloco "Condição").</p><p>Se o valor "Default" for escolhido, será utilizado o valor do bloco "Início" deste diagrama.</p></td></tr><tr><td valign="top">Nível de Mensagens</td><td valign="top"><p>Seleção do nível de mensagens que os blocos exibirão durante a execução. Valores possíveis:</p><ul><li>"Default" - padrão;</li><li>"Release" - saída desativada;</li><li>"Debug" - saída de informações principais;</li><li>"Detailed" - saída de informações detalhadas.</li></ul><p>Se o valor "Default" for escolhido, será utilizado o valor do bloco "Início" deste diagrama.</p></td></tr><tr><td valign="top">Texto de Erro</td><td valign="top">[Texto] Retorna informações detalhadas sobre o erro em caso de execução incorreta do bloco.</td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.sherparpa.ru/pt/sherpa-rpa/sherpa-designer/spravochnik-blokov/osnovnye-bloki-main-blocks/cikl-for.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
