PDF-Formularfelder mit Namen, Typen und Werten auflisten

Diese Funktion liest diese Struktur und liefert ein übersichtliches Verzeichnis sämtlicher Felder mit vollständigem Namen, erkanntem Typ und aktuellem Wert. Sie unterstützt die üblichen AcroForm-Steuerelemente in Anträgen, Fragebögen, Genehmigungen und Aufnahmeformularen. Die Verarbeitung erfolgt deterministisch und lokal: Es gibt keine Netzwerkanfragen, Modellschätzungen oder zufälligen Ergebnisse. Ist die Datei kein PDF, beschädigt oder ohne Formularfelder, erhalten Sie einen eindeutigen Eingabefehler statt eines leeren Ergebnisses, das fälschlich als Erfolg gelten könnte.

Untersuchen Sie die tatsächliche PDF-Formularstruktur

Interaktive PDF-Formulare speichern ihre Steuerelemente getrennt von den Wörtern und Linien, die auf den Seiten gezeichnet werden. Ein Feld kann intern customer.address.postcode heißen, obwohl auf der Seite nur „Postleitzahl“ steht. Diese Funktion folgt dem Dokumentkatalog zum AcroForm-Wörterbuch, durchläuft den Feldbaum, übernimmt vererbte Eigenschaften und gibt die Endfelder in Dokumentreihenfolge zurück. Jedes Ergebnis enthält den vollständigen Namen, einen normalisierten Typ und den derzeit im PDF gespeicherten Wert. Textfelder, Kontrollkästchen, Optionsgruppen, Dropdowns, Auswahllisten, Schaltflächen und Signaturfelder werden anhand des im Dokument festgelegten Feldtyps und der Kennzeichen unterschieden. Hierarchische Namen werden mit Punkten verbunden, damit ähnlich benannte Steuerelemente in verschiedenen Abschnitten eindeutig bleiben. Die Ausgabe eignet sich dadurch als maschinenlesbares Schemaverzeichnis und ist nicht bloß eine Extraktion sichtbarer Seitentexte. Ein Kontrollkästchen ohne aktiven Wert erscheint als false; ein nicht unterzeichnetes Signaturfeld wird erkannt, ohne eine vorhandene Signatur vorzutäuschen.

Übermitteln Sie das Dokument und lesen Sie die Antwort

Senden Sie das PDF im Parameter pdf entweder als reinen base64-Text oder als base64-kodierte application/pdf-Daten-URL. Der Parser prüft zunächst Kodierung und PDF-Kopfzeile und liest anschließend die indirekten Objekte, die zum Auffinden des Katalogs und Feldbaums erforderlich sind. Die Antwort enthält fields als Datensatzliste und count als Anzahl der zurückgegebenen Felder. Die Typen tragen praktische Bezeichnungen wie TextField, CheckBox, RadioGroup, Dropdown, OptionList, PushButton und Signature. Aktuelle Werte bleiben als Zeichenketten oder Listen erhalten, wenn sie so im PDF gespeichert sind; der Zustand eines Kontrollkästchens wird als boolescher Wert ausgegeben. Leere Textsteuerelemente erhalten eine leere Zeichenkette und lassen sich so von fehlenden Feldern unterscheiden. Verwechseln Sie die gedruckte Beschriftung neben einem Steuerelement nicht mit dessen internem Namen. Bei fehlenden Feldern wird absichtlich ein Fehler ausgegeben, damit Ihre Automatisierung ein reduziertes PDF, einen Scan oder einen falschen Anhang erkennt. Die zulässige Größe ist für eine berechenbare Verarbeitung begrenzt.

Nutzen Sie das Verzeichnis sicher in Dokumentabläufen

Ein Feldverzeichnis ist ein sinnvoller erster Schritt, bevor Sie PDF-Formulare ausfüllen, prüfen, migrieren oder auditieren. Ein Aufnahmesystem kann beispielsweise die gelieferten Namen mit den Datenbankschlüsseln vergleichen, bevor es eine Vorlage befüllt. Eine Qualitätssicherung kann bestätigen, dass eine überarbeitete Fassung weiterhin alle Pflichtfelder enthält und keine Steuerelementtypen unerwartet geändert wurden. Bei einer Archivmigration lassen sich die eingebetteten Werte jedes interaktiven Dokuments protokollieren, bevor es reduziert wird. Da der Algorithmus keine externen Dienste aufruft und keine Werte aus dem Seitenbild ableitet, erzeugen identische Bytes stets dasselbe JSON. Diese Vorhersagbarkeit ist für Tests und Prüfpfade wichtig. Die Funktion liest jedoch AcroForm-Strukturen und führt keine optische Erkennung durch: Ein gescanntes Papierformular enthält Pixel, aber keine interaktiven Felder, und löst deshalb den entsprechenden Fehler aus. Dokumente werden weder verändert, reduziert, signiert, entschlüsselt noch repariert. Verschlüsselte Dateien und PDFs mit unlesbaren Formularobjekten müssen Sie zuvor mit einem geeigneten Werkzeug vorbereiten.