# Forms Data Format Funktionen

# Einführung

Forms Data Format (FDF) ist ein Format zur Verarbeitung von Formularen innerhalb von PDF-Dokumenten. Weiterführende Informationen zu FDF und dessen Verwendung sind unter » http://www.adobe.com/devnet/acrobat/fdftoolkit.html zu finden.

Der Ansatz den FDF verfolgt, ist vergleichbar mit dem üblicher HTML-Formulare. Die wesentlichen Unterschiede liegen in der Übertragung der Daten nach Absenden des Formulars (dies ist das eigentliche Form Data Format), sowie in dem Format des Dokuments welches das Formular enthält(PDF). Die Verarbeitung der FDF-Daten ist eine der Möglichkeiten, die die FDF-Funktionen bereitstellen. Darüber hinaus kann man beispielsweise innerhalb eines vorhandenen PDF-Formulars die Input-Felder dynamisch mit Daten füllen, ohne das Formular selbst zu verändern. Hierzu erzeugt man das FDF-Dokument (fdf_create()), setzt die Werte der jeweiligen Input-Felder (fdf_set_value()) und verbindet es mit dem jeweiligen PDF-Formular (fdf_set_file()). Nachdem man das FDF-Dokument, mit dem passenden MimeType `application/vnd.fdf` versehen, ausgegeben hat, erkennt das Acrobat-Reader-PlugIn des Browsers den MimeType und füllt das Zielformular mit den Daten des FDF-Dokuments.

Betrachtet man ein FDF-Dokument mit einem Text-Editor, findet sich dort ein Katalog-Objekt `FDF`. Dieses Objekt kann mehrere Einträge der Art `Fields`, `F`, `Status` etc.. enthalten. Die gebräuchlichsten Einträge sind `Fields`, welches zu einer Anzahl von Input-Feldern verweist, sowie `F` das den Dateinamen des zugehörigen PDF-Dokuments enthält. Diese Einträge finden sich in der FDF-Dokumentation unter /F-Key oder /Status-Key. Modifikationen dieser Einträge werden mit Hilfe der Funktionen fdf_set_file() und fdf_set_status() vorgenommen. Felder werden u.a. mit fdf_set_value(), fdf_set_opt() modifiziert.

- Installation/Konfiguration
  - Anforderungen
  - Installation
  - Ressource-Typen
- Vordefinierte Konstanten
- Beispiele
- FDF — FDF Funktionen
  - fdf_add_doc_javascript — Fügt JavaScript-Code in ein FDF-Dokument ein
  - fdf_add_template — Fügt dem FDF Dokument ein Template hinzu
  - fdf_close — Schließt ein FDF Dokument
  - fdf_create — Erzeugt ein neues FDF Dokument
  - fdf_enum_values — Ruft für jeden Dokumentwert eine benutzerdefinierte Funktion auf
  - fdf_errno — Gibt den Fehlercode der letzten FDF Operation zurück
  - fdf_error — Gibt die Beschrebung eines Fehlercodes zurück
  - fdf_get_ap — Get the appearance of a field
  - fdf_get_attachment — Extracts uploaded file embedded in the FDF
  - fdf_get_encoding — Liefert den Wert des /Encoding Schlüssels
  - fdf_get_file — Gibt den Wert des /F Schlüssels zurück
  - fdf_get_flags — Ermittelt die Flags eines Feldes
  - fdf_get_opt — Liefert einen Wert aus dem Optionsarray eines Feldes
  - fdf_get_status — Gibt den Wert des /STATUS Schlüssels zurück
  - fdf_get_value — Gibt den Wert eines Feldes zurück
  - fdf_get_version — Liefert die Versionsnummer einer FDF-Datei oder des APIs
  - fdf_header — Setzt FDF-spezifische Header
  - fdf_next_field_name — Gibt den Namen des nächsten Feldes zurück
  - fdf_open — Öffnet ein FDF Dokument
  - fdf_open_string — Read a FDF document from a string
  - fdf_remove_item — Setzt den Zielrahmen für ein Formular
  - fdf_save — Speichern eines FDF Dokuments
  - fdf_save_string — Returns the FDF document as a string
  - fdf_set_ap — Legt das Aussehen eines Feldes fest
  - fdf_set_encoding — Legt die FDF Zeichenkodierung fest
  - fdf_set_file — Definiert ein PDF-Dokument, das FDF-Daten anzeigen soll
  - fdf_set_flags — Setzt Flags eines Feldes
  - fdf_set_javascript_action — Weist einem Feld eine JavaScript Aktion zu
  - fdf_set_on_import_javascript — Adds javascript code to be executed when Acrobat opens the FDF
  - fdf_set_opt — Legt eine Option eines Feldes fest
  - fdf_set_status — Setzt den Wert des /STATUS Schlüssels
  - fdf_set_submit_form_action — Setzt eine Submit-Form-Aktion für ein Feld
  - fdf_set_target_frame — Set target frame for form display
  - fdf_set_value — Legt den Wert eines Feldes fest
  - fdf_set_version — Sets version number for a FDF file

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open