Pular para o conteúdo principal
Acessar Studio
Tutoriais

Encadeamento de ações

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).
informação

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
dica

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.

Encadeamento em campos de código​

Quando você usa o modo Código em um campo dinâmico, tem acesso direto ao objeto actions para referenciar os retornos de ações anteriores:

typescript
// Sintaxe: actions["id_ou_alias_da_acao"]["campo_de_retorno"]
const texto = actions["obterTexto"]["value"]
const elemento = actions["localizarBotao"]["element"]

// Exemplo: montar uma mensagem combinando retornos
const mensagem = `${actions["lerNome"]["value"]} — ${actions["lerCodigo"]["value"]}`
return mensagem

O ID da ação é exibido no topo do painel de configuração no Designer. Se a ação tiver um alias definido, use o alias no lugar do ID.

dica

O editor de código oferece autocomplete para os retornos das ações anteriores. Ao digitar actions[", as ações disponíveis e seus campos de saída são sugeridos automaticamente.

Próximos passos​