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 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.

Anforderungen

Ben�tigt wird das FDF-Toolkit-SDK, welches unter heruntergeladen werden kann. Ab PHP-Version 4.3 ist mindestens die Version 5.0 des FDF-SDKs erforderlich. Die FDF-Toolkit Bibliothek steht ausschlie�lich vorkompiliert zur Verf�gung. Von Adobe unterst�tze Plattformen sind Win32, Linux, Solaris und AIX.

Installation

You must compile PHP with --with-fdftk[=DIR].

Laufzeit Konfiguration

Diese Erweiterung definiert keine Konfigurationseinstellungen in der php.ini.

Resource Typen

Vordefinierte Konstanten

Folgende Konstanten werden von dieser Erweiterung definiert und stehen nur zur Verf�gung, wenn die Erweiterung entweder statisch in PHP kompiliert oder dynamisch zur Laufzeit geladen wurde.

Beispiele

Das Beispiel zeigt die Auswertung der Formular Daten.

<?php
// Speichern der FDF Daten in eine tempor�re Datei
$fdffp = fopen("test.fdf", "w");
fwrite($fdffp, $HTTP_FDF_DATA, strlen($HTTP_FDF_DATA));
fclose($fdffp);

// �ffnen der tempor�ren Datei und Auswertung der Daten
// Das PDF Formular enth�lt verschiedene Eingabefelder mit den zugeh�rigen Namen
// band, datum, kommentar, verleger, bearbeiter, sowie zwei Checkboxen
// zeige_verleger und zeige_bearbeiter.

$fdf = fdf_open("test.fdf");
$band = fdf_get_value($fdf, "band");
echo "Das Feld Band hat den Wert '<B>$band</B>'<BR>";

$datum = fdf_get_value($fdf, "datum");
echo "Das Feld Datum hat den Wert '<B>$datum</B>'<BR>";

$kommentar = fdf_get_value($fdf, "kommentar");
echo "Das Feld Kommentar hat den Wert '<B>$kommentar</B>'<BR>";

if (fdf_get_value($fdf, "zeige_verleger") == "On") {
    $verleger = fdf_get_value($fdf, "verleger");
    echo "Das Feld Verleger hat den Wert '<B>$verleger</B>'<BR>";
} else {
  echo "Verleger soll nicht angezeigt werden.<BR>";
}

if (fdf_get_value($fdf, "zeige_bearbeiter") == "On") {
  $bearbeiter = fdf_get_value($fdf, "bearbeiter");
  echo "Das Feld Bearbeiter hat den Wert '&<B>$bearbeiter</B>'<BR>";
} else {
  echo "Bearbeiter soll nicht angezeigt werden.<BR>";
}
fdf_close($fdf);
?>