Um PDF tradicional é um instantâneo. Os dados exibidos estão congelados no momento em que o PDF foi gerado. Um painel PDF interativo com dados em tempo real atualiza seu conteúdo cada vez que o documento é aberto, extraindo números atuais de um serviço web, banco de dados ou fonte de dados vinculada. O leitor vê os dados atuais, não a exportação da semana passada. Esse recurso transforma um PDF de um relatório estático em uma ferramenta de relatório ao vivo.
A incorporação de feeds de dados ao vivo em um PDF requer uma de três abordagens: regenerar o PDF de acordo com uma programação com dados atualizados, incorporar JavaScript que chama um serviço da Web quando o PDF é aberto ou vincular elementos do PDF a fontes de dados externas que o leitor de PDF atualiza automaticamente. Cada abordagem possui diferentes requisitos de infraestrutura e diferentes níveis de suporte ao leitor de PDF.
As ferramentas Web para PDF da WukongPDF convertem visualizações de dados em tempo real em PDFs sob demanda. Para painéis que devem sempre mostrar dados atuais, a abordagem de regeneração programada é a mais confiável entre todos os leitores de PDF.
Abordagem 1: Regeneração agendada de PDF com dados atuais
A maneira mais confiável de garantir que um painel PDF sempre mostre os dados atuais é regenerá-lo de acordo com uma programação. Um script extrai dados do banco de dados de origem ou da API, preenche um modelo de relatório e exporta um novo PDF. O PDF gerado contém os dados atuais como conteúdo estático. O leitor não precisa suportar JavaScript ou conexões de dados externas. O PDF tem a mesma aparência em todos os leitores porque os dados são inseridos no arquivo no momento da geração.
Ferramentas como Python com as bibliotecas matplotlib e reportlab podem gerar painéis PDF orientados por dados de forma programática. Um cron job em um servidor executa o script a cada hora ou todos os dias, extraindo dados novos e sobrescrevendo o PDF anterior. O URL do PDF permanece o mesmo, mas seu conteúdo é atualizado sempre que o script é executado. Essa abordagem funciona com qualquer leitor de PDF e qualquer fonte de dados que possa ser consultada programaticamente. A limitação é que os dados são tão atuais quanto o último ciclo de regeneração. Para painéis onde as atualizações horárias ou diárias são suficientes, a regeneração programada oferece a melhor compatibilidade.
Experimente Editar PDF
Nenhuma instalação necessária. Funciona diretamente no seu navegador.
Abordagem 2: chamadas da API JavaScript no documento aberto
Os arquivos PDF podem conter JavaScript que é executado quando o documento é aberto. O script pode chamar um serviço web externo, receber dados JSON em resposta e preencher campos de formulário ou atualizar elementos de texto com os valores retornados. Quando o leitor abre o PDF e clica em um aviso de segurança para permitir a conexão de rede, o painel é preenchido com dados ativos do serviço web.
Essa abordagem requer um endpoint de servidor que retorne os dados do painel no formato JSON. O PDF contém JavaScript que chama esse endpoint usando o método Net.HTTP.request na API JavaScript do Acrobat. O script é executado no evento DocOpen, busca dados e atualiza os valores dos campos. A abordagem funciona no Adobe Acrobat Reader com JavaScript habilitado. Ele não funciona em visualizadores de PDF baseados em navegador, na maioria dos leitores de PDF móveis ou no Acrobat Reader com JavaScript desativado. O suporte limitado ao leitor torna essa abordagem adequada para painéis internos distribuídos aos usuários em leitores conhecidos e compatíveis com JavaScript.
Abordagem 3: dados Excel vinculados com atualização automática
O Microsoft Excel pode exportar gráficos e tabelas para PDF com conexões de dados vinculadas. Quando o arquivo Excel está conectado a uma fonte de dados externa, como um banco de dados SQL, uma API Web ou um feed de dados do Power Query, os gráficos e tabelas dinâmicas na pasta de trabalho do Excel são atualizados quando a conexão de dados é atualizada. Exportar a pasta de trabalho atualizada para PDF incorpora os dados mais recentes.
Na prática, a ligação entre o PDF e os dados em tempo real é indireta. O arquivo Excel se conecta à fonte de dados, é atualizado de acordo com um agendamento ou aberto, e uma macro ou tarefa agendada exporta o PDF atualizado. O próprio PDF contém dados estáticos da atualização mais recente do Excel. Essa abordagem usa a conectividade de dados incorporada ao Excel sem exigir JavaScript no PDF.
| Fonte de dados | Método de atualização | Complexidade |
|---|---|---|
| Script do lado do servidor + regeneração de PDF | Gere novamente o PDF inteiro dentro do cronograma com dados atualizados | Médio, requer script e agendamento |
| JavaScript + chamada de serviço web incorporado | Formulário PDF chama API ao abrir, preenche campos com resposta | Médio, requer endpoint do servidor e conhecimento de JS |
| Planilha vinculada com atualização automática | Gráficos PDF vinculados a fontes de dados externas, atualizados quando abertos | Baixo, compatível com fluxos de trabalho de Excel para PDF |
Escolhendo a abordagem certa para seu público
A abordagem de regeneração programada funciona para qualquer público porque produz um PDF estático padrão que qualquer leitor pode abrir. A abordagem JavaScript fornece dados reais em tempo real no momento da abertura, mas apenas para leitores que usam o Acrobat Reader com JavaScript habilitado. A abordagem vinculada ao Excel fornece dados semi-vivos com o Excel como ponte entre a fonte de dados e a saída do PDF.
Para distribuição externa para um público com configurações desconhecidas de leitores de PDF, a regeneração programada é a escolha segura. Para painéis internos visualizados por colegas em dispositivos gerenciados, abordagens vinculadas a JavaScript ou Excel podem fornecer atualizações de dados mais frequentes. A decisão equilibra a atualização dos dados com a compatibilidade do leitor. Um painel que mostra os dados da última hora para cada destinatário costuma ser mais útil do que aquele que mostra dados em tempo real para um subconjunto de destinatários que possuem o leitor de PDF correto.
Os dados ativos em um painel PDF confundem a linha entre um documento estático e uma interface de relatório dinâmica. O formato PDF, originalmente projetado para troca de conteúdo estático, pode servir como um contêiner de painel leve quando combinado com o mecanismo correto de entrega de dados. A abordagem de regeneração programada é o caminho mais prático para criar painéis PDF ativos para o público mais amplo.
Protegendo conexões de dados em tempo real em painéis PDF
Na maioria dos casos, um PDF que faz solicitações de rede para buscar dados em tempo real apresenta uma consideração de segurança que os PDFs estáticos não apresentam. A solicitação de rede pode expor potencialmente o endereço IP do leitor ao servidor de dados, e a resposta do servidor pode conter conteúdo malicioso se o servidor estiver comprometido. Para painéis internos, certifique-se de que o endpoint de dados use HTTPS e exija autenticação. O JavaScript do PDF deve validar o certificado SSL do servidor antes de enviar ou receber dados.
Para painéis distribuídos externamente, a regeneração agendada de PDF é a abordagem mais segura porque os dados são incorporados ao arquivo no momento da geração em um servidor controlado e o leitor de PDF do destinatário não faz solicitações de rede. O modelo de segurança de um PDF estático é mais simples e fácil de auditar do que um PDF habilitado para JavaScript fazendo chamadas de API ao vivo. Reserve a abordagem de API ao vivo para painéis internos onde o endpoint do servidor, a configuração do leitor de PDF e o caminho de rede entre eles estão todos sob o controle da organização.
Incorporando gráficos de serviços de dados em tempo real como imagens
Em vez de criar um painel completo, considere incorporar gráficos individuais gerados por um serviço de dados em tempo real. Serviços como Google Charts e QuickChart renderizam gráficos como imagens de URLs com parâmetros de consulta especificando valores de dados. O PDF exibe uma imagem carregada de uma URL que retorna um gráfico com os dados atuais no momento da solicitação.
Essa abordagem tem compatibilidade de leitor mais ampla do que a busca de dados JavaScript porque os leitores de PDF que suportam imagens vinculadas podem exibir o gráfico sem executar JavaScript. O serviço gráfico lida com a recuperação e visualização de dados. O PDF simplesmente exibe a imagem resultante. Para painéis distribuídos a leitores com configurações desconhecidas de visualizador de PDF, imagens de gráficos vinculadas fornecem visualização ao vivo com ampla compatibilidade.
Os dados dinâmicos em painéis PDF ampliam a utilidade do formato PDF além da troca estática de documentos. A abordagem de regeneração programada fornece o melhor equilíbrio entre atualização de dados e compatibilidade do leitor. As abordagens JavaScript e de imagem vinculada oferecem maior oportunidade para ambientes controlados onde o software leitor é conhecido. A escolha da estratégia de atualização de dados certa para o público garante que o painel agregue seu valor sem surpresas de compatibilidade.
Um painel PDF com dados em tempo real ocupa um meio termo entre um relatório estático e um aplicativo web completo. Ele fornece dados atuais em um formato que todas as partes interessadas podem abrir sem aprender uma nova ferramenta. A abordagem de regeneração programada proporciona a mais ampla compatibilidade com o menor número de dependências técnicas.
Os dados em tempo real em um painel PDF estendem o formato além da troca estática de documentos para relatórios leves. A abordagem de regeneração programada oferece a melhor compatibilidade entre leitores de PDF. As abordagens JavaScript e de imagem vinculada oferecem maior oportunidade para ambientes controlados. Combinar a estratégia de atualização com o público garante que o painel agregue valor sem lacunas de compatibilidade.
Experimente Editar PDF
Nenhuma instalação necessária. Funciona diretamente no seu navegador.