XXXI. Forms Data Format

Forms Data Format (FDF) est un format de fomulaire pour les documents PDF. Vous pouvez lire la documentation (en anglais) � pour plus de d�tails sur les tenants et les aboutissants.

L'esprit de FDF est similaire � celui des formulaires HTML. Les diff�rences r�sident dans les moyens de transmission des donn�es au serveur, lorsque le bouton "submit" (soumettre) est press� (ce qui est du ressort de Form Data Format) et le format de formulaire lui-m�me (qui est plut�t du ressort de Portable Document Format, PDF). G�rer des donn�es FDF est un des objectifs des fonctions FDF. Mais il y en a d'autres. Vous pouvez aussi prendre un formulaire PDF, et pr�-remplir les champs, sans modifier le formulaire lui-m�me. Dans ce cas, on va cr�er un document FDF (fdf_create()), remplir les champs (fdf_set_value()) et l'associer � un fichier PDF (fdf_set_file()). Finalement, le tout sera envoy� au client, avec le type MIME "application/vnd.fdf". Le module "Acrobat reader" de votre navigateur va reconna�tre ce type MIME, et lire le fichier PDF, puis le remplis avec FDF.

Si vous �ditez un fichier FDF avec un �diteur de texte, vous trouverez un catalogue d'objet avec le nom de FDF. Cet objet peut contenir des entr�es telles que Fields, F, Status etc.. Les entr�es les plus couramment utilis�es sont Fields, qui indique une liste de champs de contr�le, et F qui contient le nom du fichier PDF a qui appartiennent ces donn�es. Ces entr�es sont d�sign�es dans la documentation PDF sous le nom de /F-Key ou /Status-Key. La modification de ces entr�es est possible avec les fonctions fdf_set_file() et fdf_set_status(). Les champs sont modifiables avec les fonctions fdf_set_value(), fdf_set_opt() etc..

Les exemples suivants montre comme �valuer les donn�es du formulaire.

<?php
// Sauver le fichier FDF dans un fichier temporaire.
$fdffp = fopen("test.fdf", "w");
fwrite($fdffp, $HTTP_FDF_DATA, strlen($HTTP_FDF_DATA));
fclose($fdffp);
// Ouvrir le fichier temporaire, et utiliser les donn�es.
// Le formulaire pdf contenait diff�rents fichiers texte, avec pour nom :
// volume, date, comment, publisher, preparer, ainsi que deux bo�tes
// � cocher show_publisher et show_preparer.
$fdf = fdf_open("test.fdf");
$volume = fdf_get_value($fdf, "volume");
echo "La valeur du champs volume �tait : '<B>$volume</B>'<br>";
$date = fdf_get_value($fdf, "date");
echo "La valeur du champs date �tait '<B>$date</B>'<br>";
$comment = fdf_get_value($fdf, "comment");
echo "La valeur du champs comment �tait '<B>$comment</B>'<br>";
if(fdf_get_value($fdf, "show_publisher") == "On") {
  $publisher = fdf_get_value($fdf, "publisher");
  echo "La valeur du champs publisher �tait : '<B>$publisher</B>'<br>";
} else
  echo "La valeur du champs ne doit pas �tre affich�e.<br>";
if(fdf_get_value($fdf, "show_preparer") == "On") {
  $preparer = fdf_get_value($fdf, "preparer");
  echo "La valeur du champs preparer �tait  '<B>$preparer</B>'<br>";
} else
  echo "La valeur du champs Preparer ne doit pas �tre affich�.<br>";
fdf_close($fdf);
?>