Liga a captura do download. Ligado com Tipo de Evento Preencher em vez de Clicar, a tela avisa que a combinação não tem efeito: o download nunca é capturado nesse evento.
Download
Capture o arquivo que um clique baixa no navegador, decida se ele sobrevive à execução, e entenda como o agente sabe que o download realmente terminou.
Nesta página
Ativação e permanência do arquivo
Download só existe na ação Preencher, e só tem efeito com Tipo de Evento Clicar: é o clique que dispara o download no navegador, e o motor só arma a captura dentro desse ramo. Configurar um download exige duas decisões:
- Capturar o arquivo baixado. Ligue Esse mapeamento dispara download?. Isso já é suficiente: o arquivo cai numa pasta interna da execução, disponível como dado do processo (nome, caminho em disco e conteúdo binário), e é apagado automaticamente quando a execução termina.
- Manter o arquivo depois da execução. Ligue também Manter o download após a execução? e informe a Pasta de Destino do Download, um caminho real na máquina onde o agente roda.
Configuração no mapeamento
Os campos ficam na seção Gestão de Arquivos do mapeamento:
Esse mapeamento dispara download?
booleano
Manter o download após a execução?
booleano
Só aparece com o download ligado. Desligada (padrão): o arquivo fica numa pasta interna da execução, apagada automaticamente ao final, tanto em caso de sucesso quanto de erro, sem pedir caminho nenhum. Ligada: a Pasta de Destino do Download vira obrigatória.
Pasta de Destino do Download
caminho
Só aparece (e só é obrigatória) com Manter ligado. Um caminho real na máquina onde o agente roda, que pode ser outra máquina, com outro sistema operacional, do que a que você está usando agora. Ex.: C:\Notas no Windows, /home/usuario/notas no Linux/Mac.
Usado exatamente como você escreve, sem nenhum ajuste: o agente não quebra o texto em pedaços nem reconstrói. Aceita variável, então dá para separar por execução: C:\Notas\{numeroNota}. Barra normal ou invertida tanto faz.
Variáveis geradas
Com o download ligado e bem-sucedido, três variáveis ficam disponíveis pro resto do fluxo automaticamente, sem precisar configurar Resultado nem etapa nenhuma para elas existirem. Use o Nome dado à linha de mapeamento (o mesmo campo Nome do Mapeamento, no topo do painel) como prefixo:
| Variável | Conteúdo |
|---|---|
{NomeDoMapeamento} | Nome do arquivo baixado (ex.: nota-1234.pdf). |
{NomeDoMapeamento.FILE} | Caminho completo do arquivo em disco, na máquina onde o agente roda. |
{NomeDoMapeamento.BUFFER} | Conteúdo do arquivo em base64. Pronto para anexar numa mensagem ou mandar no Body de uma Chamada API Rest, sem precisar reler o arquivo do disco. |
Sufixo parecido, dado diferente.
{NomeDoMapeamento.evidence} e {NomeDoMapeamento.evidence_BUFFER} também existem, mas são a evidência (screenshot) daquele mapeamento, não o arquivo baixado. Vêm de Gerar Evidência?, um campo separado. Não confunda os dois pares.
As três só existem quando Esse mapeamento dispara download? está ligado: sem isso, elas nunca são criadas. Com o download ligado mas sem sucesso (nada encontrado, estourou algum dos tetos de espera abaixo, ou falha ao ler), as três SÃO criadas como texto vazio (""), nunca null nem erro de referência quebrada, antes da etapa gerar a exceção formal descrita a seguir. Se a Gestão de Erros e Exceções da etapa estiver configurada para seguir mesmo assim, é esse texto vazio que uma etapa seguinte recebe.
Arquivo com dado pessoal
Se o arquivo baixado carrega dado pessoal (uma nota fiscal, um extrato), ligue Dado sensível? na linha de mapeamento (veja Mapeamento em Preencher). As variáveis derivadas (
.FILE, .BUFFER e o texto de OCR) ficam fora do estado guardado do debug e do arquivo de teste dos scripts, e a etapa não gera imagem da tela. O nome do arquivo baixado, porém, é registrado no log como veio. Veja Dados Sensíveis.
Como o agente sabe que terminou
Depois do clique, o agente não confia num tempo de espera chutado. Ele verifica a Pasta de Destino do Download (interna ou a que você informou) até duas condições serem verdadeiras ao mesmo tempo, em duas checagens seguidas:
- Não sobra nenhum arquivo temporário de download em andamento na pasta.
- O tamanho do arquivo final parou de mudar.
Só então o arquivo é lido. A extensão do arquivo temporário depende do navegador que o agente usa:
| Navegador | Extensão do arquivo temporário |
|---|---|
| Chrome / Chromium / Edge | .crdownload |
O Timer de "Aguardar Após Executar" não precisa cobrir o tempo de download. A detecção de conclusão descrita acima roda de forma independente desse campo. Use o Timer, disponível por mapeamento, para outros motivos: dar tempo de uma animação terminar, ou de um redirecionamento acontecer.
Teto de espera: o que acontece se nunca terminar
Um download pode nunca terminar, ou nunca nem começar: a internet cai no meio, o site trava, ou o clique simplesmente não disparou download nenhum (um PDF que abre direto na aba do navegador em vez de baixar é o caso mais comum). São situações diferentes, e o agente trata cada uma com um teto próprio:
Nenhum arquivo em 15 segundos: o agente desiste de esperar. Se nenhum arquivo, nem temporário, aparece na pasta dentro desse tempo, o agente considera que o download não vai acontecer e para de esperar.
Download iniciado sem concluir em 5 minutos: o agente desiste de esperar. Esse teto cobre arquivo grande em conexão lenta. Esgotado o tempo sem confirmar a conclusão, o agente trata como se nenhum arquivo tivesse sido encontrado.
Nos dois casos, um aviso é registrado no log do processo, citando o mapeamento e a pasta onde procurou, e a etapa gera uma exceção formal, tratada como qualquer outro erro de etapa pela Gestão de Erros e Exceções. Sem nenhuma tolerância configurada nessa etapa, o processo termina ali; configure retentativa ou contorno se um download ausente não deve interromper a automação.
Um arquivo temporário abandonado na pasta (de um download que travou) nunca é confundido com o arquivo final: ele é ignorado tanto na detecção de conclusão quanto na leitura do resultado, então o agente nunca devolve um download pela metade como se fosse o arquivo completo.
Download e OCR
Quando Aplicar OCR no arquivo de download? está ligado no mesmo mapeamento, o OCR lê o arquivo que acabou de ser baixado, antes de qualquer limpeza, mesmo que o arquivo vá ser apagado ao final da execução.
Se o download falhar ou nunca acontecer (os mesmos tetos de espera da seção anterior), a etapa gera uma exceção formal antes de chegar ao OCR: não existe uma pasta vazia ou um arquivo de outra execução para ler. Veja mais em OCR / ICR.
Download na Sandbox
Download é bloqueado no Ambiente Sandbox. A varredura pré-voo recusa o agente inteiro antes de rodar, para qualquer mapeamento com download ligado, independente de Manter o download após a execução? estar ligado ou não. Para automações que dependem de download, use um Ambiente Runtime próprio. Veja o que a Sandbox não comporta.
Boas práticas
- Só ligue "Manter" quando precisar do arquivo depois. Na maioria dos casos o dado que importa já foi extraído (por OCR, ou porque o próprio arquivo é o resultado enviado por mensageria): deixar na pasta interna evita acumular arquivo em disco sem necessidade.
- Confirme o caminho antes de publicar. A Pasta de Destino do Download é usada como está: um caminho digitado errado (ou que não existe na máquina do agente) não é adivinhado nem corrigido.
- Configure a Gestão de Erros e Exceções da etapa. Desde que um download ausente virou exceção formal, uma etapa sem nenhuma tolerância configurada termina o processo no primeiro download que falhar. Veja Gestão de Erros e Exceções para configurar retentativa ou contorno onde isso for esperado.
- Acompanhe o log quando um download for crítico. O aviso do teto de espera aponta exatamente o mapeamento e a pasta envolvidos: é o primeiro lugar a olhar quando um resultado esperado não aparece.