Tips & Tricks

Como adicionar um botão Enviar a um formulário PDF que envia os dados por e-mail

Um botão de envio é a peça final de um fluxo de trabalho funcional Formulários PDF. Depois que um usuário preenche os campos de texto, seleciona as opções suspensas e marca as caixas apropriadas, o botão enviar empacota todos os dados do formulário e os envia para um destino onde alguém pode agir de acordo. Sem um botão de envio, o usuário deve salvar o PDF preenchido e enviá-lo manualmente por e-mail como anexo. Com um botão de envio devidamente configurado, os dados do formulário chegam como texto estruturado em uma caixa de entrada ou banco de dados, prontos para processamento sem nenhuma etapa manual do usuário.

Adicionar um botão de envio envolve duas tarefas distintas: colocar o controle do botão na página PDF e configurar sua ação para enviar dados ao destino correto. A configuração da ação determina para onde os dados vão, qual formato eles usam e se o usuário verá uma mensagem de confirmação após o envio. Acertar a ação é o que separa um botão que fica ali, parecendo clicável, de um botão que fornece respostas de formulário de maneira confiável.

O editor PDF preenchível de WukongPDF inclui controles de botão de envio que você pode configurar com um endereço mailto ou um endpoint de servidor. Depois de configurar o botão, teste todo o fluxo de trabalho de envio antes de enviar o formulário aos destinatários para confirmar se os dados chegam intactos.

How to Add a Submit Button to a PDF Form That Emails the Data

Como funcionam os botões de envio de PDF

Na maioria dos casos, um botão de envio de PDF é um campo de formulário do tipo botão com uma ação Enviar formulário associada. Quando o usuário clica no botão, o leitor de PDF coleta os valores atuais de todos os campos do formulário, serializa-os no formato de dados escolhido e os envia para o destino especificado. O destino pode ser um endereço de email usando o protocolo mailto:, que abre o cliente de email do usuário com os dados do formulário no corpo da mensagem ou como anexo. Ou pode ser uma URL de servidor web usando HTTP ou HTTPS, que envia os dados como uma solicitação POST que um script do lado do servidor recebe e processa.

As opções de formato de dados incluem FDF, o formato de dados de formulários usado pelos produtos Adobe desde a década de 1990. XFDF, a versão baseada em XML do FDF que é mais fácil de ser analisada por sistemas que não sejam da Adobe. HTML, que formata os dados do campo como pares de valores-chave em um corpo de documento HTML. E PDF, que envia todo o arquivo PDF preenchido como anexo. A escolha do formato depende de qual sistema recebe os dados. Os destinatários de e-mail geralmente preferem PDF ou HTML. Os scripts de servidor que processam envios de formulários em bancos de dados preferem XFDF ou FDF para análise estruturada.

WukongPDF

Experimente Editar PDF

Nenhuma instalação necessária. Funciona diretamente no seu navegador.

Começar agora →

Método 1: Configurando um mailto: Botão Enviar

Na prática, a abordagem mailto é a mais simples de configurar porque não requer infraestrutura de servidor. O botão enviar abre o aplicativo de e-mail padrão do usuário, cria uma nova mensagem endereçada ao destinatário especificado e preenche o corpo da mensagem ou anexa o PDF preenchido. No Adobe Acrobat Pro, abra o PDF, vá em Ferramentas e em Preparar Formulário. Clique no ícone Botão na barra de ferramentas e desenhe um botão na página. Digite um rótulo como Enviar ou Enviar formulário.

Com o botão selecionado, abra a caixa de diálogo Propriedades. Na guia Geral, dê ao botão um nome como SubmitButton. Na guia Opções, defina o Layout como Apenas rótulo e insira o texto do botão. Na guia Ações, selecione Mouse Up no menu suspenso do gatilho e clique em Adicionar. Escolha Enviar um formulário na lista de tipos de ação. Na caixa de diálogo Enviar seleções de formulário, insira mailto:you@example.com como o URL. Escolha PDF como formato de exportação para que o destinatário receba o PDF completo e preenchido. Clique em OK, feche as propriedades e salve o PDF.

Teste o botão de envio abrindo o PDF no Adobe Acrobat Reader, preenchendo alguns campos e clicando em Enviar. O Leitor deverá abrir seu aplicativo de e-mail padrão com uma nova mensagem endereçada a você e o PDF preenchido anexado. Se o cliente de e-mail não abrir, verifique se o seu sistema operacional possui um aplicativo de e-mail padrão configurado. Os links mailto dependem do manipulador de correio do sistema e, em algumas máquinas, especialmente em ambientes corporativos com email baseado na Web, o manipulador mailto pode não estar configurado.

Método 2: Envio de dados de formulário para um servidor Web

Para formulários distribuídos ao público ou para grandes equipes onde o envio por e-mail se torna complicado, o envio HTTP POST para um script de servidor fornece um pipeline de coleta de dados mais escalável. A configuração requer um endpoint de servidor que possa aceitar e processar dados de formulário PDF recebidos. O URL do terminal vai para o campo URL da ação Enviar formulário em vez de um endereço mailto. Quando o usuário clica em enviar, o leitor de PDF envia uma solicitação HTTP POST com os dados do formulário no corpo. O script do servidor analisa os dados, armazena-os e retorna uma resposta que o leitor de PDF pode exibir como página de confirmação.

Configurar o endpoint do servidor é a parte mais complexa deste fluxo de trabalho porque envolve desenvolvimento web fora do PDF. Um script PHP, Python ou Node.js básico que aceita solicitações POST, analisa dados FDF ou XFDF e grava os valores dos campos em um arquivo CSV ou banco de dados normalmente tem de 30 a 50 linhas de código. O lado PDF da configuração é idêntico à configuração mailto, exceto que o URL aponta para o terminal do servidor em vez de um endereço mailto. Muitos serviços de gerenciamento de formulários oferecem endpoints pré-construídos que aceitam envios de formulários PDF, eliminando a necessidade de escrever e hospedar código de servidor personalizado.

Personalizando a aparência e o comportamento do botão Enviar

A aparência padrão do botão, um retângulo cinza com texto centralizado, funciona, mas não corresponde à maioria dos designs de formulário. Na caixa de diálogo Propriedades do botão, na guia Aparência, defina a cor da borda, a cor de preenchimento, a fonte e o tamanho da fonte para corresponder ao estilo visual do formulário. Um botão de envio com preenchimento azul, texto branco e cantos arredondados chama mais atenção e obtém mais cliques do que um retângulo cinza padrão. Na guia Opções, você pode atribuir um ícone ao botão que aparece ao lado ou em vez do texto do rótulo.

Na maioria das ferramentas, a guia Ações do botão suporta múltiplas ações em diferentes gatilhos. Além da ação de envio Mouse Up, você pode adicionar uma ação Mouse Enter que altera a cor do botão para indicar o foco e uma ação Mouse Exit que restaura a cor original. Essas dicas de feedback visual tornam o formulário mais responsivo e profissional. Mantenha os efeitos interativos sutis. Um botão que muda para um tom ligeiramente mais escuro ao passar o mouse é útil. Um botão que é animado ou muda drasticamente distrai.

Considerações sobre segurança e privacidade

Os dados do formulário enviados por meio de um link mailto passam pelo cliente de email do usuário e pela infraestrutura de email do remetente e do destinatário. Os dados não são criptografados em trânsito, a menos que ambos os servidores de e-mail imponham TLS. Para formulários que coletam informações confidenciais, como números de identificação pessoal, dados de saúde ou detalhes financeiros, o envio por correio não oferece segurança adequada. HTTP POST para um endpoint de servidor usando HTTPS criptografa os dados em trânsito entre o leitor de PDF e o servidor, que é o nível de segurança mínimo aceitável para qualquer formulário que colete dados pessoais.

Ao criar documentos, o leitor de PDF usado pelo destinatário também afeta o comportamento de envio. O Adobe Acrobat Reader suporta toda a gama de ações de envio, incluindo mailto e HTTP POST. Os visualizadores de PDF baseados em navegador incorporados no Chrome, Edge e Firefox têm suporte limitado ou nenhum suporte para ações de envio de formulários PDF. Um botão de envio que funciona perfeitamente no Acrobat Reader pode não fazer nada quando o mesmo PDF é aberto em uma guia do navegador. Para formulários distribuídos a destinatários externos cujo leitor de PDF você não pode controlar, inclua uma nota perto do botão de envio instruindo os usuários a abrir o arquivo no Adobe Acrobat Reader se o botão não funcionar no navegador.

Método de envioComo funcionaMelhor para
mailto: ação de URLAbre o cliente de e-mail padrão do usuário com assunto e corpo pré-preenchidos contendo dados do formulárioFormulários internos, equipes pequenas, dados simples
HTTP POST para script do servidorEnvia dados de formulário como FDF ou XFDF para um endpoint de servidor web para processamentoFormulários públicos, integração de CRM, automação
Serviço de API JavaScript + e-mailO botão JS personalizado chama uma API de e-mail de terceiros diretamente do leitor de PDFFormulários onde a confiabilidade do mailto é insuficiente

Um botão de envio configurado corretamente transforma um PDF preenchível de um formulário independente em um terminal de coleta de dados. O método mailto lida com formulários de equipe internos sem configuração de servidor. O método HTTP POST é dimensionado para distribuição pública e processamento automatizado de dados. Testar o fluxo de trabalho de envio de ponta a ponta antes que a distribuição detecte erros de configuração que, de outra forma, perderiam silenciosamente todas as respostas de formulário enviadas por seus usuários. Um botão de envio que funciona de maneira confiável remove o último ponto de atrito entre o preenchedor do formulário e o proprietário do formulário, fechando o ciclo em todo o fluxo de trabalho do PDF preenchível.

Solução de problemas de falhas no botão Enviar

Quando um botão de envio não faz nada ao clicar, a causa mais comum é que o leitor de PDF não suporta o tipo de ação. Os visualizadores de PDF baseados em navegador geralmente não suportam ações de envio mailto ou HTTP POST. A correção é instruir os usuários a abrir o arquivo especificamente no Adobe Acrobat Reader. Outra causa comum é o URL mailto estar malformado. O formato correto é mailto:address@example.com sem espaços ou parâmetros adicionais, a menos que sejam codificados em URL corretamente.

Se o botão funcionar, mas o e-mail chegar sem dados, a causa provável é que o formato de exportação foi definido como FDF ou XFDF e o cliente de e-mail do destinatário não sabe como exibir esses formatos. Altere o formato de exportação para PDF nas configurações da ação Enviar formulário. O PDF preenchido chega como anexo de e-mail e o destinatário pode abri-lo diretamente para ver todos os dados inseridos. Para formulários em que o destinatário precisa ver os dados rapidamente no corpo do e-mail, escolha HTML como formato de exportação. Os valores dos campos aparecem como texto rotulado no corpo da mensagem de e-mail, embora a formatação seja simples e não preserve o layout visual do formulário original.

WukongPDF

Experimente Editar PDF

Nenhuma instalação necessária. Funciona diretamente no seu navegador.

Começar agora →