Anatomia de uma ação
Depois de adicionar uma ação ao fluxo, ela aparece como um card e pode ser clicada para abrir o Painel de Configuração no lado direito da tela. Entender esses elementos é fundamental para configurar e usar ações corretamente.
O card da ação
O card exibe visualmente o estado da ação no fluxo:
| Elemento | Descrição |
|---|---|
| Ícone | Representa o tipo da ação (ex.: ícone de navegador, planilha, etc.) |
| Título | Nome da ação (ex.: "Abrir navegador", "Inserir texto") |
| ID | Identificador único da ação, exibido como #identificador (ex.: #abrirNavegador) |
O ID é gerado automaticamente, mas pode ser personalizado para algo mais descritivo. Ele é usado para referenciar o retorno dessa ação em outras ações do fluxo.
O Painel de Configuração
Ao clicar em um card, o painel lateral é aberto. Ele é dividido nas seguintes seções:
1. Identidade da ação
No topo do painel estão as informações básicas da ação:
- ID da ação: Identificador único que será usado para referenciar os retornos desta ação. Deve ser único no fluxo, não pode começar com número e pode conter apenas letras, números e
_. - Versão: Quando uma ação possui mais de uma versão disponível, é possível selecionar qual utilizar. Recomenda-se sempre usar a versão mais recente.
Alterar o ID de uma ação após outras ações já estarem referenciando seus retornos pode quebrar essas referências. Defina o ID antes de conectar ações entre si.
2. Configuração da ação (Parâmetros de Entrada)
Esta é a seção principal, onde você preenche os campos que a ação precisa para executar. Cada ação tem um conjunto próprio de campos, mas todos seguem os mesmos tipos visuais.
Para aprender sobre todos os tipos de campos disponíveis, consulte o tutorial Tipos de campos de entrada.
3. Campos de saída (Retornos)
Após a seção de configuração, há um painel retrátil chamado Campos de saída (ou Retornos). Ele lista os valores que a ação produzirá após a execução e que poderão ser usados por outras ações.
Cada campo de saída exibe:
- Nome do campo: O identificador que será usado para acessar o valor (ex.:
value,filePath,exists). - Descrição: O que esse valor representa.
- Tipo: A categoria do valor (Texto, Número, Booleano, etc.), exibida como uma etiqueta colorida.
- Checkbox: Marca se aquele campo estará disponível para uso por outras ações.
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.
Para saber como usar esses retornos em outras ações, consulte o tutorial Encadeamento de ações.
4. Opções de execução
Ao final do painel, as Opções de execução controlam o comportamento do robô caso a ação apresente algum problema:
| Opção | Descrição |
|---|---|
| Parar o robô em caso de erro | Define se o robô deve interromper a execução ao encontrar um erro nesta ação. Se Não, o robô pula a ação com erro e continua. |
| Número de tentativas | Quantas vezes a ação será repetida antes de ser considerada como falha. Mínimo: 1. |
Para mais detalhes sobre como executar e monitorar ações, consulte o tutorial Execução e monitoramento.
5. Salvar
Após preencher todos os campos, clique no botão Salvar para confirmar as configurações. O painel se fecha e o card é atualizado com as novas configurações.
O botão Salvar ficará desativado se o ID da ação for inválido (ex.: já utilizado em outra ação, começar com número ou conter caracteres especiais). Corrija o ID antes de salvar.
Próximos passos
- Tipos de campos de entrada — Conheça todos os tipos de campos disponíveis
- Encadeamento de ações — Use retornos de uma ação em outra
- Execução e monitoramento — Controle a execução e acompanhe o status das ações