Tipos de campos de entrada
Ao configurar uma ação no Painel de Configuração, você encontrará diferentes tipos de campos de entrada. Cada tipo foi projetado para um propósito específico e oferece controles visuais adequados. Este guia explica todos os tipos disponíveis.
Seleção (Dropdown)
Um campo de lista suspensa com opções pré-definidas. Clique para abrir a lista e escolha uma opção.
Exemplo: O campo Tipo de carregamento da ação Recarregar uma página exibe as opções networkidle, domcontentloaded e load.
Seletor de modo ("Selecione a ação:")
Muitas ações possuem um campo especial chamado "Selecione a ação:" (ou similar) que controla quais outros campos aparecem na tela. Ele funciona como um seletor de modo e deve ser configurado primeiro.
Exemplo: Na ação Inserir texto, ao selecionar Por navegador, os campos ID da página ou navegador e Seletor do elemento ficam disponíveis. Ao selecionar Por elemento, esses campos são substituídos pelo campo ID do elemento.
Sempre configure o campo "Selecione a ação:" antes dos demais, pois ele determina quais campos estarão disponíveis.
Texto
Um campo de entrada livre para digitar qualquer valor, como uma URL, um seletor CSS ou um nome de arquivo.
Exemplo: O campo Seletor do elemento da ação Clicar em elemento espera um seletor CSS como button#enviar ou input.campo-nome.
Número
Um campo para entrada de valores numéricos, geralmente com validações de mínimo e máximo.
Exemplo: O campo Delay em milissegundos da ação Pressionar uma tecla aceita qualquer número inteiro positivo.
Sim/Não (Toggle)
Um campo de alternância que representa uma opção ligada ou desligada. Clique para alternar entre os dois estados.
Exemplo: O campo Limpar o input antes de digitar? da ação Inserir texto ativa ou desativa a limpeza do campo antes da digitação.
Campo dinâmico (Ícone de seleção de tipo)
Este é o tipo de campo mais poderoso do Designer. Ele permite que o valor seja definido de quatro formas diferentes, selecionáveis pelo ícone à esquerda do campo:
| Tipo | Ícone | Quando usar |
|---|---|---|
| Texto | Arquivo de texto | O valor é fixo e digitado diretamente. Exemplo: https://roberty.app. |
| Número | Numérico | O valor é um número fixo. |
| Código | Chaves {} | O valor é calculado por uma expressão JavaScript. Exemplo: new Date().toISOString(). |
| Retorno de outra ação | Ícone de ação | O valor vem do retorno de uma ação executada anteriormente no fluxo. |
| Parâmetro do robô | Ícone de parâmetro | O valor vem de um parâmetro ou segredo configurado no robô. |
| Variável | Ícone de variável | O valor vem de uma variável criada durante o fluxo. |
Como usar campos dinâmicos
- Localize o campo que possui o ícone de tipo à esquerda
- Clique no ícone para abrir a janela de seleção
- Escolha o tipo de valor desejado (Texto, Código, Retorno, etc.)
- Configure o valor de acordo com o tipo selecionado
Para retornos de outras ações:
- Clique no ícone e acesse a aba Ações do robô
- Localize a ação cujo retorno deseja usar (as ações são listadas pelo ID)
- Expanda a ação e selecione o campo de saída desejado (ex.:
value,element,filePath) - O campo exibirá o formato
idDaAcao.campo(ex.:obterTexto.value)
Para mais detalhes sobre como usar retornos de ações, consulte o tutorial Encadeamento de ações.
Seleção de ação anterior (Dropdown de ação)
Alguns campos esperam especificamente uma ação anterior como referência, como o campo ID da página ou navegador. Nesses casos, o campo exibe um dropdown filtrado que mostra apenas as ações compatíveis já existentes no fluxo.
Exemplo: O campo ID da página ou navegador da ação Clicar em elemento lista apenas as ações Abrir navegador, Nova aba, Obter aba e Obter Iframe — pois são as únicas que produzem uma sessão de navegador.
Este tipo de campo facilita a referência a ações específicas, garantindo que apenas ações compatíveis sejam selecionadas.
Próximos passos
- Encadeamento de ações — Use retornos de uma ação em outra
- Anatomia de uma ação — Entenda a estrutura completa de uma ação
- Execução e monitoramento — Controle a execução e acompanhe o status das ações