Skip to main content
Acessar Studio

Encadeamento de ações

Um dos recursos mais poderosos do Designer é a capacidade de encadear ações — ou seja, usar o resultado de uma ação como entrada de outra. Isso permite criar fluxos complexos onde cada ação se baseia nos resultados das anteriores.

Como funciona​

Quando uma ação é executada pelo robô, ela armazena seus retornos com base no ID da ação. Para acessar esses valores em outra ação, basta referenciar ID_da_acao.campo.

Exemplo prático​

Vamos considerar um fluxo de login em um sistema web:

1. [Abrir navegador]  →  ID: abrirNavegador
   Retorno disponível: sessão do navegador

2. [Obter elemento]   →  ID: obterCampoSenha
   Usa: abrirNavegador (sessão do navegador)
   Seletor: input#senha
   Retorno disponível: o elemento do campo senha

3. [Inserir texto]
   Usa: obterCampoSenha.element (o campo obtido na ação anterior)
   Texto: ••••••••

Neste exemplo:

  • A ação 2 usa a sessão do navegador criada pela ação 1
  • A ação 3 usa o elemento obtido pela ação 2

Passo a passo para referenciar um retorno​

  1. Em uma ação posterior no fluxo, localize o campo que deseja preencher com o retorno.
  2. Clique no ícone de tipo à esquerda do campo (campos dinâmicos).
  3. Na janela que abrir, acesse a aba Ações do robô.
  4. Localize a ação cujo retorno deseja usar (as ações são listadas pelo ID).
  5. Expanda a ação e selecione o campo de saída desejado (ex.: value, element, filePath).
  6. O campo exibirá o formato idDaAcao.campo (ex.: obterTexto.value).
info

Somente as ações que aparecem antes da ação atual no fluxo estarão disponíveis para referência. Ações posteriores não podem ser referenciadas.

Ativando campos de saída​

Para que um retorno de ação fique disponível para outras ações, ele precisa estar ativado na seção Campos de saída da ação que o produz.

Para ativar um campo de saída:

  1. Clique na ação que produz o retorno
  2. No Painel de Configuração, expanda a seção Campos de saída
  3. Marque o checkbox ao lado dos campos que você deseja usar em outras ações
  4. Salve a ação
tip

Ative apenas os campos de saída que você realmente precisará nas próximas ações do fluxo. Isso mantém o fluxo organizado e facilita a localização dos retornos ao configurar ações subsequentes.

Boas práticas​

Use IDs descritivos​

Ao invés de manter os IDs automáticos gerados pelo Designer, use nomes descritivos que deixem claro o propósito da ação:

  • ❌ action1, action2, action3
  • ✅ abrirNavegador, obterCampoSenha, fazerLogin

Isso torna o fluxo mais legível e facilita a manutenção.

Verifique as referências antes de alterar IDs​

Se você alterar o ID de uma ação que já está sendo referenciada por outras ações, essas referências ficarão quebradas. Sempre verifique quais ações dependem de um retorno antes de alterar o ID da ação que o produz.

Organize o fluxo logicamente​

Mantenha as ações em uma ordem lógica e clara. Ações que produzem retornos devem estar posicionadas antes das ações que os consomem.

Próximos passos​