Liste campos de formulário PDF: nomes, tipos e valores

Esta capacidade lê essa estrutura e devolve um inventário claro de todos os campos, incluindo nome completo, tipo reconhecido e valor atual. Ela aceita os controles AcroForm comuns em inscrições, questionários, aprovações e documentos de cadastro. O processamento é determinístico e local: não há solicitações de rede, suposições de modelos nem resultados aleatórios. Se o arquivo não for um PDF, estiver danificado ou não contiver campos, a solicitação retornará um erro de entrada claro, em vez de uma resposta vazia que poderia parecer bem-sucedida.

Examine a estrutura real por trás do formulário PDF

Formulários PDF interativos armazenam seus controles separadamente das palavras e linhas desenhadas em cada página. Um campo pode ter um nome interno como customer.address.postcode, mesmo que a página mostre apenas o rótulo “CEP”. Esta capacidade segue o catálogo do documento até o dicionário AcroForm, percorre a árvore de campos, aplica propriedades herdadas e devolve os campos terminais na ordem do documento. Cada resultado contém o nome completo, um tipo normalizado e o valor atualmente armazenado no PDF. Caixas de texto, caixas de seleção, grupos de opções, menus suspensos, listas de opções, botões e campos de assinatura são diferenciados pelo tipo e pelos sinalizadores definidos no documento. Nomes hierárquicos são unidos por pontos para que controles parecidos em seções diferentes continuem inequívocos. Assim, a saída funciona como um inventário de esquema legível por máquina, e não como uma simples extração do texto visível. Uma caixa sem valor ativo aparece como false, e uma assinatura pendente é indicada sem sugerir que ela existe.

Envie o documento e interprete a resposta

Envie o PDF no parâmetro pdf como base64 simples ou como uma URL de dados application/pdf em base64. Primeiro, o analisador valida a codificação e o cabeçalho PDF; em seguida, lê os objetos indiretos necessários para localizar o catálogo e a árvore de campos. A resposta contém fields, uma matriz de registros, e count, a quantidade de campos retornados. Os tipos usam nomes práticos como TextField, CheckBox, RadioGroup, Dropdown, OptionList, PushButton e Signature. Os valores atuais preservam strings e matrizes quando o PDF os armazena dessa forma, enquanto o estado da caixa de seleção retorna como booleano. Controles de texto vazios usam uma string vazia, facilitando diferenciá-los de campos ausentes. Não confunda o rótulo impresso ao lado do controle com o nome do campo; somente a definição interna determina o nome retornado. A capacidade gera um erro de propósito quando nenhum campo existe. Isso ajuda sua automação a detectar um PDF achatado, um formulário digitalizado ou o anexo errado. O tamanho aceito é limitado para manter uma análise previsível.

Use o inventário com segurança em fluxos documentais

Um inventário de campos é um bom primeiro passo antes de preencher, validar, migrar ou auditar formulários PDF. Por exemplo, um sistema de integração pode comparar os nomes retornados com as chaves do banco de dados antes de tentar preencher um modelo. Uma rotina de qualidade pode confirmar que uma versão revisada ainda oferece os campos obrigatórios e que os tipos de controle não mudaram. Uma migração de arquivo pode registrar os valores incorporados em cada documento interativo antes de achatá-lo para preservação. Como o algoritmo não chama serviços externos nem deduz valores pela aparência da página, solicitações com bytes idênticos produzem o mesmo JSON. Essa previsibilidade é importante para testes e trilhas de auditoria. Porém, este é um leitor de estruturas AcroForm, não um reconhecimento óptico: a digitalização de um formulário em papel tem pixels, mas não campos interativos, e portanto gera o erro de ausência de campos. A ferramenta também não modifica, achata, assina, descriptografa nem repara documentos. Prepare antes os arquivos criptografados ou aqueles cujos objetos de formulário não possam ser lidos.