Chamar Rotina

Visão Geral

O objeto Chamar Rotina executa uma rotina previamente criada dentro do fluxo principal. Ele é utilizado para reutilização de lógica, organização do processo e padronização de comportamentos comuns, evitando duplicação de componentes.

Uma rotina pode conter ações simples, blocos condicionais e retornos customizados, funcionando como um subfluxo reutilizável.

---

Funcionamento

Ao ser executado, o objeto:

1. Identifica a rotina selecionada.

2. Executa todos os componentes definidos dentro da rotina.

3. Retorna ao fluxo principal após a finalização da rotina.

4. Opcionalmente, valida o retorno da rotina, quando configurado.

A execução ocorre de forma sequencial, respeitando a lógica interna da rotina chamada.

Quando usar

• Para reutilizar fluxos comuns em diferentes processos.

• Para centralizar lógicas repetidas (ex.: abrir navegador, login, validações).

• Para tornar o fluxo principal mais limpo e legível.

• Para padronizar retornos e tratamento de erros.

Quando não usar

• Para ações únicas que não serão reutilizadas.

• Quando a lógica é simples e não justifica uma rotina separada.

• Para controle condicional direto (use blocos de decisão).

---

Configuração

CAMPO	DESCRITIVO
Título	Nome exibido no fluxo do robô. Pode ser ajustado para indicar o contexto da chamada. Exemplo: “Chamar rotina – Login”.
Rotina	Rotina que será executada. Deve estar previamente criada no projeto.
Validar retorno?	Quando habilitado, ativa a validação do retorno da rotina na aba Validação.

Parâmetros

Caso a rotina selecionada possua parâmetros configurados, eles serão exibidos automaticamente nesta aba.

Parâmetros de Entrada

Os Parâmetros de Entrada representam os valores que o fluxo principal envia para a rotina no momento da execução.

Cada parâmetro possui:

• Nome: definido na criação da rotina.

• Valor: informado no objeto Chamar Rotina, podendo ser texto fixo, variável ou expressão.

Esses valores ficam disponíveis dentro da rotina para uso em ações, validações e decisões.

Exemplo:

• Parâmetro de entrada: url

• Valor informado: https://roboteasy.tech

Dentro da rotina, a variável url será utilizada para abrir o navegador no endereço correto.

Parâmetros de Saída

Os Parâmetros de Saída representam dados que a rotina pode retornar para o fluxo principal após sua execução.

• Eles são definidos na rotina.

• Quando existentes, ficam visíveis na aba Parâmetros do objeto Chamar Rotina.

• Seus valores podem ser utilizados após a execução da rotina.

Caso a rotina não possua parâmetros de saída, a seção será exibida como Nenhum dado.

---

Validação

Quando a opção Validar retorno? estiver habilitada, o objeto passa a avaliar o resultado retornado pela rotina executada.

A validação funciona como um controle condicional baseado no retorno da rotina.

Funcionamento da validação

Após a execução da rotina:

1. O retorno da rotina é capturado.

2. A condição configurada é avaliada.

3. Se a condição for verdadeira, a ação configurada é executada.

4. Se a condição for falsa, o fluxo segue normalmente após o objeto.

Configuração da validação

CAMPO	DESCRITIVO
Condição	Expressão lógica utilizada para validar o retorno da rotina. Exemplo: codigoRetorno == "RPA001".
Código	Variável que receberá o código retornado pela rotina.
Mensagem	Variável que receberá a mensagem retornada pela rotina.
Ação se a condição for verdadeira	Define a ação que será executada quando a condição for atendida.
Dados	Informações adicionais retornadas pela rotina. Pode ser convertido para JSON, se necessário.

---

Ação: Retornar

Quando a ação Retornar é selecionada:

• O fluxo atual é encerrado imediatamente.

• O código, mensagem e dados configurados são propagados como retorno do processo.

Essa ação é recomendada quando a rotina representa uma etapa crítica, cujo erro impede a continuidade do fluxo.

Ações de Validação em Laços

As ações Continuar e Parar ficam disponíveis quando o objeto Chamar Rotina está dentro de um laço (ex.: While, For Each).

Nesses casos, a ação escolhida controla o comportamento do laço, e não apenas da rotina.

Ação: Continuar

A ação Continuar interrompe a iteração atual do laço e inicia imediatamente a próxima iteração.

• O restante do fluxo dentro do laço, após o Chamar Rotina, não é executado nessa iteração.

• O laço continua normalmente, avaliando sua condição novamente.

Quando usar:

• Para ignorar um item com erro e seguir para o próximo.

• Em processamento de listas ou arquivos, quando uma falha não deve interromper todo o laço.

Exemplo:

• Processar lista de arquivos

• Se uma rotina falhar para um arquivo → Continuar

• Próximo arquivo é processado

---

Ação: Parar

A ação Parar encerra imediatamente o laço em que o Chamar Rotina está inserido.

• Nenhuma outra iteração do laço será executada.

• O fluxo continua após o laço.

Quando usar:

• Quando uma falha torna inviável continuar o processamento.

• Quando uma condição crítica é atendida e o laço não faz mais sentido.

Exemplo:

• Tentativas de login

• Se a rotina retornar erro crítico → Parar

• Fluxo segue para tratativa fora do laço

---

Diferença entre Retornar, Continuar e Parar

Ação	Comportamento
Retornar	Encerra o fluxo atual e retorna código, mensagem e dados
Continuar	Interrompe a iteração atual do laço e segue para a próxima
Parar	Encerra completamente o laço

---

Observação importante

As ações Continuar e Parar só fazem sentido quando o objeto Chamar Rotina está dentro de um laço. Fora desse contexto, a ação adequada normalmente é Retornar.

Robô Exemplo

10KB

Chamar Rotina - Robô Exemplo.roboteasy

Open